Методы для работы с Антифрод-терминалом и технологией SWYX¶

Методы для работы с Антифрод-терминалом и технологией SWYX¶

bool true если ридер поддерживает SWYX-функционал.

enroll ¶

Получить значение открытого ключа Антифрод-терминала.

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

array – открытый ключ в виде массива байт.

  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

performPersonalization ¶

Сгенерировать новую ключевую пару на Антифрод-терминале.

Метод должен выполняться только в случае первичной или повторной инициализации терминала на специализированном АРМе. Операция может занимать до 20 сек. Для получения открытого ключа персонализированного ранее терминала используется метод enroll() .

  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens() . Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
  • CKR_FUNCTION_REJECTED – пользователь нажал отмена.
  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

performPersonalizationAsync ¶

Сгенерировать новую ключевую пару на Антифрод-терминале, используя асинхронный механизм.

Метод должен выполняться только в случае первичной или повторной инициализации терминала на специализированном АРМе. Операция может занимать до 20 сек. Для получения открытого ключа персонализированного ранее терминала используется метод enroll() .

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

getReaderAppletSerialNumber ¶

Получить серийный номер чипа, интегрированного в Антифрод-терминал.

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

array – серийный номер чипа в виде набора байт.

  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

swyxStart ¶

Начать работу в SWYX-режиме.

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

swyxStop ¶

Закончить работу в SWYX-режиме.

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

array – массив байт, содержащий лог операций, выполненных на терминале, в формате: [xml] + [значение подписи (64 байта)] .

  • CKR_GENERAL_ERROR – SWYX-режим не был предварительно включен.
  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

swyxStopAsync ¶

Закончить работу в SWYX-режиме, используя асинхронный механизм.

  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens() . Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
  • callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода. В случае ошибки или отмены операции в функцию будет переданы Error и код ошибки, в случае успеха - массив байт, содержащий лог операций, выполненных на терминале, в формате: [xml] + [значение подписи (64 байта)] .
  • СKR_GENERAL_ERROR – SWYX-режим не был предварительно включен
  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

swyxDisplay ¶

Отобразить текст на экране Антифрод-терминала и предложить пользователю его подписать.

С помощью клавиатуры Антифрод-терминала пользователю даётся возможность подтвердить или отменить операцию. Метод не выполняет операцию подписания.

  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens() . Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
  • timeout – тайм-аут подтверждения в 5-секундных долях (одна единица - пять секунд). 0 - ожидать бесконечно.
  • message – текст для отображения на экране Антифрод-терминала, ожидается от 7 до 1600 байт кодировке UTF8, но не более 400 символов.
  • CKR_FUNCTION_CANCELED – тайм-аут операции.
  • CKR_FUNCTION_REJECTED – пользователь нажал отмена.
  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

swyxDisplayAsync ¶

Отобразить текст на экране Антифрод-терминала и предложить пользователю его подписать. Операция выполняется, используя асинхронный механизм.

С помощью клавиатуры Антифрод-терминала пользователю дается возможность подтвердить или отменить операцию. Метод не выполняет операцию подписания.

  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens() . Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
  • message – текст для отображения на экране Антифрод-терминала, ожидается от 7 до 1600 байт кодировке UTF8, но не более 400 символов.
  • timeout – тайм-аут подтверждения текста на экране Антифрод-терминала в 5-секундных долях (одна единица - пять секунд). 0 - ожидать бесконечно.
  • callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода. В случае ошибки или отмены операции в функцию будет переданы Error и код ошибки, в случае успеха - 0.
  • CKR_FUNCTION_CANCELED – тайм-аут операции.
  • CKR_FUNCTION_REJECTED – пользователь нажал отмена.
  • СKR_ARGUMENTS_BAD – ошибка в аргументах функции.
  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

swyxSign ¶

Визуализировать и подписать данные, используя Антифрод-терминал.

Метод выполняет следующую последовательность действий:

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

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

array – массив из двух элементов:

  • Массив с подписью данных.
  • Массив байт в формате [xml][значение подписи (64 байта)] .
  • CKR_FUNCTION_CANCELED – тайм-аут операции подписи или ввода PIN-кода.
  • CKR_FUNCTION_REJECTED – пользователь нажал отмена при подтверждении подписи или при вводе ПИН-кода.
  • CKR_PIN_LEN_RANGE – пользователь ввёл слишком короткий или слишком длинный PIN-код.
  • CKR_PIN_INCORRECT – пользователь ввёл неверный PIN-код.
  • CKR_FUNCTION_FAILED – вероятная причина: неправильно указан идентификатор электронного ключа.

swyxSignAsync ¶

Визуализировать и подписать данные, используя Антифрод-терминал.

Метод асинхронно выполняет следующую последовательность действий:

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

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

📎📎📎📎📎📎📎📎📎📎