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