获取智能卡策略
获取指定工作流的配置文件模板策略。 此数据在请求创建期间使用。 工作流策略指定客户端为创建请求所需的数据。 数据可以包括各种数据收集项、请求注释和一次性密码策略。
注意
本文中的 URL 相对于在 API 部署期间选择的主机名，例如 https://api.contoso.com。
请求
| 方法 | 请求 URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
URL 参数
| 参数 | 说明 |
|---|---|
| id | 必需。 对应于从中提取策略的配置文件模板的 GUID。 |
| 类型 | 必需。 所请求策略的类型。 可能的值为“Enroll”、“Duplicate”、“OfflineUnblock”、“OnlineUpdate”、“Renew”、“Recover”、“RecoverOnBehalf”、“Reinstate”、“停用”、“撤销”、“TemporaryEnroll”和“取消阻止”。 |
请求标头
有关常见请求标头，请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。
请求正文
无。
响应
本部分介绍响应。
响应代码
| 代码 | 说明 |
|---|---|
| 200 | 确定 |
| 403 | 禁止 |
| 204 | 无内容 |
| 500 | 内部错误 |
响应标头
有关常见响应标头，请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。
响应正文
如果成功，将根据 ProfileTemplatePolicy 对象返回策略对象。 策略对象至少包含下表中的属性，但可以根据请求的策略包含其他属性。 例如，对注册策略的请求返回 一个 EnrollPolicy 对象。 有关详细信息，请参阅与请求中的 {type} 参数关联的策略对象的文档。 可以在 Microsoft.Clm.Shared.ProfileTemplates 命名空间 文档中找到不同类型的策略对象的文档。
| 属性 | 说明 |
|---|---|
| ApprovalsNeeded | Forefront Identity Manager (FIM) 证书管理 (CM) 策略请求所需的批准数。 |
| AuthorizedApprover | 针对有权批准策略的 FIM CM 请求的用户的安全描述符。 |
| AuthorizedEnrollmentAgent | 针对充当策略注册代理的用户的安全描述符。 |
| AuthorizedInitiator | 针对可以启动策略的 FIM CM 请求的用户的安全描述符。 |
| CollectComments | 指示是否为策略的 FIM CM 请求启用注释集合的布尔值。 |
| CollectRequestPriority | 指示是否为策略的 FIM CM 请求启用请求优先级集合的布尔值。 |
| DefaultRequestPriority | 策略的 FIM CM 请求的默认优先级。 |
| 文档 | 为策略配置的策略文档。 |
| 已启用 | 指示是否启用了策略的布尔值。 |
| EnrollAgentRequired | 指示策略的 FIM CM 请求是否需要注册代理的布尔值。 |
| OneTimePasswordPolicy | 策略 FIM CM 请求的一次性密码的分发方法。 |
| 个性化 | 策略的智能卡个性化设置选项。 |
| PolicyDataCollection | 与策略关联的数据集合项。 |
| SelfServiceEnabled | 指示是否为策略的 FIM CM 请求启用自助服务启动的布尔值。 |
示例
本部分提供了获取工作流的配置文件模板策略的示例。
示例：请求 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
示例：响应 1
HTTP/1.1 200 OK
... body coming soon
示例：请求 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
示例：响应 2
HTTP/1.1 200 OK
... body coming soon