Obtenir des certificats de carte à puce ou de profil

Article
09/14/2023

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

Notes

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
GET	/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 les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service de l’API REST CM.

Corps de la demande

Aucun.

response

Cette section décrit la réponse.

Codes de réponse

Code	Description
200	OK
204	Aucun contenu
403	Interdit
500	Erreur interne

En-têtes de réponse

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

Response body

En cas de réussite, retourne une liste d’objets JSON sérialisés 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.
CertificateType	Type du certificat.
IsKeyHistory	Valeur booléenne qui indique si le certificat est un certificat historique clé.
SerialNumber	Numéro de série du certificat.
TemplateCommonName	Nom commun du modèle de certificat pour le certificat.
Empreinte numérique	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 : Demande

GET /certificatemanagement/api/v1.0/smartcards/5badfea3-de31-4837-99f9-8249515a5473/certificates HTTP/1.1

Exemple : Réponse

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

Partager via