Ottenere i criteri delle smart card
Ottiene i criteri dei modelli di profilo per il flusso di lavoro specificato. Questi dati vengono utilizzati 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. Il 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 criterio 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 ulteriori informazioni, vedere la documentazione per l'oggetto criterio associato al parametro di {type} della 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