Руководство администратора PayControl v3 - История изменений

D.bizyukov: /* Изменение записи */

2026-07-07T18:58:50Z

Изменение записи

← Предыдущая версия		Версия от 18:58, 7 июля 2026
Строка 71:		Строка 71:

	===== Изменение записи =====		===== Изменение записи =====
	Пример SQL запроса для изменения записи (для всех перечисленных СУБД):		Пример SQL-запроса для изменения записи (для всех перечисленных СУБД):
	<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>		<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

D.bizyukov: /* Вывод отладочной информации */

2026-07-07T18:58:32Z

Вывод отладочной информации

← Предыдущая версия		Версия от 18:58, 7 июля 2026
Строка 58:		Строка 58:


	Примеры SQL запросов добавления записи для разных СУБД:		Примеры SQL-запросов добавления записи для разных СУБД:

	{\| class="wikitable"		{\| class="wikitable"

D.bizyukov: /* Вывод содержимого SOAP-запросов и ответов */

2026-07-07T18:56:41Z

Вывод содержимого SOAP-запросов и ответов

← Предыдущая версия		Версия от 18:56, 7 июля 2026
Строка 77:		Строка 77:
	{{Предупреждение\|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}		{{Предупреждение\|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
	Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:		Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
	# Добавить после блока <extensions> ... </extensions> в файл		# Добавить после блока <code><nowiki><extensions> ... </extensions></nowiki></code> в файл
	#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>		#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
	#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>		#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>

D.bizyukov: /* Включение вывода информационных данных работы PayControl */

2026-07-07T18:55:34Z

Включение вывода информационных данных работы PayControl

← Предыдущая версия		Версия от 18:55, 7 июля 2026
Строка 48:		Строка 48:

	== Включение вывода информационных данных работы PayControl ==		== Включение вывода информационных данных работы PayControl ==
	В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера ~~PayСоntrol~~.		В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayControl.
	=== Для PCS и PCIS Internal ===		=== Для PCS и PCIS Internal ===
	==== Вывод отладочной информации ====		==== Вывод отладочной информации ====

D.bizyukov в 18:54, 7 июля 2026

2026-07-07T18:54:14Z

← Предыдущая версия		Версия от 18:54, 7 июля 2026
Строка 18:		Строка 18:
	\|}		\|}

	= Запуск и остановка служб ~~сервера PayControl~~ =		= Запуск и остановка служб =
	== Linux ==		== Linux ==
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">

D.bizyukov в 18:50, 7 июля 2026

2026-07-07T18:50:26Z

← Предыдущая версия		Версия от 18:50, 7 июля 2026
Строка 1:		Строка 1:
	=~~Введение~~=		= Назначение документа =
	PayControl – программный комплекс~~, предназначенный~~ для подтверждения пользователем операций в системах дистанционного банковского обслуживания и~~/или~~ электронного документооборота.		Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

	~~PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по~~ сравнению с ~~такими способами подтверждения как~~ SMS, ~~одноразовые пароли~~ (~~One-Time Password~~), скретч-~~карты,~~ MAC-~~токены~~ и пр.		= О продукте =
			PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

	При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.		= Общее описание =
	~~=Назначение=~~
	Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
	=Общее описание=
	Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:		Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

Строка 35:		Строка 33:
	</syntaxhighlight>		</syntaxhighlight>

	=Журналирование=		= Журналирование =
	== Расположение журналов ==		== Расположение журналов ==
	События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.		События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.
Строка 49:		Строка 47:
	Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.		Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

	==Включение вывода информационных данных работы PayControl==		== Включение вывода информационных данных работы PayControl ==
	В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.		В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
	===Для PCS и PCIS Internal===		=== Для PCS и PCIS Internal ===
	====Вывод отладочной информации====		==== Вывод отладочной информации ====
	Для включения вывода отладочной информации необходимо:		Для включения вывода отладочной информации необходимо:
	# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:		# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
Строка 72:		Строка 70:
	\|}		\|}

	=====Изменение записи=====		===== Изменение записи =====
	Пример SQL запроса для изменения записи (для всех перечисленных СУБД):		Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
	<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>		<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

	====Вывод содержимого SOAP-запросов и ответов====		==== Вывод содержимого SOAP-запросов и ответов ====
	{{Предупреждение\|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}		{{Предупреждение\|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
	Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:		Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
Строка 89:		Строка 87:
	# Перезапустить службу wildfly.		# Перезапустить службу wildfly.

	===PCIS External (с версии 3.6)===		=== PCIS External (с версии 3.6) ===
	Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.		Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Строка 99:		Строка 97:
	Затем перезапустите службу wildfly.		Затем перезапустите службу wildfly.

	=Отправка информации о событиях=		= Отправка информации о событиях =
	Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.		Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
	<syntaxhighlight lang="sql">		<syntaxhighlight lang="sql">
Строка 109:		Строка 107:
	{{Предупреждение\|Для сбора информации о событиях при создании ключа должен быть установлен флаг сбора информации о событиях, а для передачи данных об устройстве — дополнительно флаг сбора информации об устройстве. Подробнее — в описании API сервера.}}		{{Предупреждение\|Для сбора информации о событиях при создании ключа должен быть установлен флаг сбора информации о событиях, а для передачи данных об устройстве — дополнительно флаг сбора информации об устройстве. Подробнее — в описании API сервера.}}

	=Установка лицензии=		= Установка лицензии =
	Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.		Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

Строка 119:		Строка 117:
	</pre>		</pre>

	==Запросом к БД==		== Запросом к БД ==
	Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:		Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
	* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>		* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
	* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>		* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

	==Добавлением файла лицензии==		== Добавлением файла лицензии ==
	Скопируйте файл лицензии на сервер PCS:		Скопируйте файл лицензии на сервер PCS:
	* Linux — в <code>/opt/wildfly/</code>;		* Linux — в <code>/opt/wildfly/</code>;

D.bizyukov: /* Отправка информации о событиях */

2026-07-07T18:48:07Z

Отправка информации о событиях

← Предыдущая версия		Версия от 18:48, 7 июля 2026
Строка 100:		Строка 100:

	=Отправка информации о событиях=		=Отправка информации о событиях=
	Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения ~~или~~ SDK ~~PayControl~~ с сервером PayControl ~~устанавливается~~ в БД PCS, таблица pc_system, поле events_post_url.		Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
	<syntaxhighlight lang="sql">		<syntaxhighlight lang="sql">
	update pc_system set events_post_url='http://example.com/pc_events_reciever';		update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
	</syntaxhighlight>		</syntaxhighlight>
	После ~~этого нужно перезапустить~~ WildFly PCS для ~~применения изменений~~.
			После изменения перезапустите WildFly PCS.

			{{Предупреждение\|Для сбора информации о событиях при создании ключа должен быть установлен флаг сбора информации о событиях, а для передачи данных об устройстве — дополнительно флаг сбора информации об устройстве. Подробнее — в описании API сервера.}}

	{{Предупреждение\|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
	=Установка лицензии=		=Установка лицензии=
	Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.		Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

D.bizyukov: /* Запуск и остановка служб сервера PayControl */

2026-07-07T18:44:18Z

Запуск и остановка служб сервера PayControl

← Предыдущая версия		Версия от 18:44, 7 июля 2026
Строка 20:		Строка 20:
	\|}		\|}

	=Запуск и остановка служб сервера PayControl=		= Запуск и остановка служб сервера PayControl =
	==Linux==		== Linux ==
	~~Запуск:~~
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	systemctl start wildfly.service		systemctl start wildfly.service # запуск
			systemctl stop wildfly.service # остановка
			systemctl restart wildfly.service # перезапуск
	</syntaxhighlight>		</syntaxhighlight>
	~~Остановка:~~
	~~<syntaxhighlight lang="bash">~~		== Windows ==
	~~systemctl stop wildfly.service~~		Через консоль управления службами (''services.msc'') либо из командной строки:
	~~</syntaxhighlight>~~
	~~Перезапуск:~~
	~~<syntaxhighlight lang="bash">~~
	~~systemctl restart wildfly.service~~
	~~</syntaxhighlight>~~
	==Windows==
	~~===Из графического интерфейса===~~
	~~Запуск, остановка и перезапуск службы осуществляется из консоли~~ управления службами ~~сервером~~ (~~консоль~~ services.msc).
	~~===С помощью~~ командной строки~~===~~
	~~Запуск~~:
	<syntaxhighlight lang="bat">		<syntaxhighlight lang="bat">
	net start wildfly		net start wildfly
	~~</syntaxhighlight>~~
	~~Остановка:~~
	~~<syntaxhighlight lang="bat">~~
	net stop wildfly		net stop wildfly
	</syntaxhighlight>		</syntaxhighlight>

	=Журналирование=		=Журналирование=
	== Расположение журналов ==		== Расположение журналов ==

D.bizyukov: /* Общее описание */

2026-07-07T18:42:34Z

Общее описание

← Предыдущая версия		Версия от 18:42, 7 июля 2026
Строка 8:		Строка 8:
	Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.		Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
	=Общее описание=		=Общее описание=
	Сервер PayControl ~~функционирует~~ на базе сервера приложений [[Wildfly]] ~~выполняющегося~~ в среде Java 8 и состоит из ~~следующих частей~~:		Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:
	* PayControl Server (PCS) ~~– основной~~ сервер ~~PayControl. Располагается внутри локальной сети~~. Взаимодействует с прикладной системой~~. Хранит~~ данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
	* PayControl Interaction Server ~~Internal (PCIS~~ Internal) ~~– сервер для отправки~~ Push ~~уведомлений~~ о появлении неподтверждённой транзакции ~~у пользователя~~ (без ~~содержания информации~~ о транзакции). Как правило ~~располагается в~~ DMZ-~~зоне~~, ~~имеющей доступ к сети~~ Интернет~~. Требуется~~ доступ к серверам Google и Apple. Может ~~быть размещён в т.ч.~~ на одном сервере с PCS или PCIS ~~Extrnal (~~в зависимости от требований ИБ ~~к ИТ инфраструктуре Банка~~ и ~~функциональных~~ возможностей ИТ инфраструктуры ~~Банка)~~.		{\| class="wikitable"
	* PayControl Interaction Server ~~External (PCIS~~ External)~~. С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных~~ платежа ~~и отправки результатов~~ подтверждения транзакций. ~~Располагается в~~ DMZ-~~зоне~~ с доступом извне~~. Должен иметь~~ внешний фиксированный IP-адрес. ~~При необходимости использования~~ TLS~~, должно быть присвоено~~ доменное имя и ~~выпущен~~ сертификат ~~внешним~~ УЦ.		! Компонент !! Назначение !! Расположение и требования
			\|-
			\| '''PayControl Server (PCS)''' \|\| Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. \|\| Локальная сеть.
			\|-
			\| '''PCIS Internal''' (PayControl Interaction Server Internal) \|\| Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). \|\| Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
			\|-
			\| '''PCIS External''' (PayControl Interaction Server External) \|\| Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. \|\| DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
			\|}

	=Запуск и остановка служб сервера PayControl=		=Запуск и остановка служб сервера PayControl=

D.bizyukov: /* Общее описание */

2026-07-07T18:35:47Z

Общее описание

← Предыдущая версия		Версия от 18:35, 7 июля 2026
Строка 8:		Строка 8:
	Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.		Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
	=Общее описание=		=Общее описание=
	Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] ~~выполняющейся~~ в среде Java 8 и состоит из следующих частей:		Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющегося в среде Java 8 и состоит из следующих частей:
	* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.		* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
	* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).		* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
	* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.		* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.

	=Запуск и остановка служб сервера PayControl=		=Запуск и остановка служб сервера PayControl=
	==Linux==		==Linux==