Condividi tramite


Ottieni la politica della smart card

Ottiene la politica del modello di profilo per il flusso di lavoro specificato. Questi 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 si ricava la politica.
tipo Obbligatorio. Il tipo di politica richiesto. I valori possibili sono "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Ritiro", "Revoca", "TemporaryEnroll" e "Sblocca".

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 dei criteri è disponibile nella documentazione nello spazio dei nomi Microsoft.Clm.Shared.ProfileTemplates.

Proprietà Descrizione
Approvazioni Necessarie Numero di approvazioni necessarie per le richieste nella Gestione dei Certificati di Forefront Identity Manager (FIM CM) per la politica.
Approvato Autorizzato Descrittore di sicurezza per gli utenti autorizzati ad approvare le richieste FIM CM per la politica.
Agente di Iscrizione Autorizzato Descrittore di sicurezza per gli utenti che possono agire come agenti di registrazione per la politica.
IniziatoreAutorizzato Descrittore di sicurezza per gli utenti che possono avviare richieste FIM CM per la politica.
RaccogliCommenti Valore booleano che indica se la raccolta di commenti è abilitata per le richieste FIM CM per la politica.
PrioritàRichiestaRaccolta Valore booleano che indica se la raccolta delle priorità delle richieste è abilitata per le richieste FIM CM per la politica.
PrioritàRichiestaPredefinita La priorità predefinita per le richieste FIM CM per la politica.
Documenti I documenti delle policy configurati per le policy.
Attivato Valore booleano che indica se il criterio è abilitato.
AgenteIscrizioneRichiesto Un valore booleano che indica se gli agenti di registrazione sono richiesti per le richieste CM FIM relative alla policy.
OneTimePasswordPolicy Metodo di distribuzione delle password monouso per le richieste relative ai criteri di CM FIM.
Personalizzazione Opzioni di personalizzazione delle smart card per la politica.
RaccoltaDatiPolitica Gli elementi della raccolta dati associati alla politica.
ServizioAutomaticoAbilitato Valore booleano che indica se l'avvio self-service delle richieste FIM CM è abilitato per la politica.

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