Ottenere la chiave di amministrazione diversificata della smart card
Ottiene la chiave di amministrazione diversificata per la smart card specificata.
Importante
La chiave di amministrazione deve essere diversificata solo quando il criterio del modello di profilo indica che deve essere.
Nota
Gli URL di questo articolo sono relativi al nome host scelto durante la distribuzione api, ad esempio https://api.contoso.com.
Richiesta
| Metodo | URL richiesta |
|---|---|
| GET | /CertificateManagement/API/v1.0/Requests/{ReqID}/smartcards/{scid}/diversifiedkey |
Parametri URL
| Parametro | Descrizione |
|---|---|
| reqid | Obbligatorio. Identificatore di richiesta specifico per Microsoft Identity Manager (MIM) Certificate Management (CM). |
| scid | Obbligatorio. Identificatore della smart card specifico di MIM CM. La scid viene ottenuta dall'oggetto Microsoft.Clm.Shared.Smartcards.Smartcard . |
Parametri di query
| Parametro | Descrizione |
|---|---|
| atr | Facoltativa. Stringa ATR (Answer-To-Reset) della smart card. |
| cardid | Obbligatorio. ID scheda. |
Intestazioni della richiesta
Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta HTTP e risposta 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 HTTP e risposta nei dettagli del servizio API REST CM.
Corpo della risposta
In caso di esito positivo, restituisce un BLOB che rappresenta la chiave dell’amministratore diversificata in byte.
Esempio
Questa sezione fornisce un esempio per ottenere la chiave di amministrazione diversificata per una smart card.
Esempio: Richiesta
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9/diversifiedkey?cardid=bc88f13f-83ba-4037-8262-46eba1291c6e HTTP/1.1
Esempio: Risposta
HTTP/1.1 200 OK
"mBVA+HopB/gc+6FuKsQqx+OX01hK1WQI"