Obtenir 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 différents é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 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 « Inscrire », « Dupliquer », « OfflineUnblock », « OnlineUpdate », « Renew », « RecoverOnBehalf », « Rétablir », « Retirer », « Revoke », « TemporaryEnroll » et « Unblock ». |
En-têtes de requête
Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’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 connaître les en-têtes de réponse courants, consultez Requêtes HTTP et en-têtes de réponse dans les détails du service d’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 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 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 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 requêtes CM FIM 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 d’obtention de la stratégie de modèle de profil pour un workflow.
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 : Requête 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