Získání zásad pracovního postupu
Získá zásady šablony profilu pro zadaný pracovní postup. Data se použijí při vytváření požadavku. Zásady pracovního postupu určují, která data klient potřebuje k vytvoření požadavku. Data můžou zahrnovat různé položky shromažďování dat, komentáře k žádostem a jednorázové zásady hesel.
Poznámka
Adresy URL v tomto článku jsou relativní k názvu hostitele zvolenému během nasazování rozhraní API, například https://api.contoso.com.
Žádost
| Metoda | Adresa URL požadavku |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
Parametry adresy URL
| Parametr | Popis |
|---|---|
| id | Povinná hodnota. Identifikátor GUID odpovídající šabloně profilu, ze které se má zásada extrahovat. |
| typ | Povinná hodnota. Typ požadované zásady. Možné hodnoty jsou "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recovery", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" a "Unblock". |
Hlavičky požadavku
Běžné hlavičky požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.
Text požadavku
Žádné
Odpověď
Tato část popisuje odpověď.
Kódy odpovědí
| Kód | Description |
|---|---|
| 200 | OK |
| 403 | Forbidden |
| 204 | Žádný obsah |
| 500 | Vnitřní chyba |
Hlavičky odpovědi
Běžné hlavičky odpovědi najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě CM REST API.
Text odpovědi
Při úspěchu vrátí objekt zásad, který je založený na objektu ProfileTemplatePolicy . Objekt zásady obsahuje minimálně vlastnosti v následující tabulce, ale v závislosti na požadované zásadě může obsahovat další vlastnosti. Například požadavek na zásadu registrace vrátí objekt EnrollPolicy . Další informace najdete v dokumentaci k objektu zásady přidruženému k parametru {type} v požadavku. Dokumentaci k různým typům objektů zásad najdete v dokumentaci k oboru názvů Microsoft.Clm.Shared.ProfileTemplates .
| Vlastnost | Popis |
|---|---|
| SchváleníNení | Počet schválení vyžadovaných pro žádosti o správu certifikátů (CM) nástroje Forefront Identity Manager (FIM) pro zásadu |
| AuthorizedApprover | Popisovač zabezpečení pro uživatele, kteří mají oprávnění schvalovat žádosti FIM CM pro zásady. |
| AuthorizedEnrollmentAgent | Popisovač zabezpečení pro uživatele, kteří můžou pro zásadu fungovat jako agenti registrace. |
| AuthorizedInitiator | Popisovač zabezpečení pro uživatele, kteří můžou inicializovat požadavky FIM CM pro zásadu. |
| CollectComments | Logická hodnota, která označuje, jestli je pro požadavky FIM CM pro zásadu povolené shromažďování komentářů. |
| CollectRequestPriority | Logická hodnota, která označuje, jestli je pro požadavky FIM CM pro zásadu povolené shromažďování priorit požadavků. |
| DefaultRequestPriority | Výchozí priorita požadavků FIM CM pro zásadu. |
| dokumenty. | Dokumenty zásad, které jsou nakonfigurované pro zásadu. |
| Povoleno | Logická hodnota, která označuje, jestli je zásada povolená. |
| EnrollAgentRequired | Logická hodnota, která určuje, jestli se pro požadavky FIM CM pro zásadu vyžadují agenti registrace. |
| OneTimePasswordPolicy | Metoda distribuce pro jednorázová hesla pro požadavky FIM CM pro zásadu. |
| Personalizace | Možnosti přizpůsobení čipové karty pro zásadu |
| PolicyDataCollection | Položky shromažďování dat, které jsou přidružené k zásadám. |
| SelfServiceEnabled | Logická hodnota, která označuje, jestli je pro zásadu povolené samoobslužné inicializace požadavků FIM CM. |
Příklad
Tato část obsahuje příklad získání zásad šablony profilu pro pracovní postup.
Příklad: Žádost 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
Příklad: Odpověď 1
HTTP/1.1 200 OK
... body coming soon
Příklad: Žádost 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
Příklad: Odpověď 2
HTTP/1.1 200 OK
... body coming soon