Obter perfis de smart card

Artigo
09/14/2023

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

Microsoft.Clm.Shared.Smartcards.Smartcard class (Classe Microsoft.Clm.Shared.Smartcards.Smartcard)

Partilhar via