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. Il criterio di flusso di lavoro specifica i dati di cui il client necessita per creare una richiesta. I dati possono includere vari elementi di raccolta dati, commenti delle richieste e un criterio 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. Il GUID corrispondente al modello di profilo da cui deve essere estratto il criterio. |
| tipo | Obbligatorio. Tipo di criterio richiesto. I valori possibili sono "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" e "Unblock". |
Intestazioni della 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 | OK |
| 403 | Accesso negato |
| 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 per 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 dello spazio dei nomi Microsoft.Clm.Shared.ProfileTemplates .
| Proprietà | Descrizione |
|---|---|
| ApprovalsNeeded | Numero di approvazioni necessarie per le richieste di Gestione certificati (CM) di Forefront Identity Manager (FIM) per i criteri. |
| AuthorizedApprover | Il descrittore di sicurezza per gli utenti autorizzati ad approvare le richieste CM FIM per il criterio. |
| AuthorizedEnrollmentAgent | Il descrittore di sicurezza per gli utenti che possono fungere da agenti di registrazione per il criterio. |
| AuthorizedInitiator | Il descrittore di sicurezza per gli utenti che possono avviare le richieste CM FIM per il criterio. |
| CollectComments | Valore booleano che indica se l'insieme dei commenti è abilitato per le richieste CM FIM per il criterio. |
| CollectRequestPriority | Valore booleano che indica se l'insieme delle priorità delle richieste abilitato per le richieste CM FIM per il criterio. |
| DefaultRequestPriority | La priorità predefinita per le richieste CM FIM per il criterio. |
| Documenti | I documenti dei criteri che sono configurati per il criterio. |
| Attivato | Valore booleano che indica se il criterio è abilitato. |
| EnrollAgentRequired | Valore booleano che indica se sono richiesti gli agenti di registrazione per le richieste CM FIM per il criterio. |
| OneTimePasswordPolicy | Metodo di distribuzione per le password monouso per le richieste CM FIM per i criteri. |
| Personalization | Le opzioni di personalizzazione delle smart card per il criterio. |
| PolicyDataCollection | Gli elementi di raccolta dati che sono 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