Abrufen der vorgeschlagenen Smartcard-PIN
Ruft die vom Server generierte PIN eines Benutzers ab.
Wichtig
Der Server legt die PIN nur fest, wenn die Profilvorlagenrichtlinie angibt, dass dies erfolgen 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 https://api.contoso.com. B. .
Anforderung
| Methode | Anforderungs-URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin |
URL-Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| id | Die Smartcard-ID, die für Microsoft Identity Manager (MIM) Certificate Management (CM) spezifisch ist. Die ID wird aus dem Microsft.Clm.Shared.Smartcard-Objekt abgerufen. |
Abfrageparameter
| Parameter | BESCHREIBUNG |
|---|---|
| atr | Die ATR-Zeichenfolge (Antwort zum Zurücksetzen) der Smartcard. |
| cardid | Die Smartcard-ID. |
| challenge | Eine Base64-codierte Zeichenfolge, die die Von der Smartcard ausgegebene Herausforderung darstellt. |
Anforderungsheader
Informationen zu gängigen Anforderungsheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anforderungstext
Keine.
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 200 | OK |
| 204 | Kein Inhalt |
| 403 | Verboten |
| 500 | Interner Fehler |
Antwortheader
Informationen zu allgemeinen Antwortheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antworttext
Gibt bei Erfolg eine Zeichenfolge zurück, die die vom Server vorgeschlagene PIN darstellt.
Beispiel
Dieser Abschnitt enthält ein Beispiel zum Abrufen der vom Server generierten 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