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

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 – результаты работы хэш-функции.

Оглавление