EMS Web Service API. Общие принципы работы

EMS Web Service API. Общие принципы работы

Sentinel EMS глобально делится на три части:
1. Sentinel EMS Vendor Portal - основная часть Sentinel EMS, доступ к которой есть у разработчика ПО (вход по логину с паролем). Здесь разработчик может создавать Feature ID или Product’s или Entitlement’s или  активировать новые SL ключи или разблокировать ранее заблокированные лицензии или создавать и выпускать обновления и т.д.;

2. Sentinel EMS Customer Portal - клиентская часть Sentinel EMS, доступ к которой предоставляется конечным пользователям (вход с помощью ключа активации). Здесь клиент может самостоятельно активировать себе лицензию по предоставленному ему ключу активации (Product Key); 3. Sentinel EMS Channel Partner Portal - партнёрская часть Sentinel EMS, доступ к которой предоставляется партнёрам разработчика, через которых разработчик хочет вести продажи своего ПО (вход по логину с паролем от учётных записей, создаваемых разработчиком для своих партнёров в самом Sentinel EMS). 

Основные моменты, касающиеся EMS Web Service API: 
1. EMS Web Service API - представляет из себя RESTFul API для взаимодействия с Sentinel EMS из любого приложения/интерфейса.
2. Всё что можно сделать через Sentinel EMS UI, всё это же можно выполнить и через EMS Web Service API.
3. EMS Web Service API, в силу своей специфики, не привязан к какому-либо конкретному языку программирования и является универсальным инструментом, работать с котором можно из любого приложения/интерфейса, способного выполнять HTTP запросы. Возможности методов EMS Web Service API хорошо иллюстрирует таблица:


Базовый принцип работы с EMS Web Services API заключается в составлении правильного URL запроса и отправки его на сервер Sentinel EMS. 
Пример базовой части любого запроса к Sentinel EMS Web Services API:
http(s)://<Hostname>:<port>/ems/v710/ws/
Где:
➔ Hostname — доменное имя или IP адрес ПК с Sentinel EMS Server.
➔ port — порт на котором работает Sentinel EMS Server (по умолчанию это либо 8080, либо 80).
➔ ems — базовая директория где расположен Sentinel EMS Server.
➔ v710 — версия Sentinel EMS Web Services API.
➔ ws — константа, говорящая о том, что это запрос к Sentinel EMS Web Services API.
Для выполнения большей части (НО НЕ ВСЕХ) запросов к Sentinel EMS Web Services API вначале потребуется выполнить аутентификацию на сервер Sentinel EMS. Аутентификация позволяет разграничить уровни доступа к операциям в Sentinel EMS. 


Поддерживаются следующие алгоритмы аутентификации:
Аутентификация по логину с паролем - для входа в: Sentinel EMS Vendor Portal или Sentinel EMS Chanel Partner Portal;
Аутентификация по ключу активации (Product Key) - для входа в Sentinel EMS Customer Portal.