Sdílet prostřednictvím


Získání navrhovaného PIN kódu čipové karty

Získá serverem vygenerovaný pin kód uživatele.

Důležité

Server nastaví PIN kód jenom v případě, že zásada šablony profilu indikuje, že se má provést. V opačném případě by měl uživatel zadat PIN kód.

Poznámka

Adresy URL v tomto článku jsou relativní k názvu hostitele zvolenému během nasazování rozhraní API, například https://api.contoso.com.

Žádost

Metoda Adresa URL požadavku
GET /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

Parametry adresy URL

Parametr Popis
id ID čipové karty specifické pro správu certifikátů Microsoft Identity Manager (MIM). ID se získá z objektu Microsft.Clm.Shared.Smartcard.

Parametry dotazů

Parametr Popis
Atr Řetězec ATR (answer-to-reset) čipové karty.
cardid ID čipové karty.
Výzva Řetězec kódovaný jako base-64 představující výzvu vystavenou čipovou kartou.

Hlavičky požadavku

Běžné hlavičky požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.

Text požadavku

Žádné

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód Description
200 OK
204 Žádný obsah
403 Forbidden
500 Vnitřní chyba

Hlavičky odpovědi

Běžné hlavičky odpovědi najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.

Text odpovědi

V případě úspěchu vrátí řetězec, který představuje KÓD PIN navržený serverem.

Příklad

Tato část obsahuje příklad, jak získat serverem vygenerovaný PIN kód uživatele.

Příklad: Žádost

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

Příklad: Odpověď

HTTP/1.1 200 OK

... body coming soon