Obter PIN proposto por smart card
Obtém o PIN de utilizador gerado pelo servidor.
Importante
O servidor só define o PIN se a política de modelo de perfil indicar que deve ser feito. Caso contrário, o utilizador deve fornecer o PIN.
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/{id}/serverproposedpin |
Parâmetros de URL
| Parâmetro | Descrição |
|---|---|
| ID | O ID do smart card específico da Gestão de Certificados (CM) Microsoft Identity Manager (MIM). O ID é obtido a partir do objeto Microsft.Clm.Shared.Smartcard. |
Parâmetros de consulta
| Parâmetro | Description |
|---|---|
| atr | A cadeia de resposta a reposição (ATR) do smart card. |
| cardid | O ID do smart card. |
| desafio | Uma cadeia codificada de base 64 que representa o desafio emitido pelo 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 cadeia que representa o PIN proposto pelo servidor.
Exemplo
Esta secção fornece um exemplo para obter o PIN de utilizador gerado pelo servidor.
Exemplo: Pedido
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