Ottenere il PIN proposto per la smart card
Ottiene il PIN utente generato dal server
Importante
Il server imposta il PIN solo se il criterio del modello di profilo indica che deve essere eseguita. In caso contrario, l'utente deve fornire il PIN.
Nota
Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.
Richiesta
| Metodo | URL richiesta |
|---|---|
| GET | /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin |
Parametri URL
| Parametro | Descrizione |
|---|---|
| id | L'ID della smart card specifico per la gestione dei certificati (CM) di Microsoft Identity Manager (MIM). L'ID viene ottenuto dall'oggetto Microsft.Clm.Shared.Smartcard. |
Parametri di query
| Parametro | Descrizione |
|---|---|
| atr | Stringa ATR (Answer-To-Reset) della smart card. |
| cardid | ID smart card. |
| challenge | Stringa con codifica base 64 che rappresenta la richiesta rilasciata dalla smart card. |
Intestazioni della richiesta
Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.
Testo della richiesta
Nessuno.
Risposta
Questa sezione descrive la risposta.
Codici di risposta
| Codice | Descrizione |
|---|---|
| 200 | OK |
| 204 | Nessun contenuto |
| 403 | Accesso negato |
| 500 | Errore interno |
Intestazioni di risposta
Per le intestazioni di risposta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.
Corpo della risposta
In caso di esito positivo, restituisce una stringa che rappresenta il PIN proposto dal server.
Esempio
Questa sezione fornisce un esempio per ottenere il PIN utente generato dal server.
Esempio: Richiesta
GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1
Esempio: Risposta
HTTP/1.1 200 OK
... body coming soon