Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Obtiene la directiva de plantilla de perfil para un flujo de trabajo especificado. Los datos se usan durante la creación de la solicitud. La directiva de flujo de trabajo especifica qué datos necesita el cliente para crear una solicitud. Los datos pueden incluir varios elementos de recopilación de datos, solicitar comentarios y una directiva de contraseña única.
Nota:
Las direcciones URL de este artículo son relativas al nombre de host elegido durante la implementación de la API, como https://api.contoso.com.
Solicitud
| Método | URL de solicitud |
|---|---|
| OBTÉN | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
Parámetros de dirección URL
| Parámetro | Descripción |
|---|---|
| identificación | Obligatorio. GUID correspondiente a la plantilla de perfil de la que se va a extraer la directiva. |
| tipo | Obligatorio. Tipo de directiva que se solicita. Los valores posibles son "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" y "Unblock". |
Encabezados de solicitud
Para obtener encabezados de solicitud comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.
Cuerpo de la solicitud
Ninguno.
Respuesta
En esta sección se describe la respuesta.
Códigos de respuesta
| Código | Descripción |
|---|---|
| 200 | De acuerdo |
| 403 | Prohibido |
| 204 | Sin contenido |
| 500 | Error interno |
Encabezados de respuesta
Para obtener encabezados de respuesta comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.
Cuerpo de la respuesta
Si se ejecuta correctamente, devuelve un objeto de directiva basado en un objeto ProfileTemplatePolicy. Como mínimo, el objeto de directiva contiene las propiedades de la tabla siguiente, pero puede contener propiedades adicionales en función de la directiva solicitada. Por ejemplo, una solicitud de una directiva de inscripción devuelve un objeto EnrollPolicy. Para obtener más información, consulte la documentación del objeto de directiva asociado al parámetro {type} en la solicitud. La documentación de los distintos tipos de objetos de directiva se puede encontrar en la documentación de espacio de nombres Microsoft.Clm.Shared.ProfileTemplates.
| Propiedad | Descripción |
|---|---|
| AprobacionesNeeded | Número de aprobaciones necesarias para las solicitudes de administración de certificados (CM) de Forefront Identity Manager (FIM) para la directiva. |
| AuthorizedApprover | Descriptor de seguridad para los usuarios que tienen autorización para aprobar solicitudes de FIM CM para la directiva. |
| AuthorizedEnrollmentAgent | Descriptor de seguridad para los usuarios que pueden actuar como agentes de inscripción para la directiva. |
| AuthorizedInitiator | Descriptor de seguridad para los usuarios que pueden iniciar solicitudes de FIM CM para la directiva. |
| CollectComments | Valor booleano que indica si la colección de comentarios está habilitada para las solicitudes de FIM CM para la directiva. |
| CollectRequestPriority | Valor booleano que indica si la recopilación de prioridad de solicitud está habilitada para las solicitudes de FIM CM para la directiva. |
| DefaultRequestPriority | Prioridad predeterminada para las solicitudes de FIM CM para la directiva. |
| Documentos | Los documentos de directiva configurados para la directiva. |
| Activado | Valor booleano que indica si la directiva está habilitada. |
| EnrollAgentRequired | Valor booleano que indica si se requieren agentes de inscripción para las solicitudes de FIM CM para la directiva. |
| OneTimePasswordPolicy | El método de distribución de contraseñas únicas para las solicitudes de FIM CM para la directiva. |
| Personalización | Las opciones de personalización de tarjetas inteligentes para la directiva. |
| PolicyDataCollection | Elementos de recopilación de datos asociados a la directiva. |
| SelfServiceEnabled | Valor booleano que indica si el inicio de autoservicio de solicitudes de FIM CM está habilitado para la directiva. |
Ejemplo
En esta sección se proporciona un ejemplo para obtener la directiva de plantilla de perfil de un flujo de trabajo.
Ejemplo: Solicitud 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
Ejemplo: Respuesta 1
HTTP/1.1 200 OK
... body coming soon
Ejemplo: Solicitud 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
Ejemplo: Respuesta 2
HTTP/1.1 200 OK
... body coming soon