Class: CryptoPlugin

Правильно созданный объект всегда возвращает true

Изменение PIN-кода. Если переданы параметры authPin и newPin, то будет изменен PIN-код пользователя. Если эти параметры не переданы, то будет изменен PIN-код "PIN2" (только на PINPad2)

Шифрование данных в формате CMS. Аргумент options принимает параметры шифрования. Доступны следующие опции (в скобках указано значение по умолчанию):

• base64:bool (false) - закодированы ли переданные данные в base64
• cipherAlgorithm:enum - алгоритм шифрования в режиме cbc (необходимо указывать только для ключей RSA), варианты: CIPHER_ALGORITHM_DES, CIPHER_ALGORITHM_3DES, CIPHER_ALGORITHM_AES128, CIPHER_ALGORITHM_AES192, CIPHER_ALGORITHM_AES256

Удаление сертификата с устройства. Для выполнения этой функции требуется авторизоваться на устройстве.

Выработка ключа обмена. Аргумент options принимает параметры выработки. Доступны следующие опции (в скобках указано значение по умолчанию):

• ukm:string (00:00:00:00:00:00:00:01) - Синхропосылка (hex-строка)

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

Получение массива с идентификаторами закрытых ключей в HEX.

Для выполнения этой функции требуется авторизоваться на устройстве.

Генерация ключевой пары на устройстве. Для выполнения этой функции требуется авторизоваться на устройстве. Аргумент options задает различные свойства ключа. Доступны следующие опции:

• id:string("") - уникальный идентификатор ключевой пары (hex). Если опция не задана, или в качестве значения указана пустая строка, будет сгенерирован автоматически.
  При генерации ключей для ЕГАИС необходимо указывать id:string, состоящий из печатных символов и не содержащий пустого символа. Пример правильного id:string для ЕГАИС -> "abc123", что в шестнадцатеричной кодировке будет выглядеть как id:string("41:42:43:31:32:33"), для автоматического преобразования рекомендуем использовать функцию asciitohex() см. пример ниже.


• publicKeyAlgorithm:enum(PUBLIC_KEY_ALGORITHM_GOST3410_2001) - алгоритм, варианты:
• PUBLIC_KEY_ALGORITHM_GOST3410_2001 - ГОСТ Р 34.10-2001;
• PUBLIC_KEY_ALGORITHM_GOST3410_2012_256 - ГОСТ Р 34.10-2012 длина закрытого ключа 256 бит;
• PUBLIC_KEY_ALGORITHM_GOST3410_2012_512 - ГОСТ Р 34.10-2012 длина закрытого ключа 512 бит;
• PUBLIC_KEY_ALGORITHM_RSA - RSA
• Примечание: В ЕГАИС используется PUBLIC_KEY_ALGORITHM_GOST3410_2012_256. Алгоритм ГОСТ Р 34.10-2001 выводится из эксплуатации в 2019 году


• signatureSize:number - размер подписи в битах, значения по умолчанию:
• ГОСТ Р 34.10-2001 - 512
• ГОСТ Р 34.10-2012 длина закрытого ключа 256 бит - 512
• ГОСТ Р 34.10-2012 длина закрытого ключа 512 бит - 1024
• RSA - 2048
• paramset:string - задает параметры ключевой пары. Если опция не задана, будут выбраны параметры А для любого из алгоритмов ГОСТ. Возможные варианты:
• ГОСТ Р 34.10-2001:
• "A"
• "B"
• "C"
• "XA"
• "XB"
• ГОСТ Р 34.10-2012 длина закрытого ключа 256 бит:
• "A"
• "B"
• "C"
• "XA"
• "XB"
• ГОСТ Р 34.10-2012 длина закрытого ключа 512 бит:
• "A"
• "B"
• keyType:enum(KEY_TYPE_COMMON) - тип ключевой пары, доступны варианты:
• KEY_TYPE_COMMON - обычная ключевая пара;
• KEY_TYPE_JOURNAL - журнальная ключевая пара (может быть использована только для подписи журнала);

• needPin:bool(false) - если ключевая пара создана на PINPad 2, для каждого ее использования потребуется ввести PIN-код на устройстве;
• needConfirm:bool(false) - если ключевая пара создана на PINPad 2, для каждого ее использования потребуется подтверждение на устройстве;

// Преобразование шестнадцатеричного id ключевой пары в формат для ЕГАИС
function asciitohex(str){
    var result = [];
    for (var n = 0, l = str.length; n < l; n++) {
         var code = str.charCodeAt(n);
         if(code > 128 || code == 32)
             continue;

         var hex = code.toString(16);
         result.push(hex);
    }
    return result.join(':');
}
 

Получение информации о сертификате.

Тип информации задается константами: CERT_INFO_SERIAL_NUMBER. Для выполнения этой функции требуется авторизоваться на устройстве.

Получение метки устройства

Получение константы, обозначающей тип устройства.

Получение идентификатора ключевой пары по сертификату. Для выполнения этой функции требуется авторизоваться на устройстве.

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

Получение значения открытого ключа. Не поддерживается для ключей RSA. Для выполнения этой функции требуется авторизоваться на устройстве.

Импорт сертификата на устройство. Для выполнения этой функции требуется авторизоваться на устройстве.

Закрытие сессии

Получение ассоциативного массива с разобранными полями из сертификата.

Удаление закешированного PIN-кода из файла.

Установка метки закрытого ключа. Для выполнения этой функции требуется авторизоваться на устройстве.

Вычисление цифровой подписи. Аргумент options принимает параметры подписи. Доступны следующие опции (в скобках указано значение по умолчанию):

• detached:bool (false) - генерировать отсоединенную подпись
• addUserCertificate:bool (true) - включить в подпись сертификат пользователя
• addSignTime:bool (false) - включить в подпись время подписи
• useHardwareHash:bool (false) - производить аппаратное хеширование данных на ключах ГОСТ
• rsaHashAlgorithm:enum - алгоритм хеширования при использовании ключей RSA, варианты: HASH_TYPE_MD5, HASH_TYPE_SHA1, HASH_TYPE_SHA256, HASH_TYPE_SHA512.
• CMS:string (empty) - уже сформированный CMS, в который требуется добавить подпись. Если в CMS подпись отсоединённая, то параметр data должен присутствовать и соответствовать данным, подпись которых находится в CMS, если в CMS подпись неотсоединённая, то параметр data должен быть пустым если CMS отсутствует, то будет создан новый CMS
• addSystemInfo:bool (false) - включать информацию о месте подписи. Tребует опции addSignTime == true.
  
  Добавляет в подписанные атрибуты ASN1 последовательность с OID 1.2.643.2.74.2.1.1.1. Внутри содержится поле типа INTEGER, обозначающее версию формата UTF8String строки.
  
  В случае невозможности получения значения какого-либо элемента информации о компьютере формат строки будет сохранен, а значение элемента пропущено.
  SEQUENCE {
    OBJECTIDENTIFIER 1.2.643.2.74.2.1.1.1
      SET {
        SEQUENCE {
          INTEGER 0x01 (1 decimal)
          UTF8String 'DateTime:[Дата и время];MachineId:[Уникальный идентификатор рабочей станции];OS:[Информация об ОС];Username:[Имя пользователя];IP-MAC:[adapter1-MAC] [adapter1-ipv4-1] [apdater1-ipv4-2] [apdater1-ipv6-1] [apdater1-ipv6-2], [apdater2-MAC] [adapter2-ipv4-1] [apdater2-ipv4-2] [apdater2-ipv6-1] [apdater2-ipv6-2]'
      }
    }
  }
  В элементе "IP-MAC" будут содержаться типы IPv4 и IPv6 адресов в следующем порядке: Unicast, Anycast и Multicast.

Проверка цифровой подписи. Аргумент options принимает параметры проверки подписи. Доступны следующие опции (в скобках указано значение по умолчанию):

• data:string (null) - подписанные данные (текстовые или base64-encoded), только в случае detached подписи;
• base64:bool (false) - указывает, закодированы ли данные, переданные в data, в base64;
• certificates:string[] (null) - набор сертификатов в PEM формате, на которых необходимо проверять подпись, при этом сертификаты, которые содержатся в cms, будут проигнорированы;
• CA:string[] (null) - список дополнительных корневых сертификатов в PEM формате для проверки сертификата, кроме них берутся сертификаты с устройства;
• CRL:string[] (null) - список отозванных сертификатов в PEM формате;
• useHardwareHash:bool (false) - производить хеширование на устройстве (игнорируется для алгоритмов отличных от ГОСТ Р 34.10-2001);
• verifyCertificate:bool (true) - проверить сертификат пользователя;