获取建议的智能卡 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 的智能卡 ID) 证书管理 (CM) 。 ID 是从 Microsft.Clm.Shared.Smartcard 对象获取的。 |
查询参数
| 参数 | 说明 |
|---|---|
| atr | 智能卡复位应答 (ATR) 字符串。 |
| cardid | 智能卡 ID。 |
| 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