Общая информация

Используйте API Indeed Access Manager для интеграции с приложениями.

В этом разделе описаны общие параметры UserId, modeId, ApplicationId, а также формат запросов, которые необходимы для использования API Indeed.

Запрос к API

Для обращения к методу необходимо выполнить запрос POST или запрос GET по http(s)://<dns_indeedam_server>/am/core/<url_api_method>, где:

• dns_indeedam_server — полное DNS-имя сервера, где развернут Indeed Core Server, или полное DNS-имя сервера, где развернут WARP;
• url_api_method — адрес соответствующего метода; адреса указаны в документации к методу или в Swagger.

Пример для метода getAvailableMethods, где DNS-имя сервера Indeed Core Server: indeedam.indeed.local:

https://indeedam.indeed.local/am/core/api/v6/logon/getAvailableMethods

Важно

Метод authenticateByWindowsToken работает только при настроенном WARP.

Пример для метода authenticateByWindowsToken, где DNS-имя сервера WARP: warp.indeed.local:

https://warp.indeed.local/am/core/api/v6/logon/authenticateByWindowsToken

UserId

В параметре указывается уникальный идентификатор пользователя из системы Indeed.

Идентификатор состоит из строкового ID, указанного в app-settings.json Core Server в параметре Id каталога пользователя и objectGuid пользователя.

Например, в параметре userId указано значение GUID пользователя 10efa04f-7ba9-47d8-89db-56e166f1679f. Значение UserId пользователя — UserId\_10efa04f-7ba9-47d8-89db-56e166f1679f.

Чтобы получить userId, используйте метод [POST]/api/v6/user/searchUserId.

modeId

Уникальный идентификатор способа аутентификации Indeed.

Способы аутентификации: 

• Indeed AM Windows Password Provider {CF189AF5-01C5-469D-A859-A8F2F41ED153}
• Indeed AM Passcode Provider {F696F05D-5466-42b4-BF52-21BEE1CB9529}
• Indeed AM Email OTP Provider {093F612B-727E-44E7-9C95-095F07CBB94B}
• Indeed AM Hardware TOTP Provider {CEB3FEAF-86ED-4A5A-BD3F-6A7B6E60CA05}
• Indeed AM HOTP Provider {CEB3FEAF-86ED-4A5A-BD3F-6A7B6E60CA05}
• Indeed AM Storage SMS OTP Provider {3F2C1156-B5AF-4643-BFCB-9816012F3F34}
• Indeed AM SMS OTP Provider {EBB6F3FA-A400-45F4-853A-D517D89AC2A3}
• Indeed AM Software OTP Provider {0FA7FDB4-3652-4B55-B0C0-469A1E9D31F0}
• Indeed Key Provider {DEEF0CB8-AD2F-4B89-964A-B6C7ECA80C68}
• Indeed AM MFA Provider {070719BA-EB57-4EA8-BB4D-D15A33E7363D}

ApplicationId

Внутренний модуль

Примечание

Для работы с внутренним модулем не требуется лицензия, достаточно иметь права на операции, предоставляемые внутренними модулями.

Функциональность Access Manager организована через внутренние модули, каждый из которых реализует определенную бизнес-логику. Строковые идентификаторы модулей используются для обращения к разным частям API Core Server.

Внутренние модули Core Server:

• User Profile Setting Management
• User Access Control Management
• Hardware Devices Management
• License Management
• Authenticator Management
• Authenticator Enrollment
• User Accounts Management
• Policy Management
• User Cache Management
• Business Applications Management

Помимо модулей, доступны внутренние приложения:

• Enterprise Management Console
• Self Service
• Native Enroller

Модуль интеграции

Примечание

Для работы с модулями интеграции требуется лицензия для соответствующего модуля.

Модули интеграции обеспечивают взаимосвязь Access Manager с внешними системами. К ним относятся:

• Windows Logon
• FreeRADIUS Extension
• Identity Provider
• ADFS Extension
• RDP Windows Logon
• Authentication API

Идентификатор политики

Чтобы узнать идентификатор политик, выполните следующие действия:

1. Откройте Management Console.
2. Перейдите на вкладку Политики.
3. Выберите целевую политику.
4. Скопируйте идентификатор политики из параметра policyId в URL-адресе.