Поддерживаемые модели  токенов Рутокен

• Рутокен S– модель для

• хранения контейнеров ГОСТ-криптопровайдеров: КриптоПро,

• VipNet и других.

• Сертифицирована ФСТЭК. Для работы требуется установить драйвер https://www.rutoken.ru/support/download/get/rtDrivers-x64-deb.html;
  
  
• Рутокен Lite – упрощенная модель для хранения контейнеров ГОСТ-криптопровайдеров: КриптоПро,

• VipNet и других.

• Сертифицирована ФСТЭК. Не имеет встроенного криптопровайдера. Поддерживает стандарт PKCS #15 используя интерфейс CCID и не требует установки дополнительных драйверов (поддерживается без использования дополнительных драйверов начиная с Astra Linux Special Edition x.7 с установленным обновлением БЮЛЛЕТЕНЬ № 2021-1126SE17 (оперативное обновление 1.7.1);
  
  
•  Рутокен ЭЦП 2.0

• – высокопроизводительная модель со встроенным криптопровайдером. Формирует квалифицированную электронную подпись (КЭП) при помощи сертифицированной реализации российских криптографических алгоритмов непосредственно в самом чипе устройстве, что повышает безопасность использования ЭП — ключ подписи никогда не покидает токен, его невозможно использовать

• без

• наличия токена. Работает с алгоритмами ГОСТ 2012.

• Сертифицирована ФСБ и ФСТЭК.

• Используется в системе ЕГАИС с 2016 года

• ;
  
  
• Рутокен ЭЦП PKI и Рутокен ЭЦП 3.0

См. также информацию производителя: https:/dev.rutoken.ru/pages/viewpage.action?pageId=66814078

Проверка

электронной подписи в Astra Linux

С помощью токенов, кроме двухфакторной аутентификации, можно проверять

подписи документов

:

Для Рутокен Lite/S

подпись документа можно проверить с помощью:

1. КриптоАРМ ГОСТ.
2. Утилиту csptestf из состава КриптоПро CSP.

1. Подробнее см. Работа с КриптоПро CSP.

Для Рутокен ЭЦП 2.0

подпись документа можно проверить

с помощью:

1. КриптоАРМ ГОСТ.
2. Тестовый центр регистрации Рутокен

1. +

1. Рутокен Плагин

1. .
2. OpenSSL + Рутокен engine.
3. Утилиту csptestf из состава КриптоПро CSP.

1.  Подробнее см. Работа с КриптоПро CSP.

Токены Рутокен для платформ Байкал и Эльбрус

Токены

Рутокен Lite и Рутокен ЭЦП

работают на всех платформах,

имеющих USB-интерфейс.

Для подписи с использованием Рутокен можно использовать:

1. Тестовый центр регистрации Рутокен

1. +

1. Рутокен Плагин

1. .

1. Утилита из КриптоПро CSP 5.0.

1. КриптоАРМ ГОСТ.
2. Для платформы Байкал М1 под управлением Astra Linux можно использовать предлагаемый разработчиками КриптоПРО пакет cryptoarm-gost-v2.5.12.linux-aarch64.deb (доступен по ссылке: https://github.com/CryptoARM/CryptoARMGOST/releases/tag/v2.5.12).

Рутокен S не поддерживается на платформе Эльбрус.

Установка ПО

Для выполнения действий данной инструкции необходимо установить следующее программное обеспечение:

• Программное обеспечение из репозиториев Astra Linux:
  • пакетlibccid;
  • пакет pcscd;
  • пакет libpcsclite1;
  • пакет pcsc-tools;
  • пакет opensc;
  • пакет libengine-pkcs11-openssl1.1;
• Программное обеспечение, предоставляемое разработчиком оборудования:
  • для работы с Рутокен ЭЦП — пакет librtpkcs11ecp (аналог библиотеки libengine-pkcs11-openssl1.1 входящей в состав Astra Linux);
  • для работы с Рутокен S — пакет ifd-rutokens (драйвер токена, предоставляемый производителем).

Установка пакетов может быть выполнена с помощью Графический менеджер пакетов synaptic или из командной строки командой:

sudo apt install libccid pcscd libpcsclite1 pcsc-tools opensc libengine-pkcs11-openssl1.1

Для установки пакета librtpkcs11ecp загрузить актуальную версию по ссылке: https://www.rutoken.ru/support/download/pkcs/ и выполнить установку из загруженного файла:

sudo apt install ./librtpkcs11ecp_*_amd64.deb

При установке пакета устанавливается библиотека librtpkcs11ecp.so В разных обновлениях эта библиотека может размещаться в различных каталогах. Далее в примерах предполагается, что библиотека расположена в файле /usr/lib/librtpkcs11ecp.so. Для того, чтобы определить реальное расположение библиотеки можно использовать команду:

Для установки пакета ifd-rutokens загрузить актуальную версию по ссылке: https://www.rutoken.ru/support/download/get/rtDrivers-x64-deb.html и выполнить установку из загруженного файла:

sudo apt install ./ifd-rutokens_*_amd64.deb

Проверка работы токенов в системе

Для проверки работы токена необходимо подключить токен к компьютеру.

Инструмент pcsc_scan

Инструмент pscsc_scan входит в пакет pcsc-tools. Для его работы требуется установка пакета pcscd. Команда для вывода информации о подключенном токене:

pcsc_scan

После запуска  pscsc_scan проверяет наличие подключенного токена. Если токен обнаружен - выводит информацию о нем. Программа не завершает работу сама, ожидая подключение следующего токена. Для завершения работы программы нажать Ctrl+C.

Пример вывода команды:

Using reader plug'n play mechanism
Scanning present readers...
0: Aktiv Rutoken lite 00 00
 
Fri Mar 31 13:29:35 2023
 Reader 0: Aktiv Rutoken lite 00 00
  Event number: 0
  Card state: Card inserted, 
  ATR: 3B 8B 01 52 75 74 6F 6B 65 6E 6C 69 74 65 C2

ATR: 3B 8B 01 52 75 74 6F 6B 65 6E 6C 69 74 65 C2
+ TS = 3B --> Direct Convention
+ T0 = 8B, Y(1): 1000, K: 11 (historical bytes)
  TD(1) = 01 --> Y(i+1) = 0000, Protocol T = 1 
-----
+ Historical bytes: 52 75 74 6F 6B 65 6E 6C 69 74 65
  Category indicator byte: 52 (proprietary format)
+ TCK = C2 (correct checksum)

Possibly identified card (using /usr/share/pcsc/smartcard_list.txt):
3B 8B 01 52 75 74 6F 6B 65 6E 6C 69 74 65 C2

Команда pkcs11-tool

Команда для проверки доступности модуля:

pkcs11-tool --module /usr/lib/librtpkcs11ecp.so -T

Пример вывода команды:

vailable slots:
Slot 0 (0x0): Aktiv Rutoken lite 00 00
  token label        : Rutoken
  token manufacturer : Aktiv Co.
  token model        : Rutoken lite
  token flags        : login required, rng, SO PIN to be changed, token initialized, PIN initialized, user PIN to be changed
  hardware version   : 65.4
  firmware version   : 30.2
  serial num         : 419b79e8
  pin min/max        : 6/32

Графический инструмент XCA

См. XCA: графический инструмент для работы с сертификатами и ключевыми носителями.

Настройка токенов для выполнения двухфакторной аутентификации

См. Двухфакторная PAM-аутентификация с использованием ключевых носителей: пакет libpam-csp.

Работа с токенами Рутокен ЭЦП

Инициализация токена

Для очистки токенов можно использовать команду pkcs11-tool:

error: PKCS11 function C_InitToken failed: rv = unknown PKCS11 error (0x200)
Aborting.

Где:

• --init-token — команда инициализации токена;
• --module — указание интерфейсного модуля токена;
• --so-pin 87654321 — обязательный параметр — действующий PIN-код администратора (офицера безопасности, SO-PIN). Для примера использовано значение кода 87654321, принятое по умолчанию. Использование этого значения при эксплуатации недопустимо;
• --label — обязательный параметр — новая метка токена;

Изменение SO-PIN

Пример команды для замены заданного по умолчанию SO-PIN (87654321) на 987654321:

Где:

• --login и --login-type so — параметры входа в сессию администратора;
• --so-pin — действующий SO-PIN-код администратора;
• --change-pin — команды смены PIN-кода;
• --new-pin — новый SO-PIN-код.

Далее в примерах используется SO-PIN-код администратора, принятый по умолчанию.

Задание и изменение PIN-кода пользователя

Команда для установки (переустановки) PIN-кода пользователя:

pkcs11-tool --module /usr/lib/librtpkcs11ecp.so --so-pin 87654321 --init-pin --pin <PIN_код_пользователя>

Далее в примерах используется необязательная опция --pin, задающая PIN-код пользователя непосредственно в команде. В практических применениях эта опция может не использоваться, PIN-код при этом будет запрашиваться в интерактивном режиме.
Команда для изменения собственного PIN-кода пользователя самим пользователем:

pkcs11-tool --module /usr/lib/librtpkcs11ecp.so --login --pin <старый_PIN-код> --change-pin --new-pin <новый_PIN-код>

При успешном выполнении будет выдано сообщение о том, что PIN-код успешно изменен:

 Using slot 0 with a present token (0x0)
PIN successfully changed 

Работа с сертификатами и ключевыми парами на устройствах Рутокен ЭЦП

Создание ключевой пары

Для генерации ключевой пары в терминале следует ввести команду:

Проверка наличия сертификатов и ключевых пар

Чтобы проверить наличие сертификатов и ключевых пар на токене введите команду:

pkcs11-tool --module /usr/lib/librtpkcs11ecp.so -O -l --pin <PIN_код_пользователя>

В результате выполнения команды отобразится информация обо всех сертификатах (Certificate Object) и публичных ключах (Public Key Object), хранящихся на токене:

Using slot 0 with a present token (0x0)

Public Key Object; RSA 2048 bits
  label:      Test
  ID:         45
  Usage:      encrypt, verify, wrap

Certificate Object, type = X.509 cert
  label:  Test
  ID:     45

Идентификаторы ключей и объектов (ID) используются для выбора сертификатов при выполнении операция с .

Извлечение сертификата из токена

Команда для извлечения сертификата:

pkcs11-tool --module /usr/lib/librtpkcs11ecp.so -r -y cert --id {id} > название_вашего_сертификата.crt

вместо {id} подставить ID который вы увидите в выводе команды

Если после строчки

Using slot 0 with a present token (0x0) 

нет ничего, значит устройство пустое.

Следует обратиться к администратору или создать ключи и сертификат самостоятельно.

Создание самоподписанного сертификата

Для генерации ключевой пары в терминале следует ввести команду:

Для создания самоподписанного сертификата в терминале следует ввести команду:

Загрузка сертификата на токен

Создав свой личный сертификат, его следует загрузить на

токен:

pkcs11-tool --module /usr/lib/librtpkcs11ecp.so -l -y cert -w название_вашего_сертификата.crt -a "Имя_сертификата_в_токене" --id 45

Проверка ключей и сертификатов в 

токене:

Локальная аутентификация в Astra Linux по

токену Рутокен

Установка дополнительных пакетов

Установить следующие пакеты:

• libccid;
• pcscd;
• libpam-p11;
• libpam-pkcs11;
• libp11-2;
• libengine-pkcs11-openssl

• ;
• opensc.

Для установки использовать Графический менеджер пакетов synaptic или команду в терминале:

• Для Astra Linux Special Edition x.7:

  Command
  sudo apt install opensc libengine-pkcs11-openssl libpam-pkcs11 libpam-p11 pcscd libccid

  
  

• Для более ранних обновлений Astra Linux Special Edition и для Astra Linux Common Edition:

  Command
  sudo apt

• install opensc libengine-pkcs11-openssl libp11-

• 2libp11- libpam-pkcs11 libpam-p11 pcscd libccid

  
  

Регистрация сертификата в

ОС

Для регистрации сертификата с ОС:

1. Конвертировать

1. сертификат в текстовый формат

1. :

   Command
   Title openssl
   OpenSSL> x509 -in <название_сертификата>.crt -out <название_сертификата>.pem -inform DER -outform PEM

   где <название_сертификата>.pem - сертификат из токена в текстовом формате.

1. Прочитать с токена сертификат с нужным

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

1. . Для добавления сертификат в список доверенных сертификатов текущего пользователя:

1. Command
   mkdir ~/.eid chmod 0755 ~/.eid cat

1. Ваш_сертификат_из_токена.pem >> ~/.eid/authorized_certificates chmod 0644 ~/.eid/authorized_certificates

   Для привязки токена к

1. другому пользователю

1. указать его домашний каталог например таким образом:

   Command
   sudo mkdir /home/<имя_пользователя>/.eid sudo chmod 0755 /home/<имя_пользователя>/.eid sudo chown <имя_пользователя>:<имя_пользователя> /home/<имя_пользователя>/.eid cat <название_сертификата>.pem | tee -a /home/<имя_пользователя>/.eid/authorized_certificates sudo chown <имя_пользователя>:<имя_пользователя> /home/<имя_пользователя>

1. /.eid/authorized_certificates sudo chmod

1. 0644

1. /home/user/.eid/authorized_certificates

   
   

Настройка аутентификации

1. Создать файл /usr/share/pam-configs/p11 со следующим содержимым:

   Блок кода
   Name: Pam_p11

1. Default: yes

1. Priority: 800

1. Auth-Type: Primary

1. Auth: sufficient pam_p11_opensc.so

1. /usr/lib

1. /librtpkcs11ecp.so

   
   

2. Выполнить команду:

   Command

1. sudo pam-auth-update

   в появившемся окне

1. отметить пункт Pam_p11 и

1. нажать OK

Проверка

Пуск - утилиты - Терминал Fly

Вход выполняется с подключенным токеном к компьютеру. При графическом входе в поле Login вводится имя пользователя, в поле Password вводится <PIN пользователя>. При консольном входе все аналогично, только в момент ввода пароля будет сообщено, что требуется <PIN пользователя>.

Блокировка компьютера при извлечении токена

В состав пакета libpam-pkcs11 входит утилита pkcs11_eventmgr,

позволяющая выполнять различные действия при возникновении событий PKCS#11.

Для настройки pkcs11_eventmgr служит файл конфигурации - /etc/pam_pkcs11/pkcs11_eventmgr.conf

. Пример файла конфигурации представлен ниже:

pkcs11_eventmgr

 ignore ;

action = "/bin/false";
}

# Карта извлечена
event card_remove {
on_error = ignore;

# Вызываем функцию блокировки экрана
action = "fly-wmfunc FLYWM_LOCK";
}

# Карта долгое время извлечена
event expire_time {
# Оставляем значения по умолчанию (ничего не происходит)
on_error = ignore;

action = "/bin/false";
}
}

После создания конфигурации добавить приложение pkcs11_eventmgr в автозагрузку и перезагрузить ОС.

Якорь
rtadmin rtadmin

Инструмент командной строки для администрирования токенов Рутокен rtadmin

Инструмент командной строки rtadmin предоставляется производителем оборудования и предназначен

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

При работе с

инструментом рекомендуется подключать не

более одного устройства.

Поддерживаемые модели токенов:

• Рутокен Lite
• Рутокен Lite SC
• Рутокен ЭЦП
• Рутокен ЭЦП 2.0
• Рутокен ЭЦП SC
• Рутокен ЭЦП PKI
• Рутокен ЭЦП Flash
• Рутокен ЭЦП 2.0 Flash/touch
• Рутокен PINPad

Инструмент (оформлен не как пакет Debian, а как отдельный исполняемый файл) доступен по ссылке: https://dev.rutoken.ru/pages/viewpage.action?pageId=7995615.

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

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

1. убрать флаг -q):

   Command
   ./rtadmin -f -q

   
   

2. Отформатировать один токен разрешив смену пароля администратором и пользователем:

   Command
   ./rtadmin

1. -f -q -p 3

   
   

2. Отформатировать один токен, задав имя токена

1. RutokenAstra, PIN-код пользователя 123456789

1. и PIN-код администратора 987654321

1. :


   Command
   ./rtadmin -f -z /usr/lib/librtpkcs11ecp.so -L RutokenAstra -u 123456789 -a 98765432

1. 1 -q

   
   

Параметры

Инструмент rtadmin поддерживает следующие параметры:

ПО для браузеров Рутокен Web Плагин

Рутокен Плагин (https://www.rutoken.ru/products/all/rutoken-plugin/) — компонент для любых браузеров и операционных систем для прямой работы с криптографией на устройстве. 

Не требует административных прав при установке.

Дополнительные источники информации

При возникновении

вопросов, ответы на

которые не удалось найти

в

настоящей инструкции, рекомендуем

обратиться к следующим дополнительным источникам информации:

• Web-сайт: https://rutoken.ru

• . Сайт содержит большой объем справочной информации об устройствах Рутокен.

• Web-сайт для разработчиков: https://dev.rutoken.ru

• . Содержит техническую информацию об устройствах Рутокен и руководства по

• их интеграции.
• База знаний

• : https://kb.rutoken.ru/display/kb

• . Содержит инструкции по решению большинства ошибок, полезные статьи и ответы на

• часто задаваемые вопросы.

• Доступен поиск по ключевым словам.
• Форум: https://forum.rutoken.ru

• . Здесь

• можно задать

• вопрос

• разработчикам и сотрудникам службы технической поддержки Рутокен.
• Применение Рутокен для Госуслуг без использования КриптоПро: https://dev.rutoken.ru/pages/viewpage.action?pageId=78479384;
• Служба технической поддержки Рутокен:

• https://www.rutoken.ru/support/feedback:

• • Сервис диагностики:

• • https://help.rutoken.ru;

• • Электронная почтв:

• • hotline@rutoken.ru;
  • тел.: +7 495 925-77-90.