Smartcard- of profielcertificaten ophalen

Hiermee haalt u een lijst op met certificaten die zijn gekoppeld aan een bepaald smartcard- of softwareprofiel.

Notitie

De URL's in dit artikel zijn relatief ten opzichte van de hostnaam die tijdens de API-implementatie is gekozen, zoals https://api.contoso.com.

Aanvraag

Methode Aanvraag-URL
GET /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL-parameters

Maatstaf Beschrijving
identiteitskaart De id (GUID) van het profiel of de smartcard.

Headers aanvragen

Zie HTTP-aanvraag- en antwoordheaders in CM REST API-servicedetailsvoor algemene aanvraagheaders.

Inhoud van het verzoek

Geen.

Reactie

In deze sectie wordt het antwoord beschreven.

Antwoordcodes

Code Beschrijving
200 OK
204 Geen inhoud
403 Verboden
500 Interne fout

Antwoordheaders

Zie HTTP-aanvraag- en antwoordheaders in CM REST API-servicedetailsvoor algemene antwoordheaders.

Antwoordlichaam

Retourneert een lijst met door JSON geserialiseerde Microsoft.Clm.Shared.Certificates.X509ClmCertificate objecten met de volgende eigenschappen:

Naam Beschrijving
ArchivedOnCa Een Booleaanse waarde die aangeeft of het certificaat is gearchiveerd op de certificeringsinstantie (CA).
CertificateType Het type certificaat.
IsKeyHistory Een Booleaanse waarde die aangeeft of het certificaat een sleutelgeschiedeniscertificaat is.
Serienummer Het serienummer van het certificaat.
TemplateCommonName De algemene naam van de certificaatsjabloon voor het certificaat.
Vingerafdruk De vingerafdruk van het certificaat.

Voorbeeld

In deze sectie vindt u een voorbeeld van het ophalen van de certificaten die zijn gekoppeld aan een smartcard of softwareprofiel.

Voorbeeld: aanvraag

GET /certificatemanagement/api/v1.0/smartcards/aaaabbbb-0000-cccc-1111-dddd2222eeee/certificates HTTP/1.1

Voorbeeld: respons

HTTP/1.1 200 OK

[
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01052AFA01313FB77AC00010000B010",
        "Thumbprint":"AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B011AB48AE7D664ED5D900010000B011",
        "Thumbprint":"BB22CC33DD44EE55FF66AA77BB88CC99DD00EE11"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01ABCF2D38A0CCEAD8F00010000B01A",
        "Thumbprint":"CC33DD44EE55FF66AA77BB88CC99DD00EE11FF22"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B1F02865CF2C3A9DD96D00010000B1F0",
        "Thumbprint":"DD44EE55FF66AA77BB88CC99DD00EE11FF22AA33"
    }
]

Zie ook

  • Last updated on