Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft die Profilvorlagenrichtlinie für den angegebenen Workflow ab. Diese Daten werden während der Anforderungserstellung verwendet. Die Workflowrichtlinie gibt an, welche Daten vom Client benötigt werden, um eine Anforderung zu erstellen. Die Daten können verschiedene Datensammlungselemente, Anforderungskommentare und eine einmalige Kennwortrichtlinie enthalten.
Hinweis
Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.
Anfrage
| Methode | Anforderungs-URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
URL-Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| id | Erforderlich. Die GUID, die der Profilvorlage entspricht, aus der die Richtlinie extrahiert werden soll. |
| Typ | Erforderlich. Der Typ der angeforderten Richtlinie. Die möglichen Werte sind „Anmelden“, „Duplizieren“, „Offline entsperren“, „Online aktualisieren“, „Erneuern“, „Wiederherstellen“, „Wiederherstellen im Auftrag“, „Wiedereinsetzen“, „Zurückziehen“, „Widerrufen“, „Temporär anmelden“ und „Entsperren“. |
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anforderungstext
Keiner.
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 200 | OKAY |
| 403 | Verboten |
| 204 | Kein Inhalt |
| 500 | Interner Fehler |
Antwortheader
Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antworttext
Gibt bei Erfolg ein Richtlinienobjekt zurück, das auf einem ProfileTemplatePolicy-Objekt basiert. Das Richtlinienobjekt enthält mindestens die Eigenschaften in der folgenden Tabelle, kann jedoch abhängig von der angeforderten Richtlinie zusätzliche Eigenschaften enthalten. Beispielsweise gibt eine Anforderung für eine Registrierungsrichtlinie ein EnrollPolicy-Objekt zurück. Weitere Informationen finden Sie in der Dokumentation für das Richtlinienobjekt, das dem {type}-Parameter in der Anforderung zugeordnet ist. Die Dokumentation für die verschiedenen Arten von Richtlinienobjekten finden Sie in der Microsoft.Clm.Shared.ProfileTemplates-Namespace Dokumentation.
| Eigentum | BESCHREIBUNG |
|---|---|
| GenehmigungenErforderlich | Die Anzahl der Genehmigungen, die für Forefront Identity Manager (FIM) Certificate Management (CM) Anfragen für die Richtlinie erforderlich sind. |
| AuthorizedApprover | Die Sicherheitsbeschreibung für Benutzer, die berechtigt sind, FIM CM-Anforderungen für die Richtlinie zu genehmigen. |
| Autorisierter Einschreibungsagent | Der Sicherheitsdeskriptor für Benutzer, die als Registrierungs-Agents für die Richtlinie fungieren können. |
| AuthorizedInitiator | Die Sicherheitsbeschreibung für Benutzer, die FIM CM-Anforderungen für die Richtlinie initiieren können. |
| KommentareSammeln | Ein Boolescher Wert, der angibt, ob die Sammlung von Kommentaren für FIM CM-Anforderungen für die Richtlinie aktiviert ist. |
| CollectRequestPriority | Ein boolescher Wert, der angibt, ob die Anforderungsprioritätssammlung für FIM CM-Anforderungen für die Richtlinie aktiviert ist. |
| DefaultRequestPriority | Die Standardpriorität für FIM CM-Anforderungen für die Richtlinie. |
| Dokumente | Die Richtliniendokumente, die für die Richtlinie konfiguriert sind. |
| Aktiviert | Ein boolescher Wert, der angibt, ob die Richtlinie aktiviert ist. |
| EnrollAgentRequired | Ein boolescher Wert, der angibt, ob für FIM CM-Anforderungen für die Richtlinie Enrollment Agents erforderlich sind. |
| OneTimePasswordPolicy | Die Verteilungsmethode für Einmalpasswörter für FIM CM-Anforderungen für die Richtlinie. |
| Personalisierung | Die Smartcard-Personalisierungsoptionen für die Richtlinie. |
| Richtliniendatensammlung | Die Datensammlungselemente, die der Richtlinie zugeordnet sind. |
| SelfServiceEnabled | Ein boolescher Wert, der angibt, ob die Self-Service-Initiierung von FIM CM-Anforderungen für die Richtlinie aktiviert ist. |
Beispiel
In diesem Abschnitt finden Sie ein Beispiel für die Abfrage der Profilvorlagenrichtlinie für einen Workflow.
Beispiel: Anforderung 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
Beispiel: Antwort 1
HTTP/1.1 200 OK
... body coming soon
Beispiel: Anforderung 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
Beispiel: Antwort 2
HTTP/1.1 200 OK
... body coming soon