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/aaaabbbb-0000-cccc-1111-dddd2222eeee/certificates HTTP/1.1

Exemplo: Resposta

HTTP/1.1 200 OK

[
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01052AFA01313FB77AC00010000B010",
        "Thumbprint":"AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B011AB48AE7D664ED5D900010000B011",
        "Thumbprint":"BB22CC33DD44EE55FF66AA77BB88CC99DD00EE11"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01ABCF2D38A0CCEAD8F00010000B01A",
        "Thumbprint":"CC33DD44EE55FF66AA77BB88CC99DD00EE11FF22"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B1F02865CF2C3A9DD96D00010000B1F0",
        "Thumbprint":"DD44EE55FF66AA77BB88CC99DD00EE11FF22AA33"
    }
]

Ver também

  • Last updated on