Principen för smartkortGet Smartcard Policy

Hämtar princip för profilen mallar för angivet arbetsflöde.Gets the profile template policy for the specified workflow. Dessa data används när begäran skapades.This data is used during request creation. Arbetsflödet principen anger vilka data krävs av klienten för att skapa en förfrågan.The workflow policy specifies which data is needed by the client in order to create a request. Sådana data kan omfatta: olika datainsamlingsobjekt, begäran kommentarer och en tid lösenordsprincip.Such data may include: various data collection items, request comments, and one time password policy.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
GETGET / CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type}/CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type}

URL-parametrarURL Parameters

ParameterParameter BeskrivningDescription
IDid Obligatoriskt.Required. GUID som motsvarar profilmallen som principen ska extraheras från.The GUID corresponding to the profile template that the policy is to be extracted from.
typtype Obligatoriskt.Required. Vilken typ av princip som begärs.The type of policy being requested. Möjliga värden är: registrera, duplicera, OfflineUnblock, OnlineUpdate, förnya, återställa, RecoverOnBehalf, återställa, pensionera, återkalla, TemporaryEnroll, avblockera.Possible values are: Enroll, Duplicate, OfflineUnblock, OnlineUpdate, Renew, Recover, RecoverOnBehalf, Reinstate, Retire, Revoke, TemporaryEnroll, Unblock.

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

BegärandetextenRequest Body

ingetnone

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
200200 OKOK
403403 Tillåts inteForbidden
204204 Inget innehållNo content
500500 Internt felInternal Error

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

SvarstextenResponse Body

Returnerar ett grupprincipobjekt baserat på om åtgärden lyckades kan en ProfileTemplatePolicy objekt.On success, returns a policy object based on a ProfileTemplatePolicy object. Minst principobjektet innehåller egenskaper i tabellen nedan, men kan innehålla ytterligare egenskaper beroende på den princip som begärdes.At a minimum, the policy object will contain the properties in the following table, but may contain additional properties depending on the policy requested. Till exempel en begäran om en princip för registrera returneras en EnrollPolicy objekt.For example, a request for an enroll policy will return an EnrollPolicy object. Mer information finns i dokumentationen för principobjektet som är associerade med parametern {type} i begäran.For more information, see the documentation for the policy object associated with the {type} parameter in the request. I dokumentationen för de olika typerna av principobjekt finns under den Microsoft.Clm.Shared.ProfileTemplates Namespace dokumentation.The documentation for the different types of policy objects can be found under the Microsoft.Clm.Shared.ProfileTemplates Namespace documentation.

EgenskapProperty BeskrivningDescription
ApprovalsNeededApprovalsNeeded Antal godkännanden som krävs för FIM CM-begäranden för principen.The number of approvals that are required for FIM CM requests for the policy.
AuthorizedApproverAuthorizedApprover Säkerhetsbeskrivningen för användare som har behörighet att godkänna FIM CM-begäranden för principen.The security descriptor for users who are authorized to approve FIM CM requests for the policy.
AuthorizedEnrollmentAgentAuthorizedEnrollmentAgent Säkerhetsbeskrivningen för användare som kan fungera som registreringsagenter för principen.The security descriptor for users who can act as enrollment agents for the policy.
AuthorizedInitiatorAuthorizedInitiator Säkerhetsbeskrivningen för användare som kan initiera FIM CM-begäranden för principen.The security descriptor for users who can initiate FIM CM requests for the policy.
CollectCommentsCollectComments Ett booleskt värde som anger om kommentar samlingen är aktiverad för FIM CM-begäranden för principen.A Boolean value that indicates if comment collection is enabled for FIM CM requests for the policy.
CollectRequestPriorityCollectRequestPriority Ett booleskt värde som anger om prioritet request-samlingen för FIM CM-begäranden för principen är aktiverad.A Boolean value that indicates if request priority collection is enabled for FIM CM requests for the policy.
DefaultRequestPriorityDefaultRequestPriority Standardprioritet för FIM CM-begäranden för principen.The default priority for FIM CM requests for the policy.
DokumentDocuments De principdokument som är konfigurerade för principen.The policy documents that are configured for the policy.
AktiveradEnabled Ett booleskt värde som anger om principen är aktiverad.A Boolean value that indicates if the policy is enabled.
EnrollAgentRequiredEnrollAgentRequired Ett booleskt värde som anger om registreringsagenter krävs för FIM CM-begäranden för principen.A Boolean value that indicates if enrollment agents are required for FIM CM requests for the policy.
OneTimePasswordPolicyOneTimePasswordPolicy Hämtar hur engångslösenord för FIM CM-begäranden för principen distribueras.Gets how one-time passwords for FIM CM requests for the policy are distributed.
AnpassningPersonalization Smartkort anpassningsalternativ för principen.The smart card personalization options for the policy.
PolicyDataCollectionPolicyDataCollection Dataobjekt som är associerade med principen för samlingen.The data collection items that are associated with the policy.
SelfServiceEnabledSelfServiceEnabled Ett booleskt värde som anger om självbetjäning initiering av FIM CM-begäranden är aktiverad för principen.A Boolean value that indicates if self-service initiation of FIM CM requests is enabled for the policy.

ExempelExample

Begäran 1Request 1

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

Svar 1Response 1

HTTP/1.1 200 OK

... body coming soon

Förfrågan 2Request 2

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

Svar 2Response 2

HTTP/1.1 200 OK

... body coming soon

Se ävenSee Also