Pobieranie zasad przepływu pracy

  • Artykuł

Pobiera zasady szablonu profilu dla określonego przepływu pracy. Dane są używane podczas tworzenia żądania. Zasady przepływu pracy określają, które dane są potrzebne przez klienta w celu utworzenia żądania. Dane mogą zawierać różne elementy zbierania danych, żądać komentarzy i zasady jednorazowego hasła.

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type}

Parametry URL

Parametr Opis
identyfikator Wymagane. Identyfikator GUID odpowiadający szablonowi profilu, z którego mają zostać wyodrębnione zasady.
typ Wymagane. Typ żądanych zasad. Możliwe wartości to "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" i "Unblock".

Nagłówki żądań

Aby zapoznać się z typowymi nagłówkami żądań, zobacz Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
403 Forbidden
204 Brak zawartości
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Typowe nagłówki odpowiedzi można znaleźć w temacie Http request and response headers in CM REST API details (Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją).

Treść odpowiedzi

Po powodzeniu zwraca obiekt zasad oparty na obiekcie ProfileTemplatePolicy . Co najmniej obiekt zasad zawiera właściwości w poniższej tabeli, ale może zawierać dodatkowe właściwości w zależności od żądanych zasad. Na przykład żądanie zasad rejestracji zwraca obiekt EnrollPolicy . Aby uzyskać więcej informacji, zobacz dokumentację obiektu zasad skojarzonego z parametrem {type} w żądaniu. Dokumentację różnych typów obiektów zasad można znaleźć w dokumentacji przestrzeni nazw Microsoft.Clm.Shared.ProfileTemplates .

Właściwość Opis
ZatwierdzeniaNowe Liczba zatwierdzeń wymaganych dla żądań zarządzania certyfikatami programu Forefront Identity Manager (CM) dla zasad.
Autoryzowanie aplikacji Deskryptor zabezpieczeń dla użytkowników, którzy mają autoryzację do zatwierdzania żądań programu FIM CM dla zasad.
AuthorizedEnrollmentAgent Deskryptor zabezpieczeń dla użytkowników, którzy mogą pełnić rolę agentów rejestracji dla zasad.
AuthorizedInitiator Deskryptor zabezpieczeń dla użytkowników, którzy mogą inicjować żądania programu FIM CM dla zasad.
CollectComments Wartość logiczna wskazująca, czy dla żądań zarządzania kluczami programu FIM dla zasad jest włączona kolekcja komentarzy.
CollectRequestPriority Wartość logiczna wskazująca, czy kolekcja priorytetu żądania jest włączona dla żądań cm programu FIM dla zasad.
DefaultRequestPriority Domyślny priorytet żądań programu FIM CM dla zasad.
Dokumenty Dokumenty zasad skonfigurowane dla zasad.
Enabled (Włączony) Wartość logiczna wskazująca, czy zasady są włączone.
EnrollAgentRequired Wartość logiczna wskazująca, czy agenci rejestracji są zobowiązani do obsługi żądań zarządzania kluczami programu FIM dla zasad.
OneTimePasswordPolicy Metoda dystrybucji jednorazowych haseł dla żądań programu FIM CM dla zasad.
Personalizacja Opcje personalizacji kart inteligentnych dla zasad.
PolicyDataCollection Elementy zbierania danych skojarzone z zasadami.
SelfServiceEnabled Wartość logiczna wskazująca, czy dla zasad włączono samoobsługowe inicjowanie żądań cm programu FIM.

Przykład

Ta sekcja zawiera przykład pobierania zasad szablonu profilu dla przepływu pracy.

Przykład: żądanie 1

GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1

Przykład: Odpowiedź 1

HTTP/1.1 200 OK

... body coming soon

Przykład: Żądanie 2

GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1

Przykład: Odpowiedź 2

HTTP/1.1 200 OK

... body coming soon

Zobacz też