Partilhar via

Obter certificados de cartão inteligente ou perfil

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

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 do Pedido
GET /CertificateManagement/api/v1.0/profiles/{id}/certificados
/CertificateManagement/api/v1.0/smartcards/{id}/certificados

Parâmetros de URL

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

Cabeçalhos da requisição

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

Corpo de solicitação

Nenhum.

Resposta

Esta seção descreve a resposta.

Código de resposta

Código Descrição
200 OK
204 Sem conteúdo
403 Proibido
500 Erro interno

Cabeçalhos de resposta

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

Corpo da resposta

Quando for bem-sucedido, retorna uma lista de objetos Microsoft.Clm.Shared.Certificates.X509ClmCertificate serializados em JSON com as seguintes propriedades:

Nome Descrição
ArquivadoOnCa Um valor booleano que indica se o certificado está arquivado na autoridade de certificação (CA).
Tipo de certificado O tipo do certificado.
IsKeyHistory Um valor booleano 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.
ModeloCommonName O nome comum do modelo de certificado para o certificado.
Thumbprint 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: Pedido

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

Ver também