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 el flujo de trabajo especificado. Estos datos se usan durante la creación de solicitudes. 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 la solicitud |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{tipo} |
Parámetros de dirección URL
| Parámetro | Descripción |
|---|---|
| id | 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 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 del espacio de nombres Microsoft.Clm.Shared.ProfileTemplates.
| Propiedad | Descripción |
|---|---|
| AprobacionesNecesarias | Número de aprobaciones necesarias para las solicitudes Forefront Identity Manager (FIM) de administración de certificados (CM) según la directiva. |
| AuthorizedApprover | Descriptor de seguridad de los usuarios que tienen autorización para aprobar las solicitudes de FIM CM para la directiva. |
| Agente de Inscripción Autorizado | 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. |
| RecogerComentarios | Valor booleano que indica si está habilitada la recopilación de comentarios para las solicitudes de FIM CM para la directiva. |
| CollectRequestPriority | Valor booleano que indica si está habilitada la recopilación de prioridad para las solicitudes de FIM CM para la directiva. |
| DefaultRequestPriority | Prioridad predeterminada para las solicitudes de FIM CM para la directiva. |
| Documentos | Documentos de directivas que están configurados para la directiva. |
| Activado | Valor booleano que indica si la directiva está habilitada. |
| EnrollAgentRequired | Valor booleano que indica si se necesitan agentes de inscripción para las solicitudes de FIM CM para la directiva. |
| Política de Contraseña de Un Solo Uso | El método de distribución de contraseñas de un solo para las solicitudes de FIM CM según la directiva. |
| Personalización | Opciones de personalización de tarjeta inteligente para la directiva. |
| RecopilaciónDeDatosDePolítica | Elementos de recopilación de datos asociados a la directiva. |
| SelfServiceEnabled | Valor booleano que indica si está habilitada la iniciación de autoservicio para las solicitudes de FIM CM para la directiva. |
Ejemplo
En esta sección se presenta 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