Obter PIN proposto por cartão inteligente
Obtém o PIN do usuário gerado pelo servidor.
Importante
O servidor só definirá o PIN se a política de modelo de perfil indicar que ele deve ser feito. Caso contrário, o usuário deverá fornecer o PIN.
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 |
|---|---|
| GET | /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin |
Parâmetros de URL
| Parâmetro | Descrição |
|---|---|
| id | A ID do cartão inteligente específica para o GERENCIAMENTO de Certificados (CM) do MIM (Microsoft Identity Manager). A ID é obtida do objeto Microsft.Clm.Shared.Smartcard. |
Parâmetros de consulta
| Parâmetro | Descrição |
|---|---|
| atr | A cadeia de ATR (resposta para redefinição) do cartão inteligente. |
| cardid | A ID do cartão inteligente. |
| desafio | Uma cadeia de caracteres codificada em base 64 que representa o desafio emitido pelo cartão inteligente. |
Cabeçalhos da solicitação
Para cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.
Corpo da solicitação
Nenhum.
Resposta
Esta seçã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 cabeçalhos de resposta comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.
Corpo da resposta
Em caso de êxito, retorna uma cadeia de caracteres que representa o PIN proposto pelo servidor.
Exemplo
Esta seção fornece um exemplo para obter o PIN do usuário gerado pelo servidor.
Exemplo: Solicitação
GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1
Exemplo: resposta
HTTP/1.1 200 OK
... body coming soon