获取智能卡建议 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 证书管理的 (ID) 。 ID 从 Microsft.Clm.Shared.Smartcard 对象获取。

查询参数

参数 说明
atr 智能卡复位应答 (ATR) 字符串。
cardid 智能卡 ID。
challenge base-64 编码字符串,表示智能卡发出的挑战。

请求标头

有关常见请求标头,请参阅 CM 中的 HTTP 请求和响应标头REST API 服务详细信息

请求正文

无。

响应

本部分介绍响应。

响应代码

代码 说明
200 确定
204 无内容
403 禁止
500 内部错误

响应头

有关常见的响应标头,请参阅CM 中的 HTTP 请求和响应标头REST API服务详细信息

响应正文

成功后,返回表示服务器建议的 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