Ottenere certificati di smart card o profili

Ottiene un elenco di certificati associati a una particolare smart card o profilo software.

Nota

Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.

Richiesta

Metodo URL richiesta
GET /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

Parametri URL

Parametro Descrizione
id Identificatore (GUID) del profilo o della smart card.

Header di richiesta

Per le intestazioni di richiesta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice Descrizione
200 Va bene
204 Nessun contenuto
403 Vietato
500 Errore interno

Intestazioni di risposta

Per le intestazioni di risposta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Corpo della risposta

In caso di esito positivo, restituisce un elenco di oggetti serializzati JSON Microsoft.Clm.Shared.Certificates.X509ClmCertificate con le proprietà seguenti:

Nome Descrizione
ArchivedOnCa Valore booleano che indica se il certificato è archiviato nell'autorità di certificazione (CA).
CertificateType Tipo di certificato.
IsKeyHistory Valore booleano che indica se il certificato è un certificato della cronologia delle chiavi.
SerialNumber Numero di serie del certificato.
TemplateCommonName Nome comune del modello di certificato per il certificato.
Impronta digitale Identificazione personale del certificato.

Esempio

Questa sezione fornisce un esempio per ottenere i certificati associati a una smart card o a un profilo software.

Esempio: richiesta

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

Esempio: risposta

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

Vedere anche

  • Ultimo aggiornamento: