Získání certifikátů čipové karty nebo profilu

Článek
03/22/2025

Získá seznam certifikátů přidružených k určitému profilu čipové karty nebo softwaru.

Poznámka:

Adresy URL v tomto článku jsou relativní vzhledem k názvu hostitele zvolenému během nasazování rozhraní API, například https://api.contoso.com.

Žádost

Metoda	Adresa URL požadavku
ZÍSKAT	/CertificateManagement/api/v1.0/profiles/{id}/certificates /CertificateManagement/api/v1.0/smartcards/{id}/certificates

Parametry adresy URL

Parametr	Popis
identifikační číslo	Identifikátor (GUID) profilu nebo čipové karty.

Hlavičky žádosti

Běžné hlavičky požadavků najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby rozhraní REST API CM.

Obsah požadavku

Žádné.

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód	Popis
200	OK
204	Žádný obsah
403	Zakázáno
500	Vnitřní chyba

Hlavičky odpovědi

Běžné hlavičky odpovědí najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby rozhraní REST API CM.

Obsah odpovědi

Při úspěchu vrátí seznam serializovaných json Microsoft.Clm.Shared.Certificates.X509ClmCertificate objekty s následujícími vlastnostmi:

Název	Popis
ArchivedOnCa	Logická hodnota, která označuje, jestli je certifikát archivován v certifikační autoritě (CA).
CertificateType	Typ certifikátu.
IsKeyHistory	Logická hodnota, která označuje, jestli je certifikát certifikátem historie klíčů.
SerialNumber	Sériové číslo certifikátu.
TemplateCommonName	Běžný název šablony certifikátu
Otisk palce	Kryptografický otisk certifikátu.

Příklad

Tato část obsahuje příklad získání certifikátů přidružených k čipové kartě nebo softwarovému profilu.

Příklad: Požadavek

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

Příklad: Odpověď

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

Sdílet prostřednictvím