Intelligens kártya PIN-kód javasolt beolvasásaGet Smartcard Proposed PIN

A kiszolgáló által létrehozott felhasználói PIN-kód beolvasása.Gets the server-generated user PIN.

Megjegyzés:: A kiszolgáló állítja be a PIN-kód csak akkor, ha a profil sablonházirendjének azt jelzi, hogy el kell végezni.Note: The server will set the PIN only if the profile template policy indicates that it should be done. Ellenkező esetben a felhasználónak kell adja meg azt.Otherwise, the user should supply it.

Megjegyzés:: Ebben a témakörben látható URL-címek vannak viszonyítva; API telepítésekor kiválasztott állomásnév például: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

KérelemRequest

MódszerMethod Kérelem URL-címeRequest URL
GETGET /CertificateManagement/API/V1.0/smartcards/{ID}/serverproposedpin/CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

URL-cím ParaméterekURL Parameters

ParaméterParameter LeírásDescription
Azonosítójaid Az intelligens kártya azonosítója (MIM Tanúsítványkezelő specifikus).The smartcard identifier (MIM CM specific). A Microsft.Clm.Shared.Smartcard objektumot kapott.Obtained from the Microsft.Clm.Shared.Smartcard object.

Lekérdezés-paraméterekQuery Parameters

ParaméterParameter LeírásDescription
ATRatr A kártya atr.The card atr.
cardidcardid A kártya azonosítója.The card id.
kérdéschallenge A base-64 kódolású karakterlánc, amely a kihívás az intelligens kártya által kiadott.A base-64 encoded string representing the challenge issued by the smartcard.

Kérelem fejléceiRequest Headers

Közös kérelemfejléc, lásd: HTTP-kérelmek és válaszfejlécek a Tanúsítványkezelő REST API szolgáltatás részletei.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

Kérés törzsébenRequest Body

nincsnone

VálaszResponse

VálaszkódokResponse Codes

KódCode LeírásDescription
200200 OKOK
204204 Nincs tartalomNo content
403403 TiltottForbidden
500500 Belső hibaInternal Error

VálaszfejlécekResponse Headers

Közös válaszfejlécek, lásd: HTTP-kérelmek és válaszfejlécek a Tanúsítványkezelő REST API szolgáltatás részletei.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

VálasztörzsResponse Body

A sikeres a PIN-kódot, a kiszolgáló által javasolt jelölő karakterláncot ad vissza.On success, returns a string that represents the PIN proposed by the server.

PéldaExample

KérelemRequest

GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1

VálaszResponse

HTTP/1.1 200 OK

... body coming soon