Obter certificados de perfil ou smart card

Artigo
09/14/2023

Obtém uma lista de certificados associados a um perfil de smart card ou software específico.

Nota

Os URLs neste artigo são relativos ao nome do anfitrião escolhido durante a implementação da API, como https://api.contoso.com.

Pedir

Método	URL do Pedido
GET	/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 smart card.

Cabeçalhos do pedido

Para obter os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço da API REST do CM.

Corpo do pedido

Nenhum.

Resposta

Esta secção descreve a resposta.

Códigos de resposta

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

Cabeçalhos de resposta

Para obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST do CM.

Corpo da resposta

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

Nome	Descrição
ArchivedOnCa	Um valor booleano que indica se o certificado é arquivado na autoridade de certificação (AC).
CertificateType	O tipo do certificado.
IsKeyHistory	Um valor booleano que indica se o certificado é um certificado do histórico de chaves.
SerialNumber	O número de série do certificado.
TemplateCommonName	O nome comum do modelo de certificado para o certificado.
Thumbprint	O thumbprint do certificado.

Exemplo

Esta secção fornece um exemplo para obter os certificados associados a um perfil de smart card ou 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"
    }
]

Partilhar via