Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Для отладки приложений использующих интерфейс PKCS#11 можно использовать

...

утилиту PKCS11-SPY.

Это переработанная версия утилиты, входящей в

...

проект OpenSC

...

 и отличается от нее поддержкой расширенного интерфейса. 

Утилита выводит лог PKCS#11 вызовов в

...

формате текстового файла.

...

Подготовка файлов

Заменим оригинальную библиотеку на библиотеку-шпион, для этого:

Загрузить утилиту

1. Загрузите архив - 

pkcs11-spy.zip

Чтобы отладить библиотеку необходимо переименовать ее (чтобы приложение не загружало ее напрямую). 

А библиотеку-шпион назвать именем библиотеки, которую необходимо логировать.

Настройка утилиты

Для 32 битных Windows

Для 32 битных приложений

В реестре установить в строковый параметр HKLM\Software\Aktiv Co.\Rutoken\rtPKCS11-Spy\Module путь к отлаживаемой библиотеке PKCS#11.

В реестре установить в строковый параметр HKLM\Software\Aktiv Co.\Rutoken\rtPKCS11-Spy\Output путь к лог файлу, в который будет записываться последовательность вызовов PKCS#11 функций.

...

2. Разархивируйте содержимое

3. Выберите версию ОС и разрядность в соответствии с разрядностью приложения

  • Рутокен Плагин использует 32х разрядную библиотеку PKCS#11
  • Драйверы Рутокен содержат обе библиотеки. Какая используется – решает приложение.

4. Найдите папку с библиотекой PKCS#11 (rtPKCS11ECP), которую использует приложение:

  • для Рутокен Плагин - C:\Users\Имя_пользователя\AppData\Roaming\Aktiv Co\CryptoPlugin\4.4.1.0
  • для Драйверов Рутокен – C:\Windows\System32\ или C:\Windows\SysWOW64\

5. Переименуйте оригинальную библиотеку PKCS#11 (rtPKCS11ECP)

6. Скопируйте rtpkcs11-spy.dll из разархивированной папки в папку с оригинальной библиотекой PKCS#11 (rtPKCS11ECP)

7. Переименуйте библиотеку-шпион, задав ей имя оригинальной библиотеки PKCS#11 (rtPKCS11ECP)

Настройка утилиты

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

Для Windows

Для 32 битных приложений

В реестре установить в строковый параметр HKLM\Software

...

\Aktiv Co.\Rutoken\rtPKCS11-Spy\Module путь к

...

оригинальной библиотеке PKCS#11 (rtPKCS11ECP).

В реестре установить в строковый параметр HKLM\Software

...

\Aktiv Co.\Rutoken\rtPKCS11-Spy\Output путь к лог файлу, в который будет записываться последовательность вызовов PKCS#11 функций.

Для 64 битных приложений

В реестре установить в строковый параметр HKLM\Software\Aktiv Co.\Rutoken\rtPKCS11-Spy\Module путь к

...

оригинальной библиотеке PKCS#11 (rtPKCS11ECP).

В реестре установить в строковый параметр HKLM\Software\Aktiv Co.\Rutoken\rtPKCS11-Spy\Output путь к лог файлу, в который будет записываться последовательность вызовов PKCS#11 функций.

Для Linux и

...

macOS

записать в системные переменные 

RT_PKCS11SPY - путь к

...

оригинальной библиотеке PKCS#11 (rtPKCS11ECP)

RT_PKCS11SPY_OUTPUT - путь к лог файлу, в который будет записываться последовательность вызовов PKCS#11 функций.

Например:

для linux

RT_PKCS11SPY=/opt/aktivco/rutokenecp/lib/librtpkcs11ecp.so
RT_PKCS11SPY_OUTPUT=/home/user/Desktop/logfile.txt

для Mac

RT_PKCS11SPY=/Library/Aktiv\ Co/Rutoken\ ECP/lib/librtpkcs11ecp.dylib
RT_PKCS11SPY_OUTPUT=/Users/user/Desktop/logfile.txt