Получение разностороннего ключа администратора смарт-карты
Возвращает диверсифицированный ключ администратора для указанной смарт-карты.
Важно!
Ключ администратора следует диверсифицировать только в том случае, если политика шаблона профиля указывает, что это должно быть.
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.
Запрос
| Метод | URL-адрес запроса |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/diversifiedkey |
Параметры URL-адреса
| Параметр | Описание |
|---|---|
| reqid | Обязательный. Идентификатор запроса, относящееся к управлению сертификатами (CM) Microsoft Identity Manager (MIM). |
| scid | Обязательный элемент. Идентификатор смарт-карты, относящееся к MIM CM. Идентификатор scid получается из объекта Microsoft.Clm.Shared.Smartcards.Smartcard . |
Параметры запроса
| Параметр | Описание |
|---|---|
| atr | Необязательный элемент. Строка ATR (Answer-to-reset) смарт-карты. |
| cardid | Обязательный. Идентификатор карты. |
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Нет.
Ответ
В этом разделе описывается ответ.
Коды ответов
| Код | Описание |
|---|---|
| 200 | ОК |
| 204 | Нет содержимого |
| 403 | Запрещено |
| 500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст ответа
В случае успешного выполнения возвращается байтовый BLOB-объект, представляющий диверсифицированный ключ администратора.
Пример
В этом разделе приведен пример получения диверсифицированного ключа администратора для смарт-карты.
Пример. Запрос
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9/diversifiedkey?cardid=bc88f13f-83ba-4037-8262-46eba1291c6e HTTP/1.1
Пример: Ответ
HTTP/1.1 200 OK
"mBVA+HopB/gc+6FuKsQqx+OX01hK1WQI"