Текущая версия на 12:28, 2 мая 2023

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

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

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

Содержание

1 Обновление модулей сервера PC
2 Модификация окружения сервера PC
- 2.1 Docker
- 2.2 ОС
  - 2.2.1 Установка модуля КриптоПро JCP
    - 2.2.1.1 Добавление модуля в WildFly
      - 2.2.1.1.1 Путём ручного копирования
  - 2.2.2 Создание временной директории для Linux
3 Включение формирования имитовставки в 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');

@@ Строка 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 ====
 Можно установить двумя способами:
 * путём копирования загруженных файлов модуля и добавления описания модуля в файл конфигурации WildFly
-* с помощью ''jboss-cli''.
+* с помощью ''jboss-cli'' - [https://www.mastertheboss.com/jbossas/jboss-script/installing-a-jboss-as-7-module-using-the-cli/ ссылка на инструкцию] по установке модулей.
 Имя модуля - '''ru.cryptopro.jcp'''
@@ Строка 15: / Строка 31: @@
 Файлы модуля доступны по ссылке https://repo.paycontrol.org/cdn/artefacts/wildfly/wf-module-ru.cryptoro.jcp.zip
-=== Путём ручного копирования ===
+{{Уведомление|При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет завершаться с ошибкой.}}
+===== Путём ручного копирования =====
 * Скопировать файлы из загруженного архива в ''wildfly/modules/ru/cryptopro/jcp/main''
@@ Строка 30: / Строка 48: @@
 </subsystem>
 </syntaxhighlight>
-* В таблицу ''pc_sys_property'' внести настройку<syntaxhighlight lang="xml">
+=== Создание временной директории для Linux ===
+Необходимо создать "временную" директорию ''/var/opt/cprocsp/tmp'' с правом сервиса Wildfly на запись в неё.
+= Включение формирования имитовставки в PC =
+В таблицу ''pc_sys_property'' внести настройку<syntaxhighlight lang="xml">
 -[ RECORD 1 ]-+-------------------
 setting_id    | ...
@@ Строка 40: / Строка 65: @@
 </syntaxhighlight>
 ** Oracle:<syntaxhighlight lang="sql">
-insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, ‘GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
+insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
 </syntaxhighlight>
 ** MSSQL:<syntaxhighlight lang="sql">
-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>
-== Создание временной директории ==
-Создать директорию ''/var/opt/cprocsp/tmp'' и дать Wildfly права на запись в неё.
-=Примечания=
-# Если не выполнить ''пункт 3'', то имитовставка вычисляться не будет
-# При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет падать с ошибкой
-# Значение имитовставки есть в коллбэке рядом с подписью, а также в таблице ''pc_confirm_attempt'' (для PC 5.5 и выше - выводится через endpoint РКС - hex-строка)

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

Текущая версия на 12:28, 2 мая 2023

Содержание

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

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

Docker

ОС

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

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

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

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

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

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты