Hämta en diversifierad administratörsnyckel för smartkort
Hämtar den diversifierade administratörsnyckeln för det angivna smartkortet.
Viktigt
Administratörsnyckeln bör endast vara diversifierad när profilmallsprincipen anger att den ska vara det.
Anteckning
URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.
Förfrågan
| Metod | Begärans-URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/diversifiedkey |
URL-parametrar
| Parameter | Beskrivning |
|---|---|
| reqid | Krävs. Den begärandeidentifierare som är specifik för Microsoft Identity Manager (MIM) Certificate Management (CM). |
| Scid | Krävs. Smartkortidentifieraren som är specifik för MIM CM. SCID hämtas från objektet Microsoft.Clm.Shared.Smartcards.Smartcard . |
Frågeparametrar
| Parameter | Beskrivning |
|---|---|
| Atr | Valfritt. AtR-strängen (answer-to-reset) för smartkort. |
| cardid | Krävs. Kort-ID:t. |
Begärandehuvuden
Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.
Begärandetext
Inga.
Svarsåtgärder
I det här avsnittet beskrivs svaret.
Svarskoder
| Kod | Description |
|---|---|
| 200 | OK |
| 204 | Inget innehåll |
| 403 | Förbjudet |
| 500 | Internt fel |
Svarshuvuden
Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.
Själva svaret
Vid lyckat resultat returneras en byte-BLOB som representerar den diversifierade administratörsnyckeln.
Exempel
Det här avsnittet innehåller ett exempel för att hämta den diversifierade administratörsnyckeln för ett smartkort.
Exempel: Begäran
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
Exempel: Svar
HTTP/1.1 200 OK
"mBVA+HopB/gc+6FuKsQqx+OX01hK1WQI"