Ottenere certificati di smart card o profili

Articolo
03/22/2025

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/5badfea3-de31-4837-99f9-8249515a5473/certificates HTTP/1.1

Esempio: risposta

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

Condividi tramite