Поделиться через


Получение профилей смарт-карт

Возвращает список профилей смарт-карт для пользователя. Список включает возможные операции, которые может выполнять текущий пользователь. Запрос можно инициировать для любой из указанных операций.

Примечание

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

Запрос

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

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

Свойство Описание
smartcarduuid Необязательный элемент. UUID смарт-карты, обозначаемый Microsoft Identity Manager (MIM) Certificate Management (CM). Значение соответствует полю "uuid" в объекте Microsoft.Clm.Shared.Smartcards.Smartcards.

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

Свойство Описание
cardid Необязательный элемент. UUID смарт-карты, обозначаемый MIM CM. Значение соответствует полю "uuid" в объекте Microsoft.Clm.Shared.Smartcards.Smartcards.

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

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

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

Нет.

Ответ

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

Коды ответов

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

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

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

Текст ответа

В случае успешного выполнения возвращает JSON-сериализованный объект Microsoft.Clm.Shared.Smartcards.Smartcard объектов со следующими свойствами:

Имя Описание
AssignedUserUuid Идентификатор пользователя, которому назначена смарт-карта.
Atr Строка ATR смарт-карты, которая в настоящее время инициализируется.
Комментировать Комментарий, описывающий смарт-карту.
Флаги Флажки, описывающие смарт-карту.
ПО промежуточного слоя ПО промежуточного слоя смарт-карты.
ParentSmartcardUuid Идентификатор старой смарт-карты, которую заменила эта смарт-карта.
PermanentSmartcardUuid Идентификатор постоянной смарт-карты, связанной с этой смарт-картой.
PrimarySmartcardUuid Идентификатор основной смарт-карты.
ProfileTemplateUuid Идентификатор шаблона профиля, который содержит политики и параметры, управляющие смарт-картой.
ProfileTemplateVersion Версия шаблона профиля во время создания профиля смарт-карты.
SerialNumber Серийный номер смарт-карты.
Состояние Состояние смарт-карты.
Uuid Идентификатор профиля смарт-карты.

Пример

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

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

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

Пример. Ответ 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

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

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Пример. Ответ 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

См. также раздел