Freigeben über

Abrufen von Smartcard- oder Profilzertifikaten

Ruft eine Liste von Zertifikaten ab, die einer bestimmten Smartcard oder einem bestimmten Softwareprofil zugeordnet sind.

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode Anforderungs-URL
ERHALTEN/Bekommen /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL-Parameter

Parameter BESCHREIBUNG
id Der Bezeichner (GUID) des Profils oder der Smartcard.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anfragekörper

Keiner.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code BESCHREIBUNG
200 OKAY
204 Kein Inhalt
403 Verboten
500 Interner Fehler

Antwortheader

Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antwortkörper

Gibt bei Erfolg eine Liste der JSON-serialisierten Microsoft.Clm.Shared.Certificates.X509ClmCertificate Objekte mit den folgenden Eigenschaften zurück:

Name BESCHREIBUNG
ArchivedOnCa Ein boolescher Wert, der angibt, ob das Zertifikat in der Zertifizierungsstelle archiviert wird.
Zertifikatstyp Der Typ des Zertifikats.
IsKeyHistory Ein boolescher Wert, der angibt, ob das Zertifikat ein Schlüsselverlaufszertifikat ist.
Seriennummer Die Seriennummer des Zertifikats.
TemplateCommonName Der allgemeine Name der Zertifikatvorlage für das Zertifikat.
Fingerabdruck Fingerabdruck des Zertifikats.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Abrufen der Zertifikate, die einer Smartcard oder einem Softwareprofil zugeordnet sind.

Beispiel: Anforderung

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

Beispiel: Antwort

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

Siehe auch