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

  • [アーティクル]

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

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

例: 応答

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

関連項目