Swagger
Для вызовов методов API, тестирования запросов удобно использовать UI интерфейс Swagger, который встроен в "core". Для включения доступа к UI выполните следующие:
- Откройте конфигурационный файл сервера Indeed AM "web.config" (C:\inetpub\wwwroot\am\core).
- Для параметра "enableSwagger" установите значение "true".
- UI интерфейс Swagger будет доступен по ссылке: http(s)://<DNS_IndeedAM_Server>/am/core/swagger/
Токен администратора
Для большинства запросов API требуется определенные права в системе Indeed для выполнения. Для успешного выполнения таких запросов необходимо выполнить аутентификации в API под пользователем с требуемым набором прав. После выполнения аутентификации будет получен токен сессии, который используется в запросах API.
Полученный токен активен в течение 2-х суток с момента получения.
Получение токена с помощью "authenticateByWindowsToken"
Данный способ получения токена является самым простым. Для получения необходимо вызвать один метод от имени пользователя, для которого будет выдан токен.
- Если запрос выполняется через браузер, то браузер должен быть запущен от имени требуемого пользователя.
- В PS, например, при запросе необходимо использовать дополнительный параметр "UseDefaultCredentials"(Пример функции "postRequestForWin" в PS: ссылка).
В качестве идентификатора приложения может быть указано любое приложение из списка Indeed: список приложений.
Важно!
Используемое приложение будет указываться в события аутентификации.
Получение токена с помощью "authenticate"
В данном способе получения токена можно использовать методы аутентификации, которые доступны пользователю. Подробнее про 2fa аутентфикацияю в API в разделе: ссылка.
По результату аутентфикации будет получен аналогичный токен.