Table of Contents
maxLevel 1

Предназначение

Утилита PinChanger rtAdmin предназначена для автоматизации процедур форматирования и администрирования Рутокен: смены метки токена, PIN-кодов и их параметров.

Поддерживаемые модели

• Рутокен S (только на Windows-платформах и только с использованием библиотеки Windows)
• Рутокен Lite
• Рутокен Lite SC
• Рутокен ЭЦП
• Рутокен ЭЦП 2.0
• Рутокен ЭЦП SC
• Рутокен ЭЦП Flash
• Рутокен PINPad

С Рутокен S необходимо использовать библиотеку rtPKCS11.dll (

используется по умолчанию)

. С другими устройствами необходимо использовать rtPKCS11ECP.dll (задается параметром -z )

Поддерживаемые платформы

• MS Windows 10/8.1/8/2012/7/2008/Vista/2003/XP/2000
• GNU/Linux
• Mac OS X

Параметры

Утилита запускается из командной строки и имеет следующие параметры:

При необходимости параметры командной строки могут быть переданы с помощью конфигурационного файла.

В случае отсутствия заданных PIN-кодов при форматировании устанавливаются PIN-коды по умолчанию.

Утилита является циклической и после выполнения заданных действий на подключенном токене ожидает подключения следующего.

Форматирование

Утилита предоставляет пользователю возможность поточного форматирования токенов:

1. Пользователь запускает утилиту, установив предварительно необходимые настройки в конфигурационном файле или задав опции в командной строке.

2. Утилита форматирует обнаруженные токены, заносит результаты в лог-файл, ждет подключения следующего токена или команды прекращения работы (например по нажатию на клавишу Enter).

3. Результаты форматирования пишутся в лог.

Пользователь может запустить форматирование токенов с автоматической генерацией PIN-кода заданной длины, для этого он устанавливает соответствующую опцию в конфигурационном файле.

Пользователь может задать дефолтные значения PIN-кодов, тогда все токены будут иметь одинаковые PIN-коды.

Пользователь может задавать PIN-коды или генерировать их автоматически в кодировке UTF-8, установив соответствующую опцию в конфигурационном файле.

Пользователь может использовать заранее сгенерированные сторонними утилитами PIN-коды. Для этого в настройках он указывает файл, в котором хранится список сгенерированных PIN-кодов с символом перевода строки в качестве разделителя.

Смена PIN-кода

Пользователь может изменить PIN-код пользователя или администратора без форматирования токена, если ему известны текущие PIN-коды пользователя и администратора.

Пользователь задает текущий PIN-код администратора и пользователя в конфигурационном файле или командной строке, задает новые PIN-коды, параметры смены PIN-кода и запускает утилиту.

Утилита выполняет авторизацию, используя PIN-код Пользователя или Администратора в зависимости от того, какой PIN-код необходимо изменить и политики смены PIN-кода.

Результаты смены PIN-кодов пишутся в лог.

Если авторизоваться не удается, в лог-файл пишется ошибка. Поточная смена PIN-кодов не прерывается.

Пользователь может запустить смену PIN-кодов с автоматической генерацией новых PIN-кодов заданной длины, для этого он устанавливает соответствующую опцию в конфигурационном файле.

Пользователь может задать дефолтные значения PIN-кодов, тогда все токены будут иметь одинаковые PIN-коды.

Пользователь может задавать PIN-коды или генерировать их автоматически в кодировке UTF-8, установив соответствующую опцию в конфигурационном файле.

Пользователь может использовать заранее сгенерированные сторонними утилитами PIN-коды. Для этого в настройках он указывает файл, в котором хранится список сгенерированных PIN-кодов с символом перевода строки в качестве разделителя.

Протоколирование работы в лог-файл

Лог представляет собой файл со строками следующего содержания:

1. В случае форматирования

2. В случае смены PIN-кода

3. В случае форматирования Flash-памяти

4. В случае изменения атрибутов разделов Flash-памяти

5. В случае получения информации об атрибутах разделов Flash-памяти

 Пользователь может задавать имя лог-файла и его расположение. По умолчанию файл лежит в папке с утилитой и называется Pinchanger.exe.log.

Если при повторном запуске утилиты пользователь не указал новое имя лог-файла, то старый файл дополняется.

Примеры использования

1. Отформатировать один токен с параметрами по умолчанию (для поточного выполнения убрать флаг -q)

   Code Block
   PinChanger.exe -f -q

2. Отформатировать токен, задав имя токена RutokenLabel, PIN-код пользователя 123456789 и PIN-код администратора 987654321.

   Code Block
   PinChanger.exe -f -L RutokenLabel -u 123456789 -a 987654321 -q

3. Отформатировать токен с использование конфигурационного файла, задав имя токена RutokenLabel, PIN-код пользователя 123456789 и PIN-код администратора 987654321.
   Создаем в папке с утилитой конфигурационный файл с именем conf.txt со следующим содержимым:

   Code Block
   title conf.txt
   -f -L RutokenLabel -u 123456789 -a 987654321 -q

   Запускаем утилиту с указанным именем конфигурационного файла в командной строке:

   Code Block
   PinChanger.exe -n conf.txt

4. Отформатировать токен, сменив политику смены PIN-кода только пользователем, максимальное количество попыток ввода PIN-кода пользователя 10 и PIN-код администратора 3.

   Code Block
   PinChanger.exe -f -p 2 -r 10 -R 3 -q

5. Отформатировать токен, задав минимальную длину PIN-кода  пользователя 8  и сам PIN-код 12345678, и PIN-код администратора 9 и сам PIN-код 987654321.

   Code Block
   PinChanger.exe -f -m 8 -u 12345678 -M 9 -a 987654321 -q

6. Разбить память на 1 раздел со следующими атрибутами: владелец - пользователь, права - для чтения и записи, объем раздела - весь (Для Рутокен Flash 4ГБ). PIN-код администратора указан по умолчанию.

   Code Block
   PinChanger.exe -F 1 3783 u rw -q -z rtPKCS11ECP.dll -a 87654321

7. Разбить память на 4 раздела со следующими атрибутами:
   первый: владелец - пользователь, права - для чтения и записи, объем раздела - 945 Мб;
   второй: владелец - пользователь, права - только для чтения, объем раздела - 946 Мб;
   третий: владелец - пользователь, права - cd-rom раздел, объем раздела - 946 Мб;
   четвертый: владелец - администратор, права - скрытый раздел, объем раздела - 946 Мб. PIN-код администратора указан по умолчанию.

   Code Block
   PinChanger.exe -F 1 945 u rw -F 2 946 u ro -F 3 946 u cd -F 4 946 a hi -q -z rtPKCS11ECP.dll -a 87654321

8. Изменить права доступа первого раздела на "только для чтения". Владельцем является пользователь, PIN-код указан по умолчанию.

   Code Block
   PinChanger.exe -C 1 ro p -q -z rtPKCS11ECP.dll -u 12345678