Hämta smartkort eller profilcertifikat

Artikel
09/14/2023

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

Dela via