10.1.1. Особенности REST API eCA-CA (версия 2)

Aladdin Enterprise CAAPI и SDKAladdin Enterprise CA

REST API версии 2 (/api/v2/) — ранняя версия программного интерфейса eCA-CA. Она актуальна для инсталляций, в которых внешние интеграции продолжают обращаться к методам версии 2 (например, после обновления eCA с более ранних версий продукта).

Рекомендация

Для новых интеграций используйте актуальную версию API — см. REST API eCA-CA (версия 4). Версия 3 описана в разделе REST API eCA-CA (версия 3).

Соответствие версий 2 и 3

API версии 2 является подмножеством версии 3:

• 38 из 39 методов версии 2 имеют прямые аналоги в версии 3 (те же методы, префикс пути /api/v2/ заменён на /api/v3/). Описание этих методов приведено в разделе REST API eCA-CA (версия 3).

• в версии 3 и 4 дополнительно появились методы, отсутствующие в версии 2: Kerberos/LDAP-аутентификация, ограничения сторонних токенов (restrictions/third-party-tokens), перевыпуск сертификатов (renewal), разбор контейнеров (parse/pkcs12, parse/pem, parse/pkcs10), работа с учётными записями (accounts), поиск субъектов по списку идентификаторов (subjects/ids) и другие.

Метод, доступный только в версии 2

Метод публикации сертификата в РС по идентификатору

PUT API – Публикация сертификата в ресурсную систему
Метод доступен администратору и оператору при наличии полномочий на управление сертификатом, идентификатор которого передаётся во входных параметрах
URL – certificate-authority-service/api/v2/public/certificates/{id}/publish
Swagger: https://HOST/certificate-authority-service/swagger/swagger-ui/index.html#/Контроллер%3A%20сертификаты/publishById_1
Query {
id (uuid)	Идентификатор сертификата
}
Request -
Response -

Примечание

В версии 3 этот метод отсутствует: публикация сертификата в ресурсную систему выполняется при выпуске сертификата (параметры публикации задаются в шаблоне и запросе на выпуск).

Состав методов версии 2 (по группам)

Для навигации приведён перечень групп методов версии 2; описание каждого метода аналогично версии 3 (см. REST API eCA-CA (версия 3)):

• Методы идентификации и аутентификации.

• Методы работы с субъектами.

• Методы работы с шаблонами сертификатов.

• Методы работы с Центрами сертификации.

• Методы работы с сертификатами.

• Методы экспорта файлов.

• Методы работы с точками распространения.

• Методы работы с точками подключения и ресурсными системами.

• Метод получения версии сервиса внешних интеграций.

• Методы работы с Syslog-серверами.