Включение формирования имитовставки — различия между версиями

Материал из PayControl Wiki
Перейти к: навигация, поиск
(→‎Добавление модуля в WildFly)
Строка 1: Строка 1:
−
= Подготовка =
+
Значение имитовставки будет возвращаться в коллбэке и информации о подтверждённой транзакции в HEX-кодировке в поле <code>gost_imit</code>.
  
−
Для включения данной функции серверная часть PC '''должна быть обновлена''' до версии ''3.9.х'' или ''5.5.х''. На версиях сервера ниже указанных имитовставка формироваться не будет.
+
Для включения необходимо:
  
−
= Установка модуля КриптоПро JCP =
+
* обновить модули сервера PC,
 +
* модифицировать окружение сервера PC,
 +
* включить формирование имитовставки в PC.
  
−
== Добавление модуля в WildFly ==
+
= Обновление модулей сервера PC =
 +
 
 +
Поддержка формирования имитовставки добавлена с версий ''3.9.х'' и ''5.5.х''. Необходимо обновить модули сервера до версий не ниже указанных. Перед обновлением серверных компонентов необходимо убедиться, что конечные пользователи используют мобильные приложения, в которых версия SDK в первых двух разрядах не ниже версии сервера (например, при обновлении сервера на 5.5, версии SDK мобильных приложений должны быть не ниже 5.5).
 +
 
 +
= Модификация окружения сервера PC =
 +
 
 +
== Docker ==
 +
 
 +
Необходимо загрузить и использовать свежий [https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#образы образ] (не старше чем от 08 декабря 2022 г.).
 +
 
 +
== ОС ==
 +
 
 +
=== Установка модуля КриптоПро JCP ===
 +
 
 +
==== Добавление модуля в WildFly ====
  
 
Можно установить двумя способами:
 
Можно установить двумя способами:
Строка 15: Строка 31:
 
Файлы модуля доступны по ссылке https://repo.paycontrol.org/cdn/artefacts/wildfly/wf-module-ru.cryptoro.jcp.zip
 
Файлы модуля доступны по ссылке https://repo.paycontrol.org/cdn/artefacts/wildfly/wf-module-ru.cryptoro.jcp.zip
  
−
=== Путём ручного копирования ===
+
{{Уведомление|При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет завершаться с ошибкой.}}
 +
 
 +
===== Путём ручного копирования =====
  
 
* Скопировать файлы из загруженного архива в ''wildfly/modules/ru/cryptopro/jcp/main''
 
* Скопировать файлы из загруженного архива в ''wildfly/modules/ru/cryptopro/jcp/main''
Строка 30: Строка 48:
 
</subsystem>
 
</subsystem>
 
</syntaxhighlight>
 
</syntaxhighlight>
−
* В таблицу ''pc_sys_property'' внести настройку<syntaxhighlight lang="xml">
+
 
 +
=== Создание временной директории ===
 +
 
 +
Необходимо создать "временную" директорию ''/var/opt/cprocsp/tmp'' с правом сервиса Wildfly на запись в неё.
 +
 
 +
= Включение формирования имитовставки в PC =
 +
 
 +
В таблицу ''pc_sys_property'' внести настройку<syntaxhighlight lang="xml">
 
-[ RECORD 1 ]-+-------------------
 
-[ RECORD 1 ]-+-------------------
 
setting_id    | ...
 
setting_id    | ...
Строка 45: Строка 70:
 
insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
 
insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
−
== Создание временной директории ==
 
−
 
−
Создать директорию ''/var/opt/cprocsp/tmp'' и дать Wildfly права на запись в неё.
 
−
 
−
=Примечания=
 
−
# Если не выполнить ''пункт 3'', то имитовставка вычисляться не будет
 
−
# При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет падать с ошибкой
 
−
# Значение имитовставки есть в коллбэке рядом с подписью, а также в таблице ''pc_confirm_attempt'' (для PC 5.5 и выше - выводится через endpoint РКС - hex-строка)
 

Версия 16:17, 24 апреля 2023

Значение имитовставки будет возвращаться в коллбэке и информации о подтверждённой транзакции в 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>

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

Необходимо создать "временную" директорию /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');
Источник — «https://repo.paycontrol.org/wiki/index.php?title=Включение_формирования_имитовставки&oldid=754»