| Expand | ||
|---|---|---|
| ||
|
RtPcsc - фреймворк для работы с Рутокен ЭЦП Bluetooth, виртуальными считывателями Рутокен VCR, а также NFC-устройствами семейства Рутокен ЭЦП.
...
| Info |
|---|
| Внимание! Приложение со встроенным RtPcsc.framework может быть запущено только на физических устройствах Apple, не на эмуляторе. Обратите внимание, что работа с VCR API доступна только на iPad. |
Для работы с
...
Добавить в Info.plist ключ UISupportedExternalAccessoryProtocols со значением com.aktivco.rutokenecp.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<key>UISupportedExternalAccessoryProtocols</key>
<array>
<string>com.aktivco.rutokenecp</string>
</array>
|
Для работы с NFC устройствами Рутокен необходимо
...
| Info | ||
|---|---|---|
| ||
Примеры готовых приложений можно найти в репозиториях на GitHub: rutoken-demobank-ios и rutoken-demoshift-ios. |
Для работы с USB-токенами необходимо
Начиная с iOS/iPadOS 16.2 стала возможна работа USB-токенов.
Для включения поддержки USB-токенов достаточно только обновления RtPcsc.framework до версии 4.0.0 или новее.
Описание интерфейса RtPcsc для работы с NFC/VCR
| Warning | ||
|---|---|---|
| ||
Начиная с версии RtPcsc 5.0.0 для обнаружения нового считывателя с помощью "\\?PnP?\Notification", необходимо указывать количество уже известных приложению считывателей в верхнем слове dwCurrentState. Например, так: Если ожидаемое приложением количество считывателей не совпадет с реальным, управление будет сразу же возвращено, а в верхнем слове dwEventState будет содержаться текущее количество считывателей. Пример работы с функцией SCardGetStatusChange, учитывающий поведение описанное на GitHub. |
| Expand | ||
|---|---|---|
| ||
|
...
- RUTOKEN_CONTROL_CODE_START_NFC - запуск обнаружения по NFC;
- RUTOKEN_CONTROL_CODE_STOP_NFC - остановка обнаружения по NFC;
- RUTOKEN_CONTROL_CODE_STOP_NFC_WITH_ERROR - остановка обнаружения по NFC с показом иконки ошибки;
- RUTOKEN_CONTROL_CODE_LAST_NFC_STOP_REASON - возврат причины прекращения обнаружения по NFC.
Параметр pbSendBuffer используется для передачи дополнительной информации:
- при RUTOKEN_CONTROL_CODE_START_NFC: параметр задан в формате
"\(waitMessage)\0\(workMessage)\0\0"и содержит два сообщения:- waitMessage отображается во время ожидания карты,
- workMessage отображается во время работы с картой;
- при RUTOKEN_CONTROL_CODE_STOP_NFC: параметр содержит сообщение о завершении работы с картой.;
- при RUTOKEN_CONTROL_CODE_STOP_NFC_WITH_ERROR: параметр содержит сообщение о завершении работы с картой .с уведомлением об ошибке;
- при RUTOKEN_CONTROL_CODE_LAST_NFC_STOP_REASON: параметр не используется.
Рекомендуемый порядок работы с Рутокеном с NFC
...
- получить список доступных ридеров с помощью функции SCardListReaders;
- если ридер еще не появился – дождаться его появления с помощью функции SCardGetStatusChange;
- вызов функции SCardConnect для нужного ридера с параметром dwShareMode == SCARD_SHARE_DIRECT;
- вызов функции SCardControl с параметром RUTOKEN_CONTROL_CODE_START_NFC;
- работа с Рутокеном;
- вызов функции SCardControl с параметром RUTOKEN_CONTROL_CODE_STOP_NFC;
- вызов функции SCardDisconnect.
Причину завершения обнаружения NFC устройств можно получить с помощью вызова функции SCardControl с параметром RUTOKEN_CONTROL_CODE_LAST_NFC_STOP_REASON.
...
- RUTOKEN_NFC_STOP_REASON_FINISHED - вызов SCardControl с параметром RUTOKEN_CONTROL_CODE_STOP_NFC;
- RUTOKEN_NFC_STOP_REASON_UNKNOWN - причина завершения неизвестна;
- RUTOKEN_NFC_STOP_REASON_TIMEOUT - системный таймаут (на устройствах под управлением iOS предоставляется 20 секунд на одну NFC сессию);
- RUTOKEN_NFC_STOP_REASON_CANCELLED_BY_USER - нажатие кнопки "Отмена" на системном окне обнаружения NFC;
- RUTOKEN_NFC_STOP_REASON_NO_ERROR - системное окно работы с NFC еще не опускалось, ошибок нет.
Получение типа устройства Рутокен
...
Функция возвращает true, если разрыв произошёл успешно, и false в противном случае. В качестве параметра она принимает SHA1-хеш от сертификата считывателя, пару с котором необходимо разорвать.
Рекомендуемый порядок работы с VCR
...
- Вызвать функцию SCardEstablishContext;
- Сгенерировать QR-код для создания пары с помощью функции generatePairingQR;
- Запустить процесс ожидания подключения ридеров, вызвав функцию SCardGetStatusChange;
- Осуществить сопряжение с VCR и дождаться подключения ридера на уровне RtPcsc (для iPad будут отображаться доступные виртуальные считыватели);
- Вызов функции SCardConnect для нужного считывателя с параметром dwShareMode == SCARD_SHARE_DIRECT;
- Вызов функции SCardControl с параметром RUTOKEN_CONTROL_CODE_START_NFC;
- Работа с Рутокеном;
- Вызов функции SCardControl с параметром RUTOKEN_CONTROL_CODE_STOP_NFC;
- Вызов функции SCardDisconnect.
Пример работы с API
Примеры работы с API есть в репозитории на GitHub rutoken-demoshift-ios в файле https://github.com/AktivCo/rutoken-demoshift-ios/blob/master/demoshift/PcscWrapper/PcscWrapper.swift