Сервис виртуальных карт разворачивается как отдельный от системы "Corporate" сервис в отдельном защищенном сегменте сети.
За работу сервиса отвечает набор модулей card-info, находящийся в архиве box.zip
.
Для работы сервиса виртуальных карт необходимы следующие компоненты:
app.war
с модулями card-info;
sbns-web.war
;
api.war
.
sbns-web.war
нужен для администрирования сервиса карт. Он используется только для администрирования, клиентами банка при работе с сервисом карт не используется.
api.war
располагается в DMZ и используется клиентами банка.
При развертывании сервиса виртуальных карт необходимо помнить о том, что в процессе работы данный сервис взаимодействует с "Corporate" через API,
т. е. сервер с app-частью сервиса карт должен иметь возможность связаться с web-частью "Corporate" (с api.war
).
Схема развертывания следующая:
Ниже рассмотрен пример развертывания сервиса карт. Имеется развернутый по адресу "http://corporate.example"
стенд "Corporate". Сервис
виртуальных карт будет развернут по адресу "http://card-info.example"
.
Авторизуйтесь на банковской части "Corporate".
Добавьте нового клиента OAuth если он не был добавлен ранее.
Это необходимо потому, что сервис карт использует "Corporate" в качестве провайдера OAuth 2.0.
Для добавления записи о новом клиенте OAuth выберите пункт Администрирование системы → Управление OAUTH → Клиенты OAUTH главного меню.
Для рассматриваемого примера будут следующие значения:
Идентификатор клиента и Секрет клиента будут сгенерированы автоматически. Они понадобятся при настройке провайдера OAuth на сервисе карт.
Наименование клиента может быть любым.
Код клиента должен соответствовать CardInfoService.
В качестве Обратного URL необходимо указать точку входа в сервис карт.
Для данного примера это "http://card-info.example/api/v1/cards/auth/iframe"
. Часть "/api/v1/cards/auth/iframe"
URL
всегда одинаковая. Меняется только часть card-info.example
, она зависит от адреса, на котором развернут сервис карт.
На этом этапе работа в "Corporate" закончена.
Выполните настройку сервиса карт. Для этого авторизуйтесь в сервисе карт через интерфейс, предоставляемый sbns-web.war
.
Первый вход на пустой базе возможен с любой парой имя пользователя / пароль. Фактический вход будет выполнен с ролью initial_user. Под данной ролью необходимо создать нового пользователя с ролью Суперпользователь. От имени суперпользователя будет выполняться дальнейшая настройка.
Выполните вход в сервис карт под ролью Суперпользователь.
Добавьте провайдера. Для этого перейдите к пункту Администрирование системы → Управление OAUTH → Сервисы OAUTH главного меню системы.
Для рассматриваемого примера будут следующие значения:
Идентификатор клиента и Секрет клиента должны соответствовать указанным на стороне "Corporate" при создании клиента OAuth.
Заполните адрес сервиса авторизации и адрес точки входа в сервис – изначально они пустые.
В данном примере адрес сервиса авторизации – "http://corporate.example/api/v1/oauth"
; адрес точки входа в сервис –
"http://corporate.example/api"
. corporate.example
– изменяемая часть, зависит от адреса "Corporate".
Список точек входа указывать не требуется, т. к. пользователь не использует интерфейс для входа в сервис карт.
Настройте один интеграционный шлюз. Шлюз настраивается аналогично тому, как настраиваются шлюзы в "Corporate".