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 einen angegebenen Workflow ab. Die 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 |
|---|---|
| ERHALTEN/Bekommen | /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. |
| type | Erforderlich. Der Typ der richtlinie, die angefordert wird. Mögliche Werte sind "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover," "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" und "Unblock". |
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anfragekörper
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.
Antwortkörper
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 |
|---|---|
| ApprovalsNeeded | Die Anzahl der Genehmigungen, die für Forefront Identity Manager (FIM)-Zertifikatverwaltungsanforderungen (CM) für die Richtlinie erforderlich sind. |
| AuthorizedApprover | Der Sicherheitsdeskriptor für Benutzer, die berechtigt sind, FIM CM-Anforderungen für die Richtlinie zu genehmigen. |
| AuthorizedEnrollmentAgent | Der Sicherheitsdeskriptor für Benutzer, die als Registrierungs-Agents für die Richtlinie fungieren können. |
| AuthorizedInitiator | Der Sicherheitsdeskriptor für Benutzer, die FIM CM-Anforderungen für die Richtlinie initiieren können. |
| CollectComments | Ein boolescher Wert, der angibt, ob die Kommentarauflistung für FIM CM-Anforderungen für die Richtlinie aktiviert ist. |
| CollectRequestPriority | Ein boolescher Wert, der angibt, ob die Anforderungsprioritätsauflistung 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 Registrierungs-Agents für FIM CM-Anforderungen für die Richtlinie erforderlich sind. |
| OneTimePasswordPolicy | Die Verteilungsmethode für einmalige Kennwörter für FIM CM-Anforderungen für die Richtlinie. |
| Personalisierung | Die Smartcard-Personalisierungsoptionen für die Richtlinie. |
| PolicyDataCollection | 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
Dieser Abschnitt enthält ein Beispiel zum Abrufen 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