Просмотр исходного текста страницы PayControl3.x Внесение настроек по умолчанию

'''Сервер PayControl''' это совокупность нескольких серверов:
* '''PayControl Server (PCS)''' – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с [[Прикладная система|прикладной системой]] (например, BSS Корректс, iSimple и т.д.). Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* '''PayControl Interaction Server Internal (PCIS Internal)''' – сервер для отправки [[Push-уведомления|Push уведомлений]] о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Серверу требуется доступ к серверам Google и Apple.
* '''PayControl Interaction Server External (PCIS External)'''. С этим сервером взаимодействуют приложения на мобильных устройствах для получении информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.

=Варианты включения в инфраструктуру=
Допустимо объединение серверов PCIS на одной машине при выполнении условий
* на входе извне будет установлен фильтр HTTP-запросов, обеспечивающий:
** доступность снаружи только адреса ''<IP или имя сервера>/PayControl-interaction-rest/''
**доступность адреса ''<IP или имя сервера>/wsis/PayControlInteractionService?wsdl'' только изнутри. 
* при использовании TLS, фильтр HTTP-запросов должен обладать функцией терминирования TLS.

=Параметры настройки=
==PCS==
===Параметры системы===
Настройки сервера PCS устанавливаются в [[База данных PayControl#pc_sys_property|БД PCS, таблица pc_sys_property]], путём добавления/изменения записей. Запись состоит из setting_name и setting_value. Возможные значения setting_name:
{| class="wikitable"
!setting_name!!Тип!!По умолчанию!!Описание
|-
|REPORT_TEMPLATE || string || || Путь к шаблону отчёта.
|-
|KILT || long || 365 ||Время жизни ключевой информации пользователя (в днях). Сокращение от "KEY_INFO_LIFE_TIME".
|-
|BILL_PERIOD || long || 365 ||Период [[Биллинг|биллинга]] (в днях).
|-
|DEBUG_INFO || long || 0 || Выводить отладочную информацию (0 – не выводить, 1 - выводить).
|-
|CRYPTO_PROVIDER || string || BC || Криптопровайдер. Устаревший параметр. Значение только "BC" (сокращение от [[wikipedia:ru:Bouncy Castle|Bouncy Castle]])
|-
|T_AUTH_CODE || long || 180 || Интервал дескритизации для кода аутентификации (auth_code) (в секундах).
|-
|T_CONFIRM_CODE || long || 180 || Интервал дескритизации для кода подтверждения (в секундах).
|-
|KEY_QR_SIZE || long || 300 || Размер [[QR-код|QR-кода]] ключа (в пикселях).
|-
|TRANSACTION_QR_SIZE || long || 300 || Размер [[QR-код|QR-кода]] транзакции (в пикселях).
|-
|CLEAN_TRANSACTION || long || 1 || Очищать данные транзакции после подтверждения.
|-
|DEFAULT_TRANSACTION_TTL || long || 0 || Время жизни транзакций по умолчанию в секундах. 0 – без ограничений.
|-
|COLLECT_EVENTS || long || 0 || Включает сбор информации о событиях для сервера.
|-
|COLLECT_DEVICE_INFORMATION || long || 0 || Включает сбор информации об устройстве для сервера.
|-
|CHECK_HTTP_AUTH_HEADER || long || 1 || Включает проверку аутентификации HTTP запросов от МП по значению, передаваемому в HTTP заголовке.
|-
|IOS_PUSH_PAYLOAD_TEMPLATE|| string || || Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для iOS. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|ANDROID_PUSH_PAYLOAD_TEMPLATE|| string || ||Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для Android. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|}
====Примеры запросов для изменения параметров====
=====PostgreSQL=====
Добавление значения с помощью SQL-запроса (После выполнения запроса требуется перезапуск службы):<syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'COLLECT_EVENTS', '1');</syntaxhighlight>
Изменение значения для включения расширенного логирования с помощью SQL-запроса (После выполнения запроса требуется перезапуск службы):<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

=====Oracle=====
<syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'COLLECT_EVENTS', '1');</syntaxhighlight>
=====MS SQL=====
<syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'COLLECT_EVENTS', '1');</syntaxhighlight>

==PCIS Internal==
===Параметры системы===
Настройки сервера PCIS устанавливаются в [[База данных PayControl#PCIS Internal|БД PCIS, таблица pc_sys_property]], путём добавления/изменения записей. Запись состоит из setting_name и setting_value. Возможные значения setting_name:
{| class="wikitable"
!setting_name!!Тип!!По умолчанию!!Описание
|-
|DEBUG_INFO || long || 0 || Выводить отладочную информацию (0 – не выводить, 1 - выводить).
|-
|GOOGLE_SERVER_KEY || string ||  || Ключ для аутентификации на серверах Google FCM при отправке [[Push-сообщения|push-сообщений]]
|-
|IOS_KS_PATH || string ||  || Путь к ключевому файлу в формате pkcs-12. Ключ в этом контейнере используется для аутентификации на APNS при отправке [[Push-сообщения|push-сообщений]]
|-
|IOS_KS_PASSWORD || string ||  || Пароль к ключевому файлу, заданному в IOS_KS_PATH
|-
|IOS_PUSH_PAYLOAD_TEMPLATE|| string || || Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для iOS. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|ANDROID_PUSH_PAYLOAD_TEMPLATE|| string || ||Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для Android. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|PROXY_HOST || string ||  || Адрес прокси-сервера
|-
|PROXY_PORT || long || 0 || Порт прокси-сервера
|-
|PROXY_USERNAME || string ||  || Имя учётной записи для аутентификации на прокси-сервере
|-
|PROXY_PASSWORD || string ||  || Пароль учётной записи для аутентификации на прокси-сервере
|-
|}