Recevoir la stratégie de carte à puce

Obtient la stratégie de modèle de profil pour le flux de travail spécifié. Ces données sont utilisées lors de la création de demande. La stratégie de flux de travail spécifie les données dont le client a besoin pour créer une demande. Les données peuvent inclure divers éléments de collecte de données, des commentaires de demande et une stratégie de mot de passe à usage unique.

Notes

Les URL de cet article sont relatives au nom d’hôte qui est choisi pendant le déploiement de l’API, par exemple https://api.contoso.com .

Requête

Méthode URL de demande
GET /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 de carte à puce doit être extraite.
type Obligatoire. Type de stratégie demandé. Les valeurs possibles sont « ENROLL », « duplicate », « OfflineUnblock », « OnlineUpdate », « Renew », « Recover », « RecoverOnBehalf », « Reverse », « disretraite », « Revoke », « TemporaryEnroll » et « Unblock ».

En-têtes de requête

Pour les en-têtes de requête courants, consultez en-têtes de requête et de réponse http dans Détails du service de l' API REST cm.

Corps de la demande

Aucun.

response

Cette section décrit la réponse.

Codes de réponse

Code Description
200 OK
403 Interdit
204 Aucun contenu
500 Erreur interne

En-têtes de réponse

Pour les en-têtes de réponse courants, consultez en-têtes de requête et de réponse http dans Détails du service de l' API REST cm.

Response body

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 il 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 de l'objet de stratégie associé au paramètre {type} dans la demande. La documentation relative aux différents types d’objets de stratégie se trouve dans la documentation de l' espace de noms Microsoft. CLM. Shared. ProfileTemplates .

Propriété Description
ApprovalsNeeded Nombre d’approbations nécessaires pour les demandes de gestion des certificats de Forefront Identity Manager (FIM) pour la stratégie.
AuthorizedApprover Descripteur de sécurité pour les utilisateurs qui sont 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 initier des demandes FIM CM pour la stratégie.
CollectComments Valeur booléenne qui indique si la collecte de commentaires est activée pour les demandes FIM CM pour la stratégie.
CollectRequestPriority Valeur booléenne qui indique si la collecte de priorité de demande est activée pour les demandes FIM CM pour la stratégie.
DefaultRequestPriority Priorité par défaut pour les demandes 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 nécessaires pour les demandes FIM CM pour la stratégie.
OneTimePasswordPolicy Méthode de distribution pour les mots de passe à usage unique pour les demandes FIM CM pour la stratégie.
Personnalisation Options de personnalisation de carte à puce pour la stratégie.
PolicyDataCollection Éléments de collection de données associés à la stratégie.
SelfServiceEnabled Valeur booléenne qui indique si l'initiation libre-service des demandes FIM CM 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 : requête 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

Voir aussi