取得智慧卡原則

取得指定的工作流程的設定檔範本原則。 要求建立期間會使用此資料。 工作流程原則指定用戶端需要哪些資料來建立要求。 資料可以包含各種資料收集專案、要求批註和單次密碼原則。

注意

本文中的 Url 會相對於 API 部署期間所選擇的主機名稱,例如 https://api.contoso.com

要求

方法 要求 URL
GET /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type}

URL 參數

參數 描述
id 必要。 GUID 對應於要從中擷取原則的設定檔範本。
類型 必要。 所要求的原則類型。 可能的值為「註冊」、「重複」、「OfflineUnblock」、「OnlineUpdate」、「續約」、「復原」、「RecoverOnBehalf」、「恢復」、「淘汰」、「撤銷」、「TemporaryEnroll」和「解除封鎖」。

要求標頭

關於常見的要求標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

要求本文

無。

回應

本節說明回應。

回應碼

程式碼 描述
200 [確定]
403 禁止
204 沒有內容
500 內部錯誤

回應標頭

關於常見的回應標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

回應本文

成功時,會傳回以 ProfileTemplatePolicy 物件為基礎的原則物件。 原則物件至少會包含下表中的屬性,但可包含其他屬性(視要求的原則而定)。 例如,註冊原則的要求會傳回 EnrollPolicy 物件。 如需詳細資訊,請參閱要求中 {type} 參數相關聯的原則物件文件。 您可以在 Clm 命名空間 檔中找到不同類型的原則目的檔。

屬性 描述
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

另請參閱