Fork пакета vgoma/crypto-pro.

Основные отличия от оригинального пакета:

• подняты версии пакетов,
• реализован "indirect eval"
• удалены примеры

TODO:

• Починить тесты

---

cryptoPro

Единое, асинхронное API для взаимодействия с КриптоПРО ЭЦП Browser Plug-In.

• Зачем мне этот пакет?
• Установка
• API
  • Методы объекта cryptoPro
  • Методы объекта сертификата

Зачем мне этот пакет?

КриптоПРО ЭЦП Browser Plug-In доступен в разных браузерах в двух версиях. Асинхронной (в современных браузерах) и синхронной (в браузерах постарше). С помощью этого пакета можно не писать реализацию под каждую версию плагина дважды. И вместо этого и этого написать это (UMD):

или это (ES Modules + Typescript):

Установка

Для NPM:

npm install @lexfoxer/crypto-pro

Для Yarn:

yarn add @lexfoxer/crypto-pro

Подключение пакета как UMD модуля через тэг script:

<script src="crypto-pro/dist/crypto-pro.min.js"></script>
<script>
window.cryptoPro.getUserCertificates()
  .then(function (certificates) {
    //...
  })
  .catch(function (error) {
    //...
  });
</script>

Подключение пакета как ES модуля с Typescript или JavaScript:

import { getUserCertificates, Certificate } from 'crypto-pro';

(async () => {
  let certificates: Certificate[];

  try {
    certificates = await getUserCertificates();
  } catch(error) {
    // ...
  }
})();

Список требуемых полифиллов (если необходимы, подключаются самостоятельно):

• Promise
• Array.prototype.find

API

Методы объекта cryptoPro

• getUserCertificates - возвращает список сертификатов, доступных пользователю в системе
• getCertificate - возвращает сертификат по отпечатку
• createAttachedSignature - создает совмещенную (присоединенную) подпись сообщения
• createDetachedSignature - создает отсоединенную (открепленную) подпись сообщения
• createXMLSignature - создает XML подпись для документа в формате XML
• createHash - создает хеш сообщения по ГОСТ Р 34.11-2012 256 бит
• createSignature - создает подпись сообщения

  Является устаревшим и будет убран из будущих версий. Используйте "createAttachedSignature" и "createDetachedSignature".

• getSystemInfo - возвращает информацию о CSP и плагине
• isValidSystemSetup - возвращает флаг корректности настроек ЭП на машине
• execute - компилирует и выполняет переданную функцию для доступной браузерной среды (синхронной/асинхронной)

Методы объекта сертификата

Сертификат предоставляет следущее API:

• isValid - возвращает флаг действительности сертификата
• getCadesProp - возвращает указанное внутренее свойство у сертификата в формате Cades
• exportBase64 - возвращает сертификат в формате base64
• getAlgorithm - возвращает информацию об алгоритме сертификата
• getOwnerInfo - возвращает расшифрованную информацию о владельце сертификата
• getIssuerInfo - возвращает расшифрованную информацию об издателе сертификата
• getExtendedKeyUsage - возвращает ОИД'ы сертификата
• getDecodedExtendedKeyUsage - возвращает расшифрованные ОИД'ы
• hasExtendedKeyUsage - проверяет наличие ОИД'а (ОИД'ов) у сертификата