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

  • 项目

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

注意

本文中的 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"
    }
]

另请参阅