Подпись и проверка подписи

enableReverifyPINOnSignature

enableReverifyPINOnSignature(bool reverifyPIN)

Включить ввод PIN-кода с использованием графического интерфейса приложения JC-WebClient при подписании данных. Работает при любом состоянии аутентификации.

Аргументы:

• reverifyPIN – включать ли ввод PIN-кода.

signData

signData(int contID, array data, bool attachedSignature)

Подписать данные. Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• data – данные для подписи в виде массива байт.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

array – массив байт с подписью в формате PKCS#7.

signDataAsync

signDataAsync(int contID, array data, bool attachedSignature, bool useHardwareHash, JSObjectPtr callback)

Подписать данные, используя асинхронный механизм. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• data – данные для подписи в виде массива байт.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).
• useHardwareHash – использовать аппаратное хэширование (true - использовать).
• callback – callback-функция JavaScript, которая будет выполнена после вычисления подписи.

Результат:

array – массив байт с подписью в формате PKCS#7.

signBase64EncodedData

signBase64EncodedData(int contID, string data, bool attachedSignature)

Подписать данные. Выдает подпись в формате PKCS#7, закодированную в Base64. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• data – данные для подписи в виде строки, закодированной в Base64.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

string – подпись в формате PKCS#7, закодированная в Base64.

signBase64EncodedDataAsync

signBase64EncodedDataAsync(int contID, string data, bool attachedSignature, bool useHardwareHash, JSObjectPtr callback)

Подписать данные. Выдает подпись в формате PKCS#7, закодированную в Base64. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• data – данные для подписи в виде строки, закодированной в Base64.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).
• useHardwareHash – использовать аппаратное хэширование (true - использовать).
• callback – callback-функция JavaScript, которая будет выполнена после вычисления подписи.

Результат:

string – подпись в формате PKCS#7, закодированная в Base64.

signDataInFile

signDataInFile(int contID, string fileName, bool attachedSignature)

Подписать данные. Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• fileName – имя файла, содержимое которого требуется подписать.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

array – массив байт с подписью в формате PKCS#7.

signDataInFileBase64

signDataInFileBase64(int contID, string fileName, bool attachedSignature)

Подписать данные. Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• fileName – имя файла, содержимое которого требуется подписать.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

string – строка с подписью в формате PKCS#7, закодированная в Base64.

signDataUsingHardwareHash

signDataUsingHardwareHash(int contID, array data, bool attachedSignature)

Подписать данные с использованием аппаратного хеширования. Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState.

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• data – данные для подписи в виде массива байт.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

array – массив байт с подписью в формате PKCS#7.

signBase64EncodedDataUsingHardwareHash

signBase64EncodedDataUsingHardwareHash(int contID, string data, bool attachedSignature)

Подписать данные с использованием аппаратного хеширования. Выдает подпись в формате PKCS#7, закодированную в Base64. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• data – данные для подписи в виде строки, закодированной в Base64.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

string – строка с подписью в формате PKCS#7, закодированная в Base64.

signDataInFileUsingHardwareHash

signDataInFileUsingHardwareHash(int contID, string fileName, bool attachedSignature)

Подписать данные с использованием аппаратного хеширования. Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• fileName – имя файла, содержимое которого требуется подписать.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

string – строка с подписью в формате PKCS#7.

signDataInFileUsingHardwareHashBase64

signDataInFileUsingHardwareHashBase64(int contID, string fileName, bool attachedSignature)

Подписать данные с использованием аппаратного хеширования. Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID –

  идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

  Примечание

  Значение идентификатора контейнера не постоянно, но в рамках сессии не меняется.

• fileName – имя файла, содержимое которого требуется подписать.
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

string – строка с подписью в формате PKCS#7, закодированная в Base64.

signHash

signHash(int contID, array hash, bool attachedSignature)

Подписать данные без хэширования (т.е. подписать хэш). Выдает подпись в формате PKCS#7. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID – идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().
• hash – хэш в виде массива байт. Длина должна быть равна 32 байтам
• attachedSignature – включать ли данные в подпись PKCS#7 (true - включать).

Результат:

string – строка с подписью в формате PKCS#7. Строка закодирована в Base64.

verifyData

verifyData(array signature, bool attachedSignature, array data)

Проверить подпись PKCS#7. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – массив байт с подписью в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• data – данные, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае – пустой массив.

Результат:

bool – результат проверки.

verifyBase64EncodedData

verifyBase64EncodedData(string signature, bool attachedSignature, string data)

Проверить подпись PKCS#7. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – закодированная в Base64 подпись в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• data – закодированные в Base64 данные, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае пустая строка.

Результат:

bool – результат проверки.

verifyDataHW

verifyDataHW(array signature, bool attachedSignature, array data)

Проверить подпись PKCS#7, используя аппаратную реализацию проверки подписи. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – массив байт с подписью в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• data – данные, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае – пустой массив.

Результат:

bool – результат проверки.

verifyRawBase64EncodedData

verifyRawBase64EncodedData(int contId, string signature, string data)

Проверить подпись хэша. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• contID – идентификатор контейнера, содержащего публичный ключ, которым нужно выполнять проверку подписи.
• signature – закодированная в Base64 подпись (64 байта).
• data – закодированный в Base64 хэш данных (32 байта).

Результат:

bool – результат проверки.

verifyRawBase64EncodedDataEx

verifyRawBase64EncodedDataEx(int tokenDesc, int contId, string signature, string data)

Проверить подпись хэша. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• contID – идентификатор контейнера, содержащего публичный ключ, которым нужно выполнять проверку подписи.
• signature – закодированная в Base64 подпись (64 байта).
• data – закодированный в Base64 хэш данных (32 байта).

Результат:

bool – результат проверки.

verifyBase64EncodedDataHW

verifyBase64EncodedDataHW(string signature, bool attachedSignature, string data)

Проверить подпись PKCS#7, используя аппаратную реализацию проверки подписи. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – закодированная в Base64 подпись в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• data – закодированные в Base64 данные, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае – пустая строка.

Результат:

bool – результат проверки.

verifyDataHWUsingHardwareHash

verifyDataHWUsingHardwareHash(array signature, bool attachedSignature, array data)

Проверить подпись PKCS#7, используя аппаратную реализацию проверки подписи, с применением аппаратного хэширования. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – массив байт с подписью в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• data – данные, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае – пустой массив.

Результат:

bool – результат проверки.

verifyBase64EncodedDataHWUsingHardwareHash

verifyBase64EncodedDataHWUsingHardwareHash(string signature, bool attachedSignature, string data)

Проверить подпись PKCS#7, используя аппаратную реализацию проверки подписи, с применением аппаратного хэширования. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – закодированная в Base64 подпись в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• data – закодированные в base64 данные, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае пустая строка.

Результат:

bool – результат проверки.

verifyDataInFile

verifyDataInFile(array signature, bool attachedSignature, string fileName)

Проверить подпись PKCS#7. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• signature – массив байт с подписью в формате PKCS#7.
• attachedSignature – включает ли PKCS#7 подпись данные (true - включает).
• fileName – имя файла, если используется PKCS#7 отсоединённая подпись (detached signature). В противном случае – пустая строка.

Результат:

bool – результат проверки.

digest

digest(array data)

Посчитать программный хэш от данных, используя алгоритм GOST R 34.11. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• data – массив байт с данными для хэширования.

Результат:

array – результаты работы хэш-функции.

digestAsync

digestAsync(array data, JSObjectPtr callback)

Асинхронно посчитать программный хэш от данных, используя алгоритм GOST R 34.11. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• data – массив байт с данными для хэширования.
• callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода.

Результат:

array – результаты работы хэш-функции.

digestHardware

digestHardware(array data)

Посчитать аппаратный хэш от данных, используя алгоритм GOST R 34.11. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• data – массив байт с данными для хэширования.

Результат:

array – результаты работы хэш-функции.

digestHardwareAsync

digestHardwareAsync(array data, JSObjectPtr callback)

Асинхронно посчитать аппаратный хэш от данных, используя алгоритм GOST R 34.11. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• data – массив байт с данными для хэширования.
• callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода.

Результат:

array – результаты работы хэш-функции.

digestNoAuth

digestNoAuth(int tokenDesc, array data)

Посчитать программный хэш от данных, используя алгоритм GOST R 34.11. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• data – массив байт с данными для хэширования.

Результат:

array – результаты работы хэш-функции.

digestNoAuthAsync

digestNoAuthAsync(int tokenDesc, array data, JSObjectPtr callback)

Асинхронно посчитать программный хэш от данных, используя алгоритм GOST R 34.11. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• data – массив байт с данными для хэширования.
• callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода.

Результат:

array – результаты работы хэш-функции.

digestNoAuthHardware

digestNoAuthHardware(int tokenDesc, array data)

Посчитать аппаратный хэш от данных, используя алгоритм GOST R 34.11. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• data – массив байт с данными для хэширования.

Результат:

array – результаты работы хэш-функции.

digestNoAuthHardwareAsync

digestNoAuthHardwareAsync(int tokenDesc, array data, JSObjectPtr callback)

Асинхронно посчитать аппаратный хэш от данных, используя алгоритм GOST R 34.11. Работает при любом состоянии аутентификации. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• data – массив байт с данными для хэширования.
• callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода.

Результат:

array – результаты работы хэш-функции.