Compartilhar via


Obter resposta de autenticação de cartão inteligente

Obtém a resposta a um desafio de autenticação de CSP (provedor de serviços criptográficos) base.

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 da solicitação
Conseguir /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/authenticationresponse

Parâmetros de URL

Parâmetro Descrição
reqid Obrigatório O identificador de solicitação específico do CM (Gerenciamento de Certificados) do Microsoft Identity Manager (MIM).
scid Obrigatório O identificador de cartão inteligente específico do MIM CM. O scid é obtido do objeto Microsoft.Clm.Shared.Smartcards.Smartcard.

Parâmetros de consulta

Parâmetro Descrição
Atr Opcional. A cadeia de caracteres ATR (resposta a redefinição) do cartão inteligente.
cardid Obrigatório A ID do cartão inteligente.
desafio Obrigatório Uma cadeia de caracteres codificada em base 64 que representa o desafio emitido pelo cartão inteligente.
Diversificada Obrigatório Um sinalizador booliano indicando se a chave de administração do cartão inteligente foi diversificada.

Cabeçalhos de solicitação

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

Corpo da solicitação

Nenhum.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

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

Cabeçalhos de resposta

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

Corpo da resposta

Com êxito, retorna um BLOB de bytes que representa a resposta do desafio.

Exemplo

Esta seção fornece um exemplo para obter a resposta a um desafio de autenticação CSP base.

Exemplo: Solicitação

GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9/authenticationresponse?cardid=bc88f13f-83ba-4037-8262-46eba1291c6e&challenge=1hFD%2Bcz%2F0so%3D&diversified=False HTTP/1.1

Exemplo: Resposta

HTTP/1.1 200 OK

"F0Zudm4wPLY="

Consulte também