Описание технологии взаимодействие систем

Описание технологии взаимодействие систем

Используемые технологии

Сервисы интеграции с внешними системами  реализуются в Альфа Бизнес Онлайн, как  SOAP интерфейсы.

SOAP запросы и ответы сервиса содержат ЭП, расположенную в заголовке сообщения. Подпись хранится в элементе согласно стандарту xmldSig (http://www. w3.org/TR/2002/REC-xmldsig-core-20020212).

Для формирования и проверки ЭП согласно ГОСТ Р34.10-94/ГОСТ Р34.10-2001 используется криптопровайдер Крипто Про.

Таким образом все вызовы сервисов должны быть подписаны сертификатом обращающейся системы, который предварительно должен быть зарегистрирован в системе АЛБО. 

Следует обратить внимание, что на данный момент в сервисах не предполагается использования подписей конечных клиентов услуги.  Т. е. внешняя (по отношению к АЛБО) система обращается в Банк от своего лица и выступает в роли посредника - «провайдера», передавая идентификатор клиента.

С нашей стороны в качестве криптопровайдера используется реализация на Java:  КриптоПро JCP.  К сожалению, реализации JCP и CSP совместимы не на 100%,  из-за чего возможны нюансы при взаимодействии с систем, использующих различные реализации КриптоПро. Практика показывает, что при планировании работ необходимо закладывать, как минимум, 5-7 человеко-дней работы программистов на стороне интегрирующейся системы по настройке SOAP-параметров запроса к нашим веб-сервисам.

Как все работает

При вызове сервиса внешней системой, необходимо передать строку-идентификатор, определяющую, для какой компании производится запрос. Идентификатор должен быть предварительно зарегистрирован в системе Альфа-Бизнес Онлайн и однозначно определять в запрашивающей системе компанию, по поручению которой происходит обращение.  Обычно в качестве  такого идентификатора имеет смысл использовать логин клиента запрашивающей системе.

Необходимо учитывать, что в системе АЛБО один пользователь может иметь доступ к нескольким компаниям. Но доступ подключается именно в разрезе компании, причем для конкретной внешней системы каждая подключаемая компания должна иметь свой уникальный идентификатор. Иными словами, если внешняя система передает в качестве идентификатора логин для аккаунта клиента в этой системе, то у пользователя не получится подключить к услуге вторую и последующие компании. Если же внешняя система использует в качестве идентификатора не логин, то она должна гарантировать, что он уникален и только легитимный пользователь может его использовать.

Включение интеграции клиентом через интерфейс:

Подключить услугу интеграции может любой пользователь системы, уполномоченный компанией, т. е. имеющий в Альфа-Бизнес Онлайн доступ к компании и право подписи поручений для этой компании.

Подключение осуществляется в разделе «Настройки»:

На странице «Услуги партнеров» пользователь может выбрать требуемую услугу.

Далее видит список его компаний, которые уже подключены к выбранной услуге (в случае, если он ранее подключал ее).

Далее пользователь должен перейти на закладку «Управление услугой» и выбрать из списка компанию, для которой он хочет подключить услугу. Кроме того, он должен указать логин (идентификационную строку) с которой партнерская система будет обращаться к системе Альфа Бизнес Онлайн. Партнерская система при этом гарантирует, что с данным логином  она будет обращаться только от лица компании, которая зарегистрирована в партнерской системе с этим логином.  В этом случае, пользователю (если он в здравом уме и твердой памяти) при подключении услуги в АЛБО не имеет смысла указывать чужой логин.

Пользователю остается только подтвердить подключение, введя одноразовый код подписания заявки.

Далее, подписанная заявка исполняется в течение нескольких минут и интеграция включается.

Веб-сервисы:

В настоящее время реализовано два бизнес-сервиса:

Отправка платежного поручения из внешней системы в АЛБО. Запрос и получение внешней системой выписки по счетам.

Отправка платежного поручения выполняется, как синхронный процесс. Для его реализации предназначен сервис  WSCreatePaymentDocRUR. 

Получение выписки реализовано, как асинхронный процесс, состоящий из следующих шагов:

       - Создание запроса на выписку  (вебсервис WSCreateAccountMovementListRequest)

       - Проверка статуса формирования выписки (вебсервис WSGetAccountMovementList,  метод WSGetAccountMovementListStatus)

       - Получение сформированной выписки в случае готовности выписки (вебсервис WSGetAccountMovementList, метод WSGetAccountMovementListDoc).

Сервис проверки статуса формирования выписки с несуществующим идентификатором также можно использовать для проверки статуса подключения услуги интеграции клиентом: если при вызове возвращен ответ «выписки нет», то аутентификация прошла успешно и, следовательно, услуга подключена.  Если сервис вернул ошибку аутентификации, то это значит, что клиент или не подключил услугу (не зарегистрировал в системе АЛБО свой логин из внешней системе) или при регистрации доспустил ошибку/опечатку.

Учитывая, что API интеграции является однонаправленным и нет средств для PUSH-информирования о движения по счетам необходимо аккуратно подходить к алгоритму получения выписок. Например, не рекомендуется запрашивать выписку за длинные периоды. Таким образом,  для построения налоговой отчетности за год, внешняя система должна заботиться о своевременном  получении блоков операций объемами, не превышающими разумные значения (т. е. для среднестатистической компании – не более месяца). Необходимо так же учитывать возможность возникновения корректирующих проводок, которые могут изменять данные в выписке за последние 3-4 дня. В период новогодних каникул глубина изменений по корректирующим проводкам может достигать 10 календарных дней. Все более старые операции можно безопасно хранить на своей стороне – они уже точно не изменятся.

Тестирование:

Пользовательский интерфейс тестовой среды Альфа-Бизнес Онлайн расположен по адресу

https://testjmb. alfabank. ru/webclient/pages

Тестовые web-сервисы доступны по адресам:

Создание ПП:

https://testjmb. alfabank. ru/CS/ALBO/WSCreatePaymentDocRUR/WSCreatePaymentDocRUR

Создание запроса на выписку:

https://testjmb. alfabank. ru/CS/ALBO/WSCreateAccountMovementListRequest/WSCreateAccountMovementListRequest

Получение выписки

https://testjmb. alfabank. ru/CS/ALBO/WSGetAccountMovementList/WSGetAccountMovementList

Для использования сервисов  прежде всего необходимо получить тестовый сертификат. Для этого средствами КриптоПро (утилитой командной строки или используя КриптоАРМ) требуется создать запрос на сертификат и прислать его нам.  Мы выпустим сертификат и предоставим идентификационный код системы, который нужно передавать в каждом запросе в параметре externalSystemCode.

При создании запроса следует следовать рекомендациям по формату квалифицированного ГОСТ-сертификата.  Тип сертификата – для юридического лица (автомат). Т. е. он обязательно должен содержать ИНН юридического лица с двумя лидирующими нулями.

Тестирование сервисов предполагается производить на специально сгенерированных абстрактных тестовых клиентах. Их платежные реквизиты и логины с паролями будут предоставлены к началу интеграционного тестирования.

При тестировании нужно учитывать, что тестовая среда используется для нескольких проектов. Как  следствие, она бывает иногда недоступна. Поэтому в период активного тестирования рекомендуется уведомлять нас о своих намерениях. Мы постараемся скоординировать разные команды тестирования для уменьшения взаимного влияния.