Uzyskiwanie zasad karty inteligentnej

Pobiera zasady szablonu profilu dla określonego przepływu pracy. Te dane są używane podczas tworzenia żądania. Zasady przepływu pracy określają, które dane są wymagane przez klienta w celu utworzenia żądania. Dane mogą obejmować różne elementy zbierania danych, komentarze do żądań i zasady haseł jedno raz.

Uwaga

Adresy URL w tym artykule są względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej 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óry 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 uzyskać typowe nagłówki żądań, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

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

Aby uzyskać typowe nagłówki odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść odpowiedzi

W przypadku powodzenia zwraca obiekt zasad na podstawie obiektu ProfileTemplatePolicy. Obiekt zasad zawiera przynajmniej właściwości z 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
ZatwierdzeniaJedno Liczba zatwierdzeń, które są wymagane dla żądań zarządzania certyfikatami programu Forefront Identity Manager (FIM) dla zasad.
AuthorizedApprover Deskryptor zabezpieczeń dla użytkowników, którzy są autoryzowani do zatwierdzania żądań zarządzania zasadami FIM dla zasad.
AuthorizedEnrollmentAgent Deskryptor zabezpieczeń dla użytkowników, którzy mogą działać jako agenci rejestracji dla zasad.
AuthorizedInitiator Deskryptor zabezpieczeń dla użytkowników, którzy mogą inicjować żądania cmdli fim dla zasad.
CollectComments Wartość logiczna, która wskazuje, czy kolekcja komentarzy jest włączona dla żądań cmdelek fim dla zasad.
CollectRequestPriority Wartość logiczna wskazująca, czy kolekcja priorytetów żądań jest włączona dla żądań cmdelek fim dla zasad.
DefaultRequestPriority Domyślny priorytet żądań programu FIM CM dla zasad.
Dokumenty Dokumenty zasad, które są skonfigurowane dla zasad.
Enabled (Włączony) Wartość logiczna wskazująca, czy zasady są włączone.
EnrollAgentRequired Wartość logiczna wskazująca, czy agenci rejestracji są wymagani dla żądań zarządzania certyfikatami programu FIM dla zasad.
OneTimePasswordPolicy Metoda dystrybucji haseł do zasad w przypadku żądań menedżerów zarządzania programem FIM.
Personalizacja Opcje personalizacji karty inteligentnej dla zasad.
PolicyDataCollection Elementy zbierania danych skojarzone z zasadami.
SelfServiceEnabled Wartość logiczna wskazująca, czy dla zasad jest włączona samoobsługowa inicjacja żądań CM fim.

Przykład

Ta sekcja zawiera przykład, w których można pobrać zasady 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ż