スマートカードまたはプロファイルの証明書を取得する

特定のスマートカードまたはソフトウェアプロファイルに関連付けられている証明書の一覧を取得します。

Note

この記事の Url は、API の展開時に選択されたホスト名 (など) に関連してい https://api.contoso.com ます。

Request

Method 要求 URL
GET /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL パラメーター

パラメーター 説明
id プロファイルまたはスマートカードの識別子 (GUID)。

要求ヘッダー

一般的な要求ヘッダーについては、「 CM REST API サービスの詳細」の「 HTTP 要求および応答ヘッダー 」を参照してください。

要求本文

[なし] :

Response

このセクションでは、応答について説明します。

応答コード

コード 説明
200 [OK]
204 コンテンツはありません
403 Forbidden
500 内部エラー

応答ヘッダー

一般的な応答ヘッダーについては、「 CM REST API サービスの詳細」の「 HTTP 要求および応答ヘッダー 」を参照してください。

応答本文

成功すると、JSON でシリアル化された Microsoft.Clm.Shared.Certificates.X509ClmCertificate オブジェクトと次のプロパティの一覧が返されます。

名前 説明
ArchivedOnCa 証明機関 (CA) に証明書がアーカイブされているかどうかを示すブール値。
CertificateType 証明書のタイプ。
IsKeyHistory 証明書がキー履歴証明書かどうかを示すブール値。
SerialNumber 証明書のシリアル番号。
TemplateCommonName 証明書の証明書テンプレートの共通名。
Thumbprint 証明書のサムプリント。

このセクションでは、スマートカードまたはソフトウェアプロファイルに関連付けられている証明書を取得する例について説明します。

例: 要求

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

例: Response

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

関連項目