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

Статья
09/14/2023

Возвращает список сертификатов, связанных с определенной смарт-картой или профилем программного обеспечения.

Примечание

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

Запрос

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

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

Параметр	Описание
идентификатор	Идентификатор (GUID) профиля или смарт-карты.

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

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

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

Нет.

Ответ

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

Коды ответов

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

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

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

Текст ответа

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

Имя	Описание
ArchivedOnCa	Логическое значение, указывающее, архивируется ли сертификат в центре сертификации (ЦС).
CertificateType	Тип сертификата.
IsKeyHistory	Логическое значение, указывающее, связан ли сертификат с журналом ключа.
SerialNumber	Серийный номер сертификата.
TemplateCommonName	Общее имя шаблона сертификата.
Отпечаток	отпечаток сертификата.

Пример

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

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

GET /certificatemanagement/api/v1.0/smartcards/5badfea3-de31-4837-99f9-8249515a5473/certificates HTTP/1.1

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

HTTP/1.1 200 OK

[
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01052AFA01313FB77AC00010000B010",
        "Thumbprint":"C52B0C5FB8AAD31A5B239FF2712ED14122D67D30"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B011AB48AE7D664ED5D900010000B011",
        "Thumbprint":"E7C4324896271BE869544FF28AA2B1BF3B3BDFCF"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01ABCF2D38A0CCEAD8F00010000B01A",
        "Thumbprint":"D9293B5414C644888444541B64631E90F2612425"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B1F02865CF2C3A9DD96D00010000B1F0",
        "Thumbprint":"6615DDC8603DBA789D724502627682F37D0FC2D0"
    }
]

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