@archivesystems/cryptopro

Простой интерфейс для КриптоПро ЭЦП Browser plug-in.

Установка

Требует cadesplugin_api.js. Скачать его можно по ссылке: https://www.cryptopro.ru/sites/default/files/products/cades/cadesplugin_api.js. После подключения cadesplugin_api.js появляется объект window.cadesplugin.

``sh
npm install @archivesystems/cryptopro
`

Использование

`typescript
import {
getCertificates,
getPlugin,
signCadesBES,
} from '@archivesystems/cryptopro';

const plugin = await getPlugin();
const certificates = await getCertificates(plugin);

if (certificates.length > 0) {
const data = 'Hello world';
const signature = await signCadesBES(
plugin,
certificates[0],
data,
'Document name'
);
console.log(signature);
} else {
console.log('No certificates found');
}
`

Подпись результата хэш-функции:

`typescript
import {
getCertificates,
getPlugin,
HashAlgorithm,
signHash,
} from '@archivesystems/cryptopro';

const plugin = await getPlugin();
const certificates = await getCertificates(plugin);

const hash = '12A50838191B5504F1E5F2FD078714CF6B592B9D29AF99D0B10D8D02881C3857';
const algorithm = HashAlgorithm.CP_GOST_3411_2012_256;

if (certificates.length > 0) {
const data = 'Hello world';
const signature = await signHash(
plugin,
certificates[0],
hash,
algorithm,
'Document name'
);
console.log(signature);
} else {
console.log('No certificates found');
}
`

В современных браузерах используются промисы, в Internet Explorer — синхронное выполнение (работа с плагином через NPAPI). Часть методов (например, пример выше) работает одинаково во всех браузерах. Но свойства и методы классов Plugin, Certificate, Signer могут работать по-разному. Например:

`typescript
import {
createObject,
getCertificates,
getPlugin,
ObjectType,
Signer,
} from '@archivesystems/cryptopro';

const plugin = await getPlugin();
const certificates = await getCertificates(plugin);

const signer = await createObject(plugin, ObjectType.Signer);

if (signer.propset_Certificate) {
// Chrome и т. п.
await signer.propset_Certificate(certificates[0]);
} else {
// IE и т. п.
signer.Certificate = certificates[0];
}
``