Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Obtient la stratégie de modèle de profil pour un flux de travail spécifié. Les données sont utilisées lors de la création de la demande. La stratégie de flux de travail spécifie les données nécessaires au client pour créer une demande. Les données peuvent inclure différents éléments de collecte de données, demander des commentaires et une stratégie de mot de passe unique.
Remarque
Les URL de cet article sont relatives au nom d’hôte choisi pendant le déploiement de l’API, par exemple https://api.contoso.com.
Requête
| Méthode | URL de demande |
|---|---|
| OBTENIR | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
Paramètres d’URL
| Paramètre | Description |
|---|---|
| id | Obligatoire. GUID correspondant au modèle de profil à partir duquel la stratégie doit être extraite. |
| type | Obligatoire. Type de stratégie demandé. Les valeurs possibles sont « Inscrire », « Dupliquer », « OfflineUnblock », « OnlineUpdate », « Renouveler », « Récupérer », « RecoverOnBehalf », « Rétablir », « Mettre hors service », « Révoquer », « TemporaryEnroll » et « Débloquer ». |
En-têtes de requête
Pour connaître les en-têtes de requête courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.
Corps de la requête
Aucun.
Réponse
Cette section décrit la réponse.
Codes de réponse
| Code | Description |
|---|---|
| 200 | D’ACCORD |
| 403 | Interdit |
| 204 | Aucun contenu |
| 500 | Erreur interne |
En-têtes de réponse
Pour connaître les en-têtes de réponse courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.
Corps de la réponse
En cas de réussite, retourne un objet de stratégie basé sur un objet ProfileTemplatePolicy. Au minimum, l’objet de stratégie contient les propriétés du tableau suivant, mais peut contenir des propriétés supplémentaires en fonction de la stratégie demandée. Par exemple, une demande de stratégie d’inscription retourne un objet EnrollPolicy. Pour plus d’informations, consultez la documentation relative à l’objet de stratégie associé au paramètre {type} dans la requête. La documentation relative aux différents types d’objets de stratégie se trouve dans la documentation espace de noms Microsoft.Clm.Shared.ProfileTemplates documentation.
| Propriété | Description |
|---|---|
| ApprobationsNeeded | Nombre d’approbations requises pour les demandes de gestion des certificats (CM) Forefront Identity Manager (FIM) pour la stratégie. |
| AuthorizedApprover | Descripteur de sécurité pour les utilisateurs autorisés à approuver les demandes FIM CM pour la stratégie. |
| AuthorizedEnrollmentAgent | Descripteur de sécurité pour les utilisateurs qui peuvent agir en tant qu’agents d’inscription pour la stratégie. |
| AuthorizedInitiator | Descripteur de sécurité pour les utilisateurs qui peuvent lancer des demandes FIM CM pour la stratégie. |
| CollectComments | Valeur booléenne qui indique si la collection de commentaires est activée pour les requêtes CM FIM pour la stratégie. |
| CollectRequestPriority | Valeur booléenne qui indique si la collecte de priorité de requête est activée pour les requêtes CM FIM pour la stratégie. |
| DefaultRequestPriority | Priorité par défaut pour les requêtes FIM CM pour la stratégie. |
| Documents | Documents de stratégie configurés pour la stratégie. |
| Activé | Valeur booléenne qui indique si la stratégie est activée. |
| EnrollAgentRequired | Valeur booléenne qui indique si les agents d’inscription sont requis pour les requêtes CM FIM pour la stratégie. |
| OneTimePasswordPolicy | Méthode de distribution pour les mots de passe à usage unique pour les requêtes FIM CM pour la stratégie. |
| Personnalisation | Options de personnalisation de carte à puce pour la stratégie. |
| PolicyDataCollection | Éléments de collecte de données associés à la stratégie. |
| SelfServiceEnabled | Valeur booléenne qui indique si l’initiation en libre-service des requêtes CM FIM est activée pour la stratégie. |
Exemple :
Cette section fournit un exemple pour obtenir la stratégie de modèle de profil pour un flux de travail.
Exemple : Demande 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
Exemple : Réponse 1
HTTP/1.1 200 OK
... body coming soon
Exemple : Demande 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
Exemple : Réponse 2
HTTP/1.1 200 OK
... body coming soon