获取智能卡或配置文件证书

项目
09/14/2023

获取与特定智能卡或软件配置文件关联的证书的列表。

注意

本文中的 URL 相对于 API 部署期间选择的主机名，例如 https://api.contoso.com。

请求

方法	请求 URL
GET	/CertificateManagement/api/v1.0/profiles/{id}/certificates /CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL 参数

参数	说明
id	配置文件或智能卡的标识符 (GUID) 。

请求标头

有关常见请求标头，请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。

请求正文

无。

响应

本部分介绍响应。

响应代码

代码	说明
200	确定
204	无内容
403	禁止
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"
    }
]

通过