Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft die vom Server generierte Benutzer-PIN ab.
Wichtig
Der Server legt die PIN nur fest, wenn die Profilvorlagenrichtlinie angibt, dass sie ausgeführt werden soll. Andernfalls sollte der Benutzer die PIN angeben.
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/smartcards/{id}/serverproposedpin |
URL-Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| id | Die Smartcard-ID, die für die Microsoft Identity Manager (MIM)-Zertifikatverwaltung (CM) spezifisch ist. Die ID wird aus dem Microsft.Clm.Shared.Smartcard-Objekt abgerufen. |
Abfrageparameter
| Parameter | BESCHREIBUNG |
|---|---|
| Atr | Die Smartcard-Antwort-zu-Zurücksetzungszeichenfolge (ATR). |
| cardid | Die Smartcard-ID. |
| Herausforderung | Eine base64-codierte Zeichenfolge, die die Herausforderung darstellt, die von der Smartcard ausgegeben wird. |
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 eine Zeichenfolge zurück, die die vom Server vorgeschlagene PIN darstellt.
Beispiel
Dieser Abschnitt enthält ein Beispiel zum Abrufen der servergenerierten Benutzer-PIN.
Beispiel: Anforderung
GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1
Beispiel: Antwort
HTTP/1.1 200 OK
... body coming soon