Информация

Для интеграции с различными приложениями может быть использовано API Indeed AM.

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

Запрос к API

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

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

Пример для метода authenticateByWindowsToken, где DNS-имя сервера Indeed AM — indeedam.indeed.local

Пример
https://indeedam.indeed.local/am/core/api/v5/logon/authenticateByWindowsToken

Важно!

При использовании https необходимо загрузить на сервере Indeed AM валидный сертификат.


Идентификатор пользователя

Параметр "UserId"

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

  1. Данный идентификатор состоит из строкового id, указанного в Web.config AM в параметре "userId", и "objectGuid" пользователя из AD. Например: 
    1. В параметре "userId" указано значение, GUID пользователя "10efa04f-7ba9-47d8-89db-56e166f1679f". UserId пользователя будет UserId_10efa04f-7ba9-47d8-89db-56e166f1679f
  2. Для получения userId можно воспользоваться методом [POST] /api/v5/user/searchUserId

Идентификаторы способов аутентификации 

Параметр "modeId"

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

Для получения всех установленных способов аутентификации на сервере Indeed AM можно воспользоваться методом [GET] /api/v5/authenticationProvider/getAll


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

Параметр "ApplicationId"

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

Важно!

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

Функционал AM разбит на группы, за которые отвечают внутренние модули. Они реализуют внутреннюю бизне- логику решения. Их строковые идентификаторы используются для обращения к разным частям API Core сервера.

Внутренние модули Core сервера:

  • 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

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

Важно!

Требуется лицензия для соответствующего модуля

 Модуль, реализующий взаимосвязь решения AM и внешних систем, с которыми выполняется интеграция. К ним относятся:

  • Windows Logon
  • Enterprise SSO
  • IIS Extension
  • NPS RADIUS Extension
  • Indeed AM Identity Provider
  • ADFS Extension
  • RDP Windows Logon
  • Authentication API

Модули интеграции могут представлять собой одно бизнес-приложение (например Windows Logon), а могут иметь набор бизнес-приложений, которые можно добавлять/удалять (например модуль Enterprise SSO. Он предоставляет возможности интеграции с разными типами приложений пользователя (Desktop apps, Web apps) и для каждого нужно создавать отдельное бизнес-приложение ESSO: 1С, Lotus Notes и пр.).


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

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

  1. Откройте консоль администратора системы Indeed. 
  2. Перейдите на вкладку "Политики".
  3. Нажмите на целевую политику. 
  4. Скопируйте значение id политики из GET параметра в URL


  • No labels