Настройка взаимодействия IS-Media с R-Keeper
Служба EcRKeeperConnectorServiceSrv взаимодействует с API R-Keeper 7 по HTTP протоколу. Для работы с XML интерфейсом по HTTP необходимо настроить R-Keeper согласно инструкции данной системы. Ниже приведена краткая инструкция по настройке R-Keeper:
Настройка HTTPs серверf
В менеджерской станции необходимо настроить доступ к серверу справочников через HTTPS.
Для этого необходимо сделать следующее:
1. В справочнике "Сервис - Менеджерская станция - Привилегии на объекты" добавить новую привилегию, например HTTP_порт.
Рис. Создание привилегии
2. В свойствах сервера справочников прописать порт (параметр HTTP Data Port) в секции HTTP Server. Флаг Use Free Listen Port необходим, чтобы программа выбрала другой порт в случае, когда заданный в свойстве HTTP Data Port порт занят. Поэтому проверьте сразу свободен ли порт, который вы задаете. В блоке HTTP Ограничения выбрать ограничение, созданное в п 1. После сохранение изменений необходимо перезагрузить сервер. Примечание: не только порт, прописанный в свойствах сервера справочников в менеджерской станции (HTTP Data Port) можно использовать для доступа к web-интерфейсу данного сервера, но и порт, прописанный в rk7srv.ini в секции [TSPSOC], параметр port.
Рис. Задание порта "HTTP Data Port" в свойствах сервера справочников.
Рис. Задание ограничений и порта "HTTP Data Port" в свойствах кассового сервера.
3. Создать роль с правами на привилегию из п.1.
Рис. Создание новой роли
4. Для этой роли добавить работника, задать ему пароль. Название и пароль данного работника будут использоваться для авторизации на сервере через HTTPS.
Рис. Создание нового пользователя
Аутентификация / авторизация
Для аутентификация и авторизации используется имя (название) и пароль работника RK7.
WEB интерфейс на момент написания статьи имеет ограничения:
- Новый WEB интерфейс: http://ip:port/webgui/, например: http://ip:port/webgui/index.htm;
- APIiверсии 0 (xml интерфейс и внутренние процедуры RK7): http://ip:port/rk7api/v0, например: http://ip:port/rk7api/v0/xmlinterface.xml;
- API версии 1 (новые функции для взаимодействия с RK7) http://ip:port/rk7api/v1, например: https://127.0.0.1:13665/rk7api/v1/serverstatus.xml;
На каждый из этих пунктов существует право доступа, задаваемое в свойствах сервера. После указания права и его назначения соответствующей роли можно проверить корректность настроек, открыв в WEB интерфейсе соответствующие страницы. Вбейте в адресной строке один из вариантов ниже, появится окно авторизации - введите название работника и пароль (рис. выше). http://ip:port/webgui/
Примеры выполнения запроса
Тестовая страница XML интерфейса
Для проверки XML интерфейса через HTTPs интерфейс необходимо зайти по адресу https://ip:port/webgui/iservxmltest.htm (например, https://127.0.0.1:13665/webgui/iservxmltest.htm) ввести свои имя пользователя и пароль и текст XML запроса для выполнения. Затем следует нажать кнопку Execute. Результат должен быть такой как на рисунке ниже.