Hämta smartkort eller profilcertifikat

  • Artikel

Hämtar en lista över certifikat som är associerade med ett visst smartkort eller en viss programvaruprofil.

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod Begärans-URL
GET /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL-parametrar

Parameter Beskrivning
id Identifieraren (GUID) för profilen eller smartkortet.

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Begärandetext

Inga.

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod Description
200 OK
204 Inget innehåll
403 Förbjudet
500 Internt fel

Svarshuvuden

Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Själva svaret

Vid lyckat resultat returnerar en lista över JSON-serialiserade Microsoft.Clm.Shared.Certificates.X509ClmCertificate-objekt med följande egenskaper:

Name Beskrivning
ArchivedOnCa Ett booleskt värde som anger om certifikatet arkiveras på certifikatutfärdare (CA).
CertificateType Typ av certifikat.
IsKeyHistory Ett booleskt värde som anger om certifikatet är ett nyckelhistorikcertifikat.
Serienummer Certifikatets serienummer.
TemplateCommonName Certifikatmallens eget namn för certifikatet.
Stämpel Certifikatets tumavtryck.

Exempel

Det här avsnittet innehåller ett exempel för att hämta de certifikat som är associerade med ett smartkort eller en programvaruprofil.

Exempel: Begäran

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

Exempel: Svar

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

Se även