Функциональность JC-WebClient API¶
JC-WebClient API логически подразделяется на:
- Функции для работы со средствами электронной подписи (ЭП) из контекста Web-страницы
- Функции для работы с Trust Screen-устройствами из контекста Web-страницы
- Автономные программные функции, которые могут быть вызваны из контекста Web-страницы без использования средств ЭП и Trust Screen-устройств
- Функции для поддержки TLS-функциональности
- Функции получения данных клиентского ПК
- Функции получения данных о СКЗИ
Функции для работы со средствами ЭП¶
| Средство ЭП | В состав каких устройств входит | Поддерживаемая функциональность |
|---|---|---|
“Криптотокен 2 ЭП” Будем далее называть токен GOST 2 |
|
|
“Криптотокен ЭП” Будем далее называть токен GOST |
|
|
| Токен PRO |
|
|
“Laser” Будем далее называть токен PKI |
|
|
“DataStore” Будем далее называть токен STORAGE |
|
Функции для работы с Trust Screen-устройствами¶
| Trust Screen-устройство | Поддерживаемая функциональность |
|---|---|
| Антифрод-терминал |
Работа с PIN-кодами
Важно JaCarta-2 ГОСТ не поддерживается при работе с “Антифрод-терминалом” версии 22:22. Для поддержки JaCarta-2 ГОСТ следует обновить версию прошивки до 25:35 и выше. |
Автономные программные функции¶
- Инициализация JC-WebClient на Web-странице (функция initialize)
- Получение сведений о версии приложения JC-WebClient (команда getJCWebClientVersion)
- Получение информации о всех подключенных устройствах (команда getAllSlots)
- Получение информации об устройстве (команда getSlotInfo)
- Разбор сертификатов X.509 (команда parseX509Certificate)
- Разбор данных в формате PKCS#7 (команды pkcs7Parse и pkcs7ParseBase64Encoded)
- Конвертация сертификатов и других данных из формата DER в PEM (функция derToPem)
- Установка параметров по умолчанию (функция defaults)
- Установка режима работы с токеном (сохранять ли сессию при переходах между Web-страницами в рамках вкладки)
Функции для поддержки TLS-функциональности¶
Функциональность установления TLS-соединений в общем случае не требует доработки кода Web-страниц. Тем не менее JC-WebClient поддерживает на уровне API команды, которые при необходимости могут быть использованы Web-разработчиками из контекста Web-страницы (см. раздел TLS-функциональность).
Функции получения данных клиентского ПК¶
Для получения данных клиентского ПК (см. раздел API Получение данных клиентского ПК), необходимо чтобы был подключен один из поддерживаемых токенов, и до их выполнения был введён корректный PIN-код (для защиты от несанкционированного сбора данных о клиентских ПК вредоносными скриптами на фишинговых сайтах).
Примечание
Для получения информации о ПК у пользователь устройства должен иметь пользовательскую лицензию. Для получения лицензии JC-WebClient обращается к северу запросов на лицензию. Настроить URL сервера запросов на лицензию можно с помощью функции initialize (см. аргумент licensing)
| Собираемые данные | Команды |
|---|---|
|
getSystemInfo |
| Системные дата и время | getSystemDateTime |
|
getIpConfig |
| Запущенные процессы с соответствующими им активными сетевыми соединениями | getProcesses |
| Коммулятивная функция. Позволяет получить все данные клиентсокго ПК(или какую-то часть) за один вызов. | getUserHostData |
Дополнительно к описанным функциям, в JC-WebClient существует возможность получения данных с ПК пользователя, а затем добавления этих данных в пакет PKCS#7 при электронной подписи документа. Для этого необходимо вызвать функцию signData или signBase64EncodedData с соответствующим значением парметра userHostData.
- Примеры получения данных с ПК пользователя при подписи:
Добавление информации о сетевых интерфейсах и просессах в подпись.
JCWebClient2.signBase64EncodedData({ args: { contID: contID, data: data, userHostData: [JCWebClient2.Vars.UserHostData.ipconfig, JCWebClient2.Vars.UserHostData.processes] }, onResult: function (signature, error) { } });
Добавление в подпись всей информации, собранной с ПК пользователя.
JCWebClient2.signBase64EncodedData({ args: { contID: contID, data: data, userHostData: [JCWebClient2.Vars.UserHostData.all] }, onResult: function (signature, error) { } });
Разделение данных о ПК пользователя и подписи документа.
.then(function() { return JCWC.signData(tokenContainer.id, Base64.decodeArray(_this.workState.dataForSign), IsGOST2(tokenInfo)); }) .then(function(signedData) { // signedData -получили подпись // запрашиваем информацию о ситеме return JCWC.getUserHostData(); }) .then(function(systemInfo) { // systemInfo -данные о системе в виде JSON })
Функции получения данных о СКЗИ¶
| Собираемые данные | Команды |
|---|---|
|
getTokenInfo |
|
Оглавление
- JC-WebClient SDK 4.3
- JC-Mobile SDK iOS v.2.5.3
- JC-Mobile SDK Android v2.5.3
- JC-Sign SDK Android v.1.0.0
- JC-Sign SDK iOS v.1.0.0
- JaCarta-2 SDK v.2.4.1
- Единая библиотека PKCS #11 2.4.1
- Антифрод-терминал (прошивка v.25.35)
- JaCarta File System 1.1.0
- Архив