cadesplugin



npm crypto-pro-cadesplugin

Библиотека предоставляет API для работы c cadesplugin и Крипто Про

> ## Обратите внимание! Для пробной работы с Компонентом вам необходимо иметь
> * Компьютер под управлением Windows, Linux, MacOS или FreeBSD
> * Один из современных браузеров (Internet Explorer, Mozilla Firefox, Opera, Chrome, Яндекс.Браузер, Safari) с поддержкой сценариев JavaScript
> * Установленный плагин для браузера «КриптоПро ЭЦП Browser plug-in» (Установить)
> * Если планируется создание ЭЦП по ГОСТ Р 34.10-2001/2012, то необходимо установить СКЗИ КриптоПро CSP
> * Cертификат ключа подписи, который можно получить на странице тестового центра
> * Проверить работу установленного плагина

API

$3

Выводит информацию о верисии плагина и так далее

$3

Получает массив валидных сертификатов

$3

Получает сертификат по thumbprint значению сертификата

$3

Получает сертификат по thumbprint значению сертификата.
С помощью этой функции в сертификате доступны методы для парсинга информации о сертификате

$3

Подписать строку в формате base64
> Поддерживаемые КриптоПро ЭЦП Browser plug-in браузеры (IE, Firefox, Opera, Chrome, Safari) не предоставляют простого и надежного способа обработки бинарных данных. Таким образом, невозможно обеспечить корректную передачу бинарных данных из браузера в плагин и обратно.
При подписании произвольных данных рекомендуется предварительно закодировать их в Base64 и использовать свойство ContentEncoding.

> По этой же причине для возвращаемых из КриптоПро ЭЦП Browser plug-in строк, в которых могут содержаться бинарные данные, не поддерживается кодировка CAPICOM_ENCODING_BINARY.

$3

Подписать строку в формате XML

Custom certs format API

$3

Возвращает распаршенную информацию о строке subjectInfo

$3

Возвращает распаршенную информацию о строке issuerInfo

$3

Возвращает распаршенную информацию об объекте validPeriod

$3

Функция формирует ключи и значения в зависимости от переданного параметра
Доступные параметры 'subjectInfo' и 'issuerInfo'

$3

Формирует дату от переданного параметра

$3

Производит проверку на валидность сертификата

Usage

``js
import cadesplugin from 'crypto-pro-cadesplugin';

/**
* @async
* @function doCertsList
* @description формирует массив сертификатов с оригинальными значениями
*/
async function doCertsList() {
const certsApi = await cadesplugin;
const certsList = await certsApi.getCertsList();

return certsList;
}

/**
* @async
* @function doFriendlyCustomCertsList
* @description формирует массив сертификатов с кастомными полями
*/
async function doFriendlyCustomCertsList() {
const certsApi = await cadesplugin;
const certsList = await certsApi.getCertsList();

const friendlyCertsList = certsList.map(cert => {
const friendlySubjectInfo = cert.friendlySubjectInfo();
const friendlyIssuerInfo = cert.friendlyIssuerInfo();
const friendlyValidPeriod = cert.friendlyValidPeriod();
const {
to: { ddmmyy, hhmmss }
} = friendlyValidPeriod;

return {
subjectInfo: friendlySubjectInfo,
issuerInfo: friendlyIssuerInfo,
validPeriod: friendlyValidPeriod,
thumbprint: cert.thumbprint,
title: ${
friendlySubjectInfo.filter(el => el.value === 'Владелец')[0].text
}. Сертификат действителен до: ${ddmmyy} ${hhmmss}
};
});
}
`


$3


`js
import {useMemo, useState} from "react";
import ccpa from "crypto-pro-cadesplugin";

const useDoCertsList = () =>
useMemo(async () => {
const certsApi = await ccpa();
const certsList = await certsApi.getCertsList();

const list = certsList.map(({subjectInfo, thumbprint}) => ({
value: thumbprint,
label: subjectInfo
}));
return list;
}, []);

const SelectCert = () => {
const [listSert, setListSert] = useState([{value: "подпись", label: "подпись"}]);

useDoCertsList()
.then(setListSert)

return (


{
listSert.map(item => (
{item.label}
))
}

Выберите сертификат

);
};

export default SelectCert;
`

$3


`js
const sign = await ccpa.signBase64(thumbprint, sBase64Data);
`

$3

`js
const sign = await ccpa.signXml(thumbprint, Xml);
``

> пример использования можно посмотреть в библиотеке которая использует этот компонент для React.js file-signature-in-react
> https://github.com/bad4iz/file-signature-in-react