Obter perfis de smart card

  • Artigo

Obtém uma lista de perfis de smart card para um utilizador. A lista inclui as possíveis operações que podem ser realizadas pelo utilizador atual. Em seguida, pode ser iniciado um pedido para qualquer uma das operações especificadas.

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/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parâmetros de URL

Propriedade Descrição
smartcarduuid Opcional. O UUID do smart card, conforme indicado pelo Microsoft Identity Manager (MIM) Certificate Management (CM). O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcard .

Parâmetros de consulta

Propriedade Descrição
cardid Opcional. O UUID do smart card, conforme indicado pelo CM mim. O valor corresponde ao campo "uuid" no objeto Microsoft.Clm.Shared.Smartcards.Smartcard .

Cabeçalhos do pedido

Para obter cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos HTTP e resposta nos detalhes do serviço da API REST de 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 HTTP e resposta nos detalhes do serviço da API REST de CM.

Corpo da resposta

Com êxito, devolve um objeto JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard com as seguintes propriedades:

Nome Descrição
AssignedUserUuid O identificador do utilizador a quem é atribuído o smart card.
Atr A cadeia de carateres de resposta a reposição (ATR) do smart card para o cartão que está atualmente a ser inicializado.
Comentário O comentário que descreve o smart card.
Sinalizadores Os sinalizadores que descrevem o smart card.
Middleware O middleware do smart card.
ParentSmartcardUuid O identificador do smart card antigo que o smart card substituiu.
PermanentSmartcardUuid O identificador do smart card permanente associado ao smart card.
PrimarySmartcardUuid O identificador do smart card principal.
ProfileTemplateUuid O identificador do modelo de perfil que contém as políticas e definições que regem o smart card.
ProfileTemplateVersion A versão do modelo de perfil no momento em que o perfil do smart card foi criado.
SerialNumber O número de série do smart card.
Estado O estado do smart card.
Uuid O identificador do perfil do smart card.

Exemplo

Esta secção fornece um exemplo para obter perfis de smart card para um utilizador.

Exemplo: Pedido 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

Exemplo: Resposta 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Exemplo: Pedido 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Exemplo: Resposta 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Ver também