Hämta smartkortsprincip
Hämtar profilmallsprincipen för det angivna arbetsflödet. Dessa data används när begäran skapas. Arbetsflödesprincipen anger vilka data som krävs av klienten för att skapa en begäran. Data kan innehålla olika datainsamlingsobjekt, begärandekommenteringar och en engångslösenordsprincip.
Anteckning
URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.
Förfrågan
| Metod | Begärans-URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
URL-parametrar
| Parameter | Beskrivning |
|---|---|
| id | Krävs. DET GUID som motsvarar profilmallen som principen ska extraheras från. |
| typ | Krävs. Den typ av princip som begärs. Möjliga värden är "Registrera", "Duplicera", "OfflineUnblock", "OnlineUpdate", "Förnya", "Återställ", "RecoverOnBehalf", "Återställ", "Dra tillbaka", "Återkalla", "TemporaryEnroll" och "Avblockera". |
Begärandehuvuden
Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.
Begärandetext
Inga.
Svarsåtgärder
I det här avsnittet beskrivs svaret.
Svarskoder
| Kod | Description |
|---|---|
| 200 | OK |
| 403 | Förbjudet |
| 204 | Inget innehåll |
| 500 | Internt fel |
Svarshuvuden
Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.
Själva svaret
Vid lyckat resultat returnerar ett principobjekt baserat på ett ProfileTemplatePolicy-objekt . Principobjektet innehåller åtminstone egenskaperna i följande tabell, men kan innehålla ytterligare egenskaper beroende på vilken princip som begärs. En begäran om en registreringsprincip returnerar till exempel ett EnrollPolicy-objekt . Mer information finns i dokumentationen för principobjektet som är associerat med parametern {type} i begäran. Dokumentationen för de olika typerna av principobjekt finns i namnområdesdokumentationen Microsoft.Clm.Shared.ProfileTemplates .
| Egenskap | Beskrivning |
|---|---|
| GodkännandenNeeded | Antalet godkännanden som krävs för FÖRFRÅGNINGAR om CERTIFIKAThantering för Forefront Identity Manager (FIM) för principen. |
| AuthorizedApprover | Säkerhetsbeskrivning för användare som har behörighet att godkänna FIM CM-begäranden för principen. |
| AuthorizedEnrollmentAgent | Säkerhetsbeskrivning för användare som kan fungera som registreringsagenter för principen. |
| AuthorizedInitiator | Säkerhetsbeskrivning för användare som kan initiera FIM CM-begäranden för principen. |
| CollectComments | Ett booleskt värde som anger om kommentarssamlingen är aktiverad för FIM CM-begäranden för principen. |
| CollectRequestPriority | Ett booleskt värde som anger om begärandeprioritetssamling är aktiverad för FIM CM-begäranden för principen. |
| DefaultRequestPriority | Standardprioriteten för FIM CM-begäranden för principen. |
| Dokument | Principdokumenten som har konfigurerats för principen. |
| Enabled | Ett booleskt värde som anger om principen är aktiverad. |
| EnrollAgentRequired | Ett booleskt värde som anger om registreringsagenter krävs för FIM CM-begäranden för principen. |
| OneTimePasswordPolicy | Distributionsmetoden för engångslösenord för FIM CM-begäranden för principen. |
| Anpassning | Anpassningsalternativ för smartkort för principen. |
| PolicyDataCollection | De datainsamlingsobjekt som är associerade med principen. |
| SelfServiceEnabled | Ett booleskt värde som anger om självbetjäningsinitiering av FIM CM-begäranden är aktiverat för principen. |
Exempel
Det här avsnittet innehåller ett exempel för att hämta profilmallsprincipen för ett arbetsflöde.
Exempel: Begäran 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
Exempel: Svar 1
HTTP/1.1 200 OK
... body coming soon
Exempel: Begäran 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
Exempel: Svar 2
HTTP/1.1 200 OK
... body coming soon