ИНТЕРФЕЙС УСТАРЕЛ
Интерфейс устарел - пользуйтесь интерфейсом PKCS#11
Исключительно для работы с файловой системой Рутокен существует дополнительный облегченный интерфейс rtAPIlt, отличающийся небольшим набором функций, простотой с точки зрения архитектуры и лёгкостью использования. Являясь дополнительным, интерфейс rtAPIlt не входит в стандартный комплект Рутокен SDK и в составе драйверов Рутокен для Windows
Библиотека rtAPIlt выполнена в виде dll-модуля, написанного на языке C++, и реализована исключительно для Windows. Функциональное описание библиотеки можно логически разделить на следующие части:
- функции работы со считывателями
- функции инициализации токена
- функции аутентификации
- функции работы с директориями
- функции работы с файлами
Список функций
| Имя функции | Краткое описание |
|---|---|
| rtlOpenReadersEnum | Открывает перечисление считывателей с подключенными токенами |
| rtlGetNextReader | Возвращает следующий элемент перечисления считывателей |
| rtlCloseReadersEnum | Уничтожает идентификатор (handle) и закрывает перечисление считывателей |
| rtlBindToken | Создаёт идентификатор (handle) токена и связывает его с считывателем |
| rtlUnbindToken | Уничтожает идентификатор (handle) токена |
| rtlLockToken | Начинает транзакцию, считыватель блокируется |
| rtlUnlockToken | Заканчивает транзакцию, считыватель разблокируется |
| rtlLoginToken | Выполняет авторизацию пользователя с указанным PIN-кодом на токен |
| rtlLogoutToken | Сбрасывает текущие права доступа на токен |
| rtlLogoutTokenEx | Сбрасывает текущие права доступа на токен, в зависимости от значения входных флагов очищает кэш PIN-кода |
| rtlIsAuthenticated | Проверяет, аутентифицирован ли пользователь |
| rtlChangeTokenPin | Изменяет PIN-код пользователя на токене |
| rtlGetTokenPinMaxLength | Возвращает максимально возможную для токена длину PIN-кода |
| rtlGetTokenPinMinLength | Возвращает минимально возможную для токена длину PIN-кода |
| rtlGetTokenLabel | Возвращает имя (label) токена |
| rtlGetTokenID | Возвращает ID токена |
| rtlGetTokenFreeMem | Возвращает количество свободной памяти файловой системы в байтах |
| rtlOpenRootDir | Открывает корневую директорию вендора в файловой системе токена |
| rtlCreateDir | Создаёт новую директорию в файловой системе токена |
| rtlOpenDir | Открывает существующую в файловой системе токена директорию |
| rtlGetDirInfo | Получает информацию о директории |
| rtlCloseDir | Уничтожает идентификатор (handle) и закрывает директорию |
| rtlDeleteDir | Удаляет директорию из файловой системы токена |
| rtlOpenDirEnum | Создаёт идентификатор (handle) и открывает перечисление директорий в данной директории |
| rtlGetNextDir | Возвращает следующий элемент из перечисления директорий |
| rtlCloseDirEnum | Уничтожает идентификатор (handle) и закрывает перечисление директорий |
| rtlCreateFile | Создаёт бинарный файл в файловой системе токена |
| rtlOpenFile | Открывает существующий бинарный в файловой системе токена файл |
| rtlReadFile | Выполняет чтение бинарных данных из файла |
| rtlWriteFile | Записывает бинарные данные в файл |
| rtlGetFileInfo | Возвращает информацию о файле |
| rtlCloseFile | Уничтожает идентификатор (handle) и закрывает файл |
| rtlDeleteFile | Удаляет файл из файловой системы |
| rtlOpenFilesEnum | Создаёт идентификатор (handle) и открывает перечисление файлов в указанной директории |
| rtlGetNextFile | Возвращает следующий элемент из перечисления файлов |
| rtlCloseFilesEnum | Уничтожает идентификатор (handle) и закрывает перечисление файлов в директории |
Полное описание интерфейса Rutoken API доступно по ссылке ftp://ftp.rutoken.ru/support/rtSDK/Docs/rtDevelopersManual.MiddleLevel.pdf