取得智慧卡提議的 PIN

取得伺服器產生的使用者 PIN。

重要

只有當設定檔範本原則指出應該這麼做時,伺服器才會設定 PIN。 否則,使用者應該提供 PIN。

注意

本文中的 Url 會相對於 API 部署期間所選擇的主機名稱,例如 https://api.contoso.com

要求

方法 要求 URL
GET /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

URL 參數

參數 描述
id Microsoft Identity Manager (MIM) 憑證管理 (CM) 專用的智慧卡識別碼。 此識別碼是取自 Microsft. Clm. 共用的智慧卡物件。

查詢參數

參數 Description
atr 智慧卡的重設回應 (ATR) 字串。
cardid 智慧卡識別碼。
challenge Base-64 編碼的字串,代表智慧卡所發出的挑戰。

要求標頭

關於常見的要求標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

要求本文

無。

回應

本節說明回應。

回應碼

程式碼 描述
200 [確定]
204 沒有內容
403 禁止
500 內部錯誤

回應標頭

關於常見的回應標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

回應本文

成功時,會傳回字串,表示伺服器所提議的 PIN。

範例

本節提供的範例可讓您取得伺服器產生的使用者 PIN。

範例:要求

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

範例:回應

HTTP/1.1 200 OK

... body coming soon