Compartilhar via

Obter certificados de cartão inteligente ou de perfil

Obtém uma lista de certificados associados a um determinado perfil de software ou cartão inteligente.

Observação

As URLs neste artigo são relativas ao nome do host escolhido durante a implantação da API, como https://api.contoso.com.

Solicitação

Método URL da solicitação
Conseguir /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

Parâmetros de URL

Parâmetro Descrição
id O identificador (GUID) do perfil ou cartão inteligente.

Cabeçalhos de solicitação

Para obter cabeçalhos de solicitação comuns, consulte cabeçalhos de solicitação HTTP e de resposta nos detalhes do serviço da API REST CM.

Corpo da solicitação

Nenhum.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

Código Descrição
200 OKEY
204 Nenhum conteúdo
403 Proibido
500 Erro Interno

Cabeçalhos de resposta

Para obter cabeçalhos de resposta comuns, consulte cabeçalhos de solicitação e resposta HTTP em detalhes do serviço da API REST do CM.

Corpo da resposta

Com êxito, retorna uma lista de objetos Microsoft.Clm.Shared.Certificates.X509ClmCertificate com as seguintes propriedades:

Nome Descrição
ArchivedOnCa Um valor booliano que indica se o certificado está arquivado na AC (autoridade de certificação).
CertificateType O tipo do certificado.
IsKeyHistory Um valor booliano que indica se o certificado é um certificado de histórico de chaves.
Número de Série O número de série do certificado.
TemplateCommonName O nome comum do modelo de certificado para o certificado.
Impressão digital A impressão digital do certificado.

Exemplo

Esta seção fornece um exemplo para obter os certificados associados a um cartão inteligente ou perfil de software.

Exemplo: Solicitação

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

Exemplo: Resposta

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

Consulte também

  • Last updated on