Hämta den föreslagna PIN-koden för smartkort
Hämtar den servergenererade användar-PIN-koden.
Viktigt
Servern anger endast PIN-koden om profilmallsprincipen anger att den ska göras. Annars bör användaren ange PIN-koden.
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/smartcards/{id}/serverproposedpin |
URL-parametrar
| Parameter | Beskrivning |
|---|---|
| id | Smartkorts-ID:t som är specifikt för Microsoft Identity Manager (MIM) Certificate Management (CM). ID:t hämtas från objektet Microsft.Clm.Shared.Smartcard. |
Frågeparametrar
| Parameter | Beskrivning |
|---|---|
| Atr | Smartkortssträngen answer-to-reset (ATR). |
| cardid | Smartkorts-ID:t. |
| Utmaning | En base-64-kodad sträng som representerar utmaningen som utfärdas av smartkortet. |
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 returnerar en sträng som representerar den PIN-kod som föreslås av servern.
Exempel
Det här avsnittet innehåller ett exempel för att hämta den servergenererade användar-PIN-koden.
Exempel: Begäran
GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1
Exempel: Svar
HTTP/1.1 200 OK
... body coming soon