Получение предлагаемого ПИН-кода смарт-карты

Получает созданный сервером PIN-код пользователя.

Важно!

Сервер устанавливает ПИН-код, только если политика шаблона профиля указывает, что это необходимо сделать. В противном случае пользователь должен указать ПИН-код.

Примечание

URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.

Запрос

Метод	URL-адрес запроса
GET	/CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

Параметры URL-адреса

Параметр	Описание
идентификатор	Идентификатор смарт-карты, относящееся к Microsoft Identity Manager (MIM) Certificate Management (CM). Идентификатор получается из объекта Microsft.Clm.Shared.Smartcard.

Параметры запроса

Параметр	Описание
atr	Строка ATR (Answer-to-reset) смарт-карты.
cardid	Идентификатор смарт-карты.
challenge	Строка в кодировке Base-64, представляющая задачу, выданную смарт-картой.

Заголовки запросов

Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.

Текст запроса

Нет.

Ответ

В этом разделе описывается ответ.

Коды ответов

Код	Описание
200	ОК
204	Нет содержимого
403	Запрещено
500	Внутренняя ошибка

Заголовки ответов

Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.

Текст ответа

При успешном выполнении возвращает строку, представляющую ПИН-код, предложенный сервером.

Пример

В этом разделе приведен пример получения ПИН-кода пользователя, созданного сервером.

Пример. Запрос

GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1

Пример: Ответ

HTTP/1.1 200 OK

... body coming soon