3.1 Функции для работы со средствами ЭП

Токен

Поддерживаемая функциональность

Токен GOST 2

  • Создание ключевых пар (неизвлекаемый закрытый ключ и ключ проверки ЭП) по ГОСТ Р 34.10-2001 и ГОСТ Р 34.10-2012 (команда createKeyPair)
  • Создание ЭП по ГОСТ Р 34.10-2001 и ГОСТ Р 34.10-2012 (с быстрым программным хэшированием) в формате PKCS#7 (команды signData и signBase64EncodedData)
  • Проверка ЭП в формате PKCS#7 по ГОСТ Р 34.10-2001 и ГОСТ Р 34.10-2012 с быстрым программным хэшированием и построением цепочки сертификатов от доверенного открытого ключа на токене до сертификата подписанта (команды verifyData и verifyBase64EncodedData)
  • Быстрое программное зашифрование/расшифрование по ГОСТ 28147-89 в режиме гаммирования с обратной связью с выработкой ключа парной связи на основе преобразований по алгоритмам VKO GOST R 34.10-2001 (в соответствии с RFC 4357) и VKO_GOSTR3410_2012_256 (в соответствии с рекомендациями Технического комитета 026) и с построением цепочки сертификатов от доверенного открытого ключа на токене до сертификата получателя/отправителя (команды encryptData и decryptData)
  • Быстрое программное вычисление значения хэш-функции по ГОСТ Р 34.11-94 и ГОСТ Р 34.11-2012 (команда digest)
  • Генерация запросов на сертификаты в формате PKCS#10 (команда genCSR)
  • Возможность установки строгого сеанса работы с токеном (см. аргумент secureMessaging в команде bindToken)
  • Аутентификация в токене (переход из гостевого режима в режим пользователя) через предъявление PIN-кода пользователя либо через параметр соответствующего метода, либо путём ввода на встроенном GUI-интерфейсе(команда bindToken)
  • Возможность использования PIN-кода подписи как дополнительного подтверждения при подписании важных данных (см. способы передачи PIN-кода подписи в командах signData и signBase64EncodedData)
  • Возможность использования PUK-кода для выполнения разблокирования PIN-кодов по аналогии с банковскими картами (команда unblockUserPIN)
  • Запись, чтение, удаление и хранение цифровых сертификатов X.509 на устройствах (см. Работа с автономными сертификатами)
  • Запись, чтение, изменение, удаление и хранение бинарных объектов на устройствах (см. Хранение данных)
  • Смена PIN-кода пользователя (команда changePIN)
  • Смена PIN-кода подписи (команда changeSignaturePIN)
  • Удаление всех пользовательских объектов с токена (команда clearToken)
  • Получение информации о токене (команда getTokenInfo)

Токен PKI



  • Создание ключевых пар (неизвлекаемый закрытый ключ и ключ проверки ЭП) по RSA-1024, RSA-2048, RSA-4096 и ECDSA (команда createKeyPair)
  • Создание ЭП по RSA-1024, RSA-2048, RSA-4096 и ECDSA с программным или аппаратным хэшированием в формате PKCS#7 (команды signData и signBase64EncodedData)
  • Проверка ЭП по RSA-1024, RSA-2048, RSA-4096 и ECDSA (программная или аппаратная с программным или аппаратным хэшированием) в формате PKCS#7. Если хэширование аппаратное, то проверка ЭП тоже аппаратная (команды verifyData и verifyBase64EncodedData)
  • Вычисление значения хэш-функции по SHA-1 (программное или аппаратное). Команда digest
  • Генерация запросов на сертификаты в формате PKCS#10 (команда genCSR)
  • Запись, чтение, удаление и хранение цифровых сертификатов X.509 на устройствах (см. Работа с автономными сертификатами)
  • Запись, чтение, изменение, удаление и хранение бинарных объектов на устройствах (см. Хранение данных)
  • Установка PIN-кода пользователя (команда initUserPIN)
  • Смена PIN-кода пользователя (команда changePIN)
  • Аутентификация в токене (переход из гостевого режима в режим пользователя) через предъявление PIN-кода пользователя либо через параметр соответствующего метода, либо путём ввода на встроенном GUI-интерфейсе (команда bindToken)
  • Инициализация токена (команда initToken)
  • Получение информации о токене (команда getTokenInfo)

Токен STORAGE

  • Установка PIN-кода пользователя (команда initUserPIN)
  • Смена PIN-кода пользователя (команда changePIN)
  • Разблокировка PIN-кода пользователя с использованием PIN-кода администратора (команда unblockUserPIN)
  • Аутентификация в токене (переход из гостевого режима в режим пользователя) через предъявление PIN-кода пользователя либо через параметр соответствующего метода, либо путём ввода на встроенном GUI-интерфейсе (команда bindToken)
  • Инициализация токена (команда initToken)
  • Получение информации о токене (команда getTokenInfo)

3.2 Автономные программные функции

  • Инициализация JC-WebClient на Web-странице (функция initialize)
  • Получение сведений о версии приложения JC-WebClient (команда getJCWebClientVersion)
  • Получение информации о всех подключенных устройствах (команда getAllSlots)
  • Получение информации об устройстве (команда getSlotInfo)
  • Разбор сертификатов X.509 (команда parseX509Certificate)
  • Разбор данных в формате PKCS#7 (команды pkcs7Parse и pkcs7ParseBase64Encoded)
  • Конвертация сертификатов и других данных из формата DER в PEM (функция derToPem)
  • Установка параметров по умолчанию (функция defaults)
  • Установка режима работы с токеном (сохранять ли сессию при переходах между Web-страницами в рамках вкладки)

3.3 Функции для поддержки TLS-функциональности

Функциональность установления TLS-соединений в общем случае не требует доработки кода Web-страниц. Тем не менее JC-WebClient поддерживает на уровне API команды, которые при необходимости могут быть использованы Web-разработчиками из контекста Web-страницы (см. раздел TLS-функциональность).

3.4 Функции получения данных клиентского ПК

Для получения данных клиентского ПК (см. раздел API Получение данных клиентского ПК), необходимо чтобы был подключен один из поддерживаемых токенов, и до их выполнения был введён корректный PIN-код (для защиты от несанкционированного сбора данных о клиентских ПК вредоносными скриптами на фишинговых сайтах).

Примечание: Для получения информации о ПК необходима лицензия:

  • пользователь устройства должен иметь пользовательскую лицензию. Для получения лицензии JC-WebClient обращается к северу запросов на лицензию. Настроить URL сервера запросов на лицензию можно с помощью функции initialize (см. аргумент licensing.activationRequestUrl)
  • должна быть лицензия-подписка. Настроить лицензию-подписку можно с помощью функции initialize (см. аргумент licensing.license_data)

Собираемые данные

Команды

  • Уникальный идентификатор рабочей станции
  • Имя активного пользователя
  • Тип ОС
  • Описание ОС
  • Архитектура ОС

getSystemInfo

Системные дата и время

getSystemDateTime

  • Имя хоста рабочей станции
  • Настроенные сетевые интерфейсы

getIpConfig

Запущенные процессы с соответствующими им активными сетевыми соединениями

getProcesses

Кумулятивная функция. Позволяет получить все данные клиентского ПК(или какую-то часть) за один вызов.

getUserHostData

Дополнительно к описанным функциям, в JC-WebClient существует возможность получения данных с ПК пользователя, а затем добавления этих данных в пакет PKCS#7 при электронной подписи документа. Для этого необходимо вызвать функцию signData или signBase64EncodedData с соответствующим значением параметра userHostData.

Примеры получения данных с ПК пользователя при подписи:

  1. Добавление информации о сетевых интерфейсах и процессах в подпись.
JCWebClient2.signBase64EncodedData({
args: {
    contID: contID,
    data: data,
    userHostData: [JCWebClient2.Vars.UserHostData.ipconfig, JCWebClient2.Vars.UserHostData.processes]
},
onResult: function (signature, error) { }
});

  2. Добавление в подпись всей информации, собранной с ПК пользователя.

JCWebClient2.signBase64EncodedData({
args: {
    contID: contID,
data: data,
userHostData: [JCWebClient2.Vars.UserHostData.all]
},
onResult: function (signature, error) { }
});

3.5 Функции получения данных о СКЗИ

Собираемые данные

Команды

  • Тип токена
  • Серийный номер токена
  • Заданные при инициализации СКЗИ флаги, атрибуты, политики
  • Информация о памяти токена

getTokenInfo

  • Модель устройства
  • Серийный номер устройства
  • Форм-фактор
  • Тип ридера (при наличии)

getSlotInfo,
getAllSlots