Назначение
Набор API-функций позволяет управлять устройствами (токенами, смарт-картами) средствами клиентских приложений.
Использование
Доступ к API-функциям реализован через веб-приложение icmapi, входящего в состав сервера Indeed Certificate Manager. Для взаимодействия с Indeed CM через API в разделе Роли в конфигурации Indeed CM потребуются создать сервисную роль, включить в нее учетную запись, от имени которой будет производиться обращение по API и определить для роли привилегии:
- Поиск устройства
- Отзыв устройства
- Выключение устройства
- Включение устройства
- Обновление устройства
1. GetCards - получить список устройств пользователя.
Тип запроса:
Параметры:
- Name - имя пользователя в формате UPN (user principal name)
Возвращаемые значения (cписок объектов CardInfo):
- id - идентификатор устройства
- serialNumber - серийный номер устройства
- atr - ATR устройства
- label - метка устройства
- state - состояние устройства
- pacNumber - HID-метка устройства
2. Revoke - отозвать устройство пользователя.
Тип запроса:
Параметры:
Возвращаемые значения:
Тело запроса:
- Причина отзыва устройства - например, { reason: 5 }
3. Disable - временно отключить устройство пользователя.
Тип запроса:
Параметры:
- id - идентификатор устройства
Возвращаемые значения:
4. Enable - включить устройство пользователя.
Тип запроса:
Параметры:
- id - идентификатор устройства
Возвращаемые значения:
5. Preupdate - отозвать неактуальный сертификат пользователя.
Тип запроса:
Параметры:
- id - идентификатор устройства
Возвращаемые значения: