Установка и настройка¶

Установка pcscd¶

Служба pcscd занимается поиском и регистрацией CCID-устройств.

1. Установите ccid и pcscd вместе с утилитами для получения данных о смарт-карте:

   • Alt Linux p9:

     apt-get -y install pcsc-lite pcsc-lite-ccid pcsc-tools
     

   • Ubuntu (все версии):

     apt -y install libccid pcscd pcsc-tools
     

   • CentOS 7.x:

     yum -y install pcsc-lite pcsc-lite-ccid pcsc-tools
     

   • AlmaLinux 8.4 и CentOS 8 Stream:

     dnf -y install pcsc-lite pcsc-lite-ccid pcsc-tools
     

2. После установки нужно убедиться, что служба pcscd запущена и работает:

   systemctl status pcscd
   

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

   ● pcscd.service - PC/SC Smart Card Daemon
      Loaded: loaded (/usr/lib/systemd/system/pcscd.service; indirect; vendor pres>
      Active: active (running) since Mon 2021-02-15 17:34:01 MSK; 6min ago
    Main PID: 1529 (pcscd)
       Tasks: 9 (limit: 24924)
      Memory: 5.3M
      CGroup: /system.slice/pcscd.service
              └─1529 /usr/sbin/pcscd --foreground --auto-exit
   
   Feb 15 17:34:01 localhost.localdomain systemd[1]: Started PC/SC Smart Card Daemon.
   

   Если это не так, то запустите его и явно пропишите в автозагрузку:

   systemctl start pcscdsystemctl enable pcscd
   

3. С помощью команды pcsc_scan получите информацию о CCID-устройстве и проверьте наличие смарт-карты:

   user@localhost ~]$ pcsc_scan
   PC/SC device scanner
   V 1.4.25 (c) 2001-2011, Ludovic Rousseau <ludovic.rousseau@free.fr>
   Compiled with PC/SC lite version: 1.8.8
   Using reader plug'n play mechanism
   Scanning present readers...
   0: Gemalto Gemplus USB SmartCard Reader 433-Swap [CCID Interface] (1-0000:00:1d.7-5) 00 00
   1: Aktiv Rutoken ECP 01 00
   
   Tue Feb 16 16:24:27 2021
   Reader 0: Gemalto Gemplus USB SmartCard Reader 433-Swap [CCID Interface] (1-0000:00:1d.7-5) 00 00
     Card state: Card removed,
   Reader 1: Aktiv Rutoken ECP 01 00
     Card state: Card inserted, Shared Mode,
     ATR: 3B 8B 01 52 75 74 6F 6B 65 6E 20 44 53 20 C1
   
   ATR: 3B 8B 01 52 75 74 6F 6B 65 6E 20 44 53 20 C1
   + 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 20 44 53 20
     Category indicator byte: 52 (proprietary format)
   + TCK = C1 (correct checksum)
   
   Possibly identified card (using /home/user/.cache/smartcard_list.txt):
   3B 8B 01 52 75 74 6F 6B 65 6E 20 44 53 20 C1
       Aktiv Rutoken ECP
       https://www.rutoken.ru/products/all/rutoken-ecp/
   

   Если pcsc_scan не выводит ничего, то убедитесь, что служба pcscd запущена и не имеется никаких проблем в логе вывода службы в systemd.

   Примечание

   Команда pcsc_scan сама не завершает работу, её следует закрыть через комбинацию Ctrl+C.

Установка драйвера PKCS11¶

Драйвер PKCS11 как правило является файлом формата so, то есть является обычной библиотекой. Эту библиотеку необходимо предложить приложению, если необходим доступ к сохранённым в смарт-карту сертификатами.

Для Linux предлагается использовать пакеты типа RPM и DEB, но сами so внутри технически заработают везде.

1. Загрузите файл RPM из официального сайта:

   wget https://download.rutoken.ru/Rutoken/PKCS11Lib/2.0.11.0/Linux/x64/librtpkcs11ecp-2.0.11.0-1.x86_64.rpm
   

2. Далее этот пакет необходимо установить через rpm:

   rpm -ihv librtpkcs11ecp-2.0.11.0-1.x86_64.rpm
   

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

   /usr/lib64/librtpkcs11ecp.so -> /opt/aktivco/rutokenecp/x86_64/librtpkcs11ecp.so
   

   При работе с приложениями можно использовать как оригинальный файл в /opt, так и ссылку в lib64.

3. Проверьте доступность смарт-карты при помощи утилит проекта OpenSC. Установите соответствующий пакет:

   yum -y install opensc
   

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

   pkcs11-tool --module /opt/aktivco/rutokenecp/x86_64/librtpkcs11ecp.so -O
   Using slot 1 with a present token (0x1)
   Public Key Object; RSA 2048 bits
     label:      test
     ID:         57306d4b43506457
     Usage:      encrypt, verify, wrap
   Certificate Object; type = X.509 cert
     label:      TIONIX.EXAMPLE
     subject:    DN: C=XX, L=Default City, O=Default Company Ltd
     ID:         6b344a394e683437
   

   Как видим, в обозреваемой смарт-карте имеется публичный ключ и один сертификат. Данный вывод говорит о том, что смарт-карта успешно читается.