Condividi tramite


Ottenere i criteri del flusso di lavoro

Ottiene i criteri del modello di profilo per un flusso di lavoro specificato. I dati vengono usati durante la creazione della richiesta. I criteri del flusso di lavoro specificano i dati necessari per il client per creare una richiesta. I dati possono includere vari elementi di raccolta dati, commenti delle richieste e criteri di password monouso.

Nota

Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.

Richiesta

Metodo URL richiesta
GET /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type}

Parametri URL

Parametro Descrizione
id Obbligatorio. GUID corrispondente al modello di profilo da cui estrarre i criteri.
tipo Obbligatorio. Tipo di criterio richiesto. I valori possibili sono "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" e "Unblock".

Header di richiesta

Per le intestazioni di richiesta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice Descrizione
200 Va bene
403 Vietato
204 Nessun contenuto
500 Errore interno

Intestazioni di risposta

Per le intestazioni di risposta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Corpo della risposta

In caso di esito positivo, restituisce un oggetto criteri basato su un oggetto profileTemplatePolicy . Come minimo, l'oggetto criteri contiene le proprietà nella tabella seguente, ma può contenere proprietà aggiuntive a seconda dei criteri richiesti. Ad esempio, una richiesta di un criterio di registrazione restituisce un oggetto EnrollPolicy. Per altre informazioni, vedere la documentazione relativa all'oggetto criteri associato al parametro {type} nella richiesta. La documentazione relativa ai diversi tipi di oggetti criteri è disponibile nella documentazione spazio dei nomi Microsoft.Clm.Shared.ProfileTemplates.

Proprietà Descrizione
ApprovazioniNeeded Numero di approvazioni necessarie per le richieste di Gestione certificati FIM (FIM) per i criteri.
AuthorizedApprover Descrittore di sicurezza per gli utenti autorizzati ad approvare le richieste CM FIM per il criterio.
AuthorizedEnrollmentAgent Descrittore di sicurezza per gli utenti che possono agire come agenti di registrazione per i criteri.
AuthorizedInitiator Descrittore di sicurezza per gli utenti che possono avviare richieste CM FIM per il criterio.
CollectComments Valore booleano che indica se la raccolta di commenti è abilitata per le richieste CM FIM per i criteri.
CollectRequestPriority Valore booleano che indica se la raccolta di priorità della richiesta è abilitata per le richieste CM FIM per i criteri.
DefaultRequestPriority Priorità predefinita per le richieste CM FIM per i criteri.
Documenti Documenti dei criteri configurati per il criterio.
Attivata Valore booleano che indica se il criterio è abilitato.
EnrollAgentRequired Valore booleano che indica se gli agenti di registrazione sono necessari per le richieste CM FIM per i criteri.
OneTimePasswordPolicy Metodo di distribuzione per le password monouso per le richieste CM FIM per i criteri.
Personalizzazione Opzioni di personalizzazione delle smart card per i criteri.
PolicyDataCollection Elementi della raccolta dati associati ai criteri.
SelfServiceEnabled Valore booleano che indica se l'avvio self-service delle richieste CM FIM è abilitato per il criterio.

Esempio

Questa sezione fornisce un esempio per ottenere i criteri del modello di profilo per un flusso di lavoro.

Esempio: Richiesta 1

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

Esempio: Risposta 1

HTTP/1.1 200 OK

... body coming soon

Esempio: Richiesta 2

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

Esempio: Risposta 2

HTTP/1.1 200 OK

... body coming soon

Vedere anche