取得指定工作流程的配置檔範本原則。 數據會在要求建立期間使用。 工作流程原則會指定用戶端需要哪些數據,才能建立要求。 數據可以包含各種數據收集專案、要求批注和一次性密碼原則。
備註
本文中的 URL 相對於 API 部署期間所選擇的主機名,例如 https://api.contoso.com。
請求
| 方法 | 請求 URL |
|---|---|
| 獲取 | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
URL 參數
| 參數 | 說明 |
|---|---|
| 識別碼 | 必須的。 對應至要從中擷取原則之配置檔範本的 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