Включение формирования имитовставки

Значение имитовставки будет возвращаться в коллбэке и информации о подтверждённой транзакции в HEX-кодировке в поле gost_imit.

Для включения необходимо:

• обновить модули сервера PC,
• модифицировать окружение сервера PC,
• включить формирование имитовставки в PC.

Обновление модулей сервера PC

Поддержка формирования имитовставки добавлена с версий 3.9.х и 5.5.х. Необходимо обновить модули сервера до версий не ниже указанных. Перед обновлением серверных компонентов необходимо убедиться, что конечные пользователи используют мобильные приложения, в которых версия SDK в первых двух разрядах не ниже версии сервера (например, при обновлении сервера на 5.5, версии SDK мобильных приложений должны быть не ниже 5.5).

Модификация окружения сервера PC

Docker

Необходимо загрузить и использовать свежий образ (не старше чем от 08 декабря 2022 г.).

ОС

Установка модуля КриптоПро JCP

Добавление модуля в WildFly

Можно установить двумя способами:

• путём копирования загруженных файлов модуля и добавления описания модуля в файл конфигурации WildFly
• с помощью jboss-cli - ссылка на инструкцию по установке модулей.

Имя модуля - ru.cryptopro.jcp

Файлы модуля доступны по ссылке https://repo.paycontrol.org/cdn/artefacts/wildfly/wf-module-ru.cryptoro.jcp.zip

Уведомление. При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет завершаться с ошибкой.

Путём ручного копирования

• Скопировать файлы из загруженного архива в wildfly/modules/ru/cryptopro/jcp/main
• В файл

  wildfly/standalone/configuration/standalone.xml
  

  в тег

  subsystem xmlns="urn:jboss:domain:ee:[version]
  

  нужно добавить глобальную область видимости этого модуля путём добавления

  <global-modules>
     <module name="ru.cryptopro.jcp" slot="main"/>
  </global-modules>
  

  Пример секции:

  <subsystem xmlns="urn:jboss:domain:ee:6.0">
  	<global-modules>
  		<module name="ru.cryptopro.jcp" slot="main"/>
  	</global-modules>
  	...
  </subsystem>
  

Создание временной директории для Linux

Необходимо создать "временную" директорию /var/opt/cprocsp/tmp с правом сервиса Wildfly на запись в неё.

Включение формирования имитовставки в PC

В таблицу pc_sys_property внести настройку

-[ RECORD 1 ]-+-------------------
setting_id    | ...
setting_name  | GOST_IMIT_PROVIDER
setting_value | CryptoPro JCP 2.0

• • Postgresql:

    insert into pc_sys_property (setting_id, setting_name, setting_value) values (nextval('pc_setting_seq'), 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
    

  • Oracle:

    insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
    

  • MSSQL:

    insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');