Obtenir des certificats de carte à puce ou de profil

Obtient une liste de certificats associés à une carte à puce ou à un profil logiciel particulier.

Remarque

Les URL de cet article sont relatives au nom d’hôte choisi pendant le déploiement de l’API, par exemple https://api.contoso.com.

Requête

Méthode URL de demande
OBTENIR /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

Paramètres d’URL

Paramètre Description
id Identificateur (GUID) du profil ou de la carte à puce.

En-têtes de requête

Pour connaître les en-têtes de requête courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.

Corps de la requête

Aucun.

Réponse

Cette section décrit la réponse.

Codes de réponse

Code Description
200 D’ACCORD
204 Aucun contenu
403 Interdit
500 Erreur interne

En-têtes de réponse

Pour connaître les en-têtes de réponse courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.

Corps de la réponse

En cas de réussite, retourne une liste d’objets sérialisés JSON Microsoft.Clm.Shared.Certificates.X509ClmCertificate avec les propriétés suivantes :

Nom Description
ArchivedOnCa Valeur booléenne qui indique si le certificat est archivé sur l’autorité de certification (CA).
CertificateType Type du certificat.
IsKeyHistory Valeur booléenne qui indique si le certificat est un certificat d’historique de clés.
Numéro de série Numéro de série du certificat.
TemplateCommonName Nom commun du modèle de certificat pour le certificat.
Empreinte Empreinte numérique du certificat.

Exemple :

Cette section fournit un exemple pour obtenir les certificats associés à une carte à puce ou un profil logiciel.

Exemple : requête

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

Exemple : réponse

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

Voir aussi

  • Last updated on