Uzyskiwanie certyfikatów karty inteligentnej lub profilu

Pobiera listę certyfikatów, które są skojarzone z określonej karty inteligentnej lub profilu oprogramowania.

Uwaga

Adresy URL w tym artykule są względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej jak https://api.contoso.com .

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

Parametry URL

Parametr Opis
identyfikator Identyfikator (GUID) profilu lub karty inteligentnej.

Nagłówki żądań

Aby uzyskać typowe nagłówki żądań, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
403 Forbidden
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść odpowiedzi

W przypadku powodzenia zwraca listę obiektów Microsoft.Clm.Shared.Certificates.X509ClmCertificate serializowanych w pliku JSON z następującymi właściwościami:

Nazwa Opis
ArchivedOnCa Wartość logiczna wskazująca, czy certyfikat jest archiwizowany w urzędzie certyfikacji.
Typ certyfikatu Typ certyfikatu.
IsKeyHistory Wartość logiczna wskazująca, czy certyfikat jest certyfikatem historii kluczy.
SerialNumber Numer seryjny certyfikatu.
TemplateCommonName (Nazwa_szablonu) Nazwa pospolita szablonu certyfikatu dla certyfikatu.
Odcisk palca Odcisk palca certyfikatu.

Przykład

Ta sekcja zawiera przykład uzyskania certyfikatów skojarzonych z kartą inteligentną lub profilem oprogramowania.

Przykład: Żądanie

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

Przykład: Odpowiedź

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"
    }
]

Zobacz też