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

Материал из PayControl Wiki
Перейти к: навигация, поиск
Строка 1: Строка 1:
−
=Подготовка=
+
= Подготовка =
−
Для включения данной функции серверная часть PC '''должна быть обновлена''' до версии ''3.9.х'' или ''5.5.х''.
 
  
−
=Установка JCP=
+
Для включения данной функции серверная часть PC '''должна быть обновлена''' до версии ''3.9.х'' или ''5.5.х''. На версиях сервера ниже указанных имитовставка формироваться не будет.
−
* Нужно установить модуль WF - https://repo.paycontrol.org/cdn/artefacts/builder/wildfly_modules/modules/ru.cryptopro.jcp/
 
  
−
Имя модуля - ''ru.cryptopro.jcp''
+
= Установка модуля КриптоПро JCP =
  
−
Можно установить либо копированием всех загруженных по ссылке файлов в соответствующий путь(''wildfly/modules/ru/cryptopro/jcp/main''), либо через ''jboss-cli''.
+
== Добавление модуля в WildFly ==
  
 +
Можно установить двумя способами:
 +
* путём копирования загруженных файлов модуля и добавления описания модуля в файл конфигурации WildFly
 +
* с помощью ''jboss-cli''.
  
−
* В файл
+
Имя модуля - '''ru.cryptopro.jcp'''
  
−
''wildfly/standalone/configuration/standalone.xml''
+
Файлы модуля доступны по ссылке https://repo.paycontrol.org/cdn/artefacts/wildfly/wf-module-ru.cryptoro.jcp.zip
  
−
в тег
+
=== Путём ручного копирования ===
  
−
''subsystem xmlns="urn:jboss:domain:ee:[version]''
+
* Скопировать файлы из загруженного архива в ''wildfly/modules/ru/cryptopro/jcp/main''
−
 
+
* В файл <syntaxhighlight lang="text">wildfly/standalone/configuration/standalone.xml</syntaxhighlight>в тег<syntaxhighlight lang="text">subsystem xmlns="urn:jboss:domain:ee:[version]</syntaxhighlight> нужно добавить глобальную область видимости этого модуля путём добавления<syntaxhighlight lang="xml">
−
нужно добавить глобальную область видимости этого модуля путём тегов
 
−
 
 
−
<syntaxhighlight lang="xml">
 
 
<global-modules>
 
<global-modules>
 
   <module name="ru.cryptopro.jcp" slot="main"/>
 
   <module name="ru.cryptopro.jcp" slot="main"/>
 
</global-modules>
 
</global-modules>
−
</syntaxhighlight>
+
</syntaxhighlight>Пример секции:<syntaxhighlight lang="xml">
−
 
 
−
Пример секции:
 
−
<syntaxhighlight lang="xml">
 
 
<subsystem xmlns="urn:jboss:domain:ee:6.0">
 
<subsystem xmlns="urn:jboss:domain:ee:6.0">
 
<global-modules>
 
<global-modules>
Строка 35: Строка 30:
 
</subsystem>
 
</subsystem>
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
+
* В таблицу ''pc_sys_property'' внести настройку<syntaxhighlight lang="xml">
−
* В таблицу ''pc_sys_property'' внести настройку
 
−
<syntaxhighlight lang="xml">
 
 
-[ RECORD 1 ]-+-------------------
 
-[ RECORD 1 ]-+-------------------
 
setting_id    | ...
 
setting_id    | ...
Строка 43: Строка 36:
 
setting_value | CryptoPro JCP 2.0
 
setting_value | CryptoPro JCP 2.0
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
+
** Postgresql:<syntaxhighlight lang="sql">
−
Postgresql:
 
−
<syntaxhighlight lang="sql">
 
 
insert into pc_sys_property (setting_id, setting_name, setting_value) values (nextval('pc_setting_seq'), 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
 
insert into pc_sys_property (setting_id, setting_name, setting_value) values (nextval('pc_setting_seq'), 'GOST_IMIT_PROVIDER', 'CryptoPro JCP 2.0');
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
+
** Oracle:<syntaxhighlight lang="sql">
−
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>
 
</syntaxhighlight>
−
 
+
** MSSQL:<syntaxhighlight lang="sql">
−
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>
 
</syntaxhighlight>
  
−
=Создание директории=
+
== Создание временной директории ==
−
Cоздать директорию ''/var/opt/cprocsp/tmp'' и дать Wildfly права на запись в неё.
+
 
 +
Создать директорию ''/var/opt/cprocsp/tmp'' и дать Wildfly права на запись в неё.
 +
 
 
=Примечания=
 
=Примечания=
 
# Если не выполнить ''пункт 3'', то имитовставка вычисляться не будет
 
# Если не выполнить ''пункт 3'', то имитовставка вычисляться не будет
 
# При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет падать с ошибкой
 
# При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет падать с ошибкой
 
# Значение имитовставки есть в коллбэке рядом с подписью, а также в таблице ''pc_confirm_attempt'' (для PC 5.5 и выше - выводится через endpoint РКС - hex-строка)
 
# Значение имитовставки есть в коллбэке рядом с подписью, а также в таблице ''pc_confirm_attempt'' (для PC 5.5 и выше - выводится через endpoint РКС - hex-строка)

Версия 14:17, 28 сентября 2022

Подготовка

Для включения данной функции серверная часть PC должна быть обновлена до версии 3.9.х или 5.5.х. На версиях сервера ниже указанных имитовставка формироваться не будет.

Установка модуля КриптоПро 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>
  • В таблицу 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');

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

Создать директорию /var/opt/cprocsp/tmp и дать Wildfly права на запись в неё.

Примечания

  1. Если не выполнить пункт 3, то имитовставка вычисляться не будет
  2. При неправильной установке модуля и конфигурации области его видимости подтверждение транзакций будет падать с ошибкой
  3. Значение имитовставки есть в коллбэке рядом с подписью, а также в таблице pc_confirm_attempt (для PC 5.5 и выше - выводится через endpoint РКС - hex-строка)
Источник — «https://repo.paycontrol.org/wiki/index.php?title=Включение_формирования_имитовставки&oldid=678»