获取指定工作流的配置文件模板策略。 数据在请求创建过程中使用。 工作流策略指定客户端需要哪些数据才能创建请求。 数据可以包括各种数据收集项、请求注释和一次性密码策略。
注释
本文中的 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”、“Retire”、“Revoke”、“TemporaryEnroll”和“Unblock”。 |
请求标头
有关常见请求标头,请参阅 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