Abrufen eines diversifizierten Administratorschlüssels für Smartcards
Ruft den diversifizierten Administratorschlüssel für die angegebene Smartcard ab.
Wichtig
Der Administratorschlüssel sollte nur diversifiziert werden, wenn die Profilvorlagenrichtlinie angibt, dass er sein sollte.
Hinweis
Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.
Anfrage
| Methode | Anforderungs-URL |
|---|---|
| ERHALTEN/Bekommen | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/diversifiedkey |
URL-Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| reqid | Erforderlich. Der Anforderungsbezeichner, der für die Microsoft Identity Manager (MIM)-Zertifikatverwaltung (CM) spezifisch ist. |
| scid | Erforderlich. Der Smartcardbezeichner, der für MIM CM spezifisch ist. Die scid wird aus dem Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard-Objekt abgerufen. |
Abfrageparameter
| Parameter | BESCHREIBUNG |
|---|---|
| Atr | Wahlfrei. Die Smartcard-Antwort-zu-Zurücksetzungszeichenfolge (ATR). |
| cardid | Erforderlich. Die Karten-ID. |
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anfragekörper
Keiner.
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 200 | OKAY |
| 204 | Kein Inhalt |
| 403 | Verboten |
| 500 | Interner Fehler |
Antwortheader
Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antwortkörper
Gibt bei Erfolg ein Byte-BLOB zurück, das den diversifizierten Administratorschlüssel darstellt.
Beispiel
Dieser Abschnitt enthält ein Beispiel zum Abrufen des diversifizierten Administratorschlüssels für eine Smartcard.
Beispiel: Anforderung
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
Beispiel: Antwort
HTTP/1.1 200 OK
"mBVA+HopB/gc+6FuKsQqx+OX01hK1WQI"