Obtención de la directiva de tarjeta inteligente
Obtiene la directiva de plantilla de perfil para el flujo de trabajo especificado. Estos datos se usan durante la creación de la solicitud. La directiva de flujo de trabajo especifica los datos que 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 |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{tipo} |
Parámetros de dirección URL
| Parámetro | Descripción |
|---|---|
| id | Necesario. GUID correspondiente a la plantilla de perfil de la que se va a extraer la directiva. |
| tipo | Necesario. Tipo de directiva que se solicita. Los valores posibles son "Inscribir", "Duplicar", "OfflineUnblock", "OnlineUpdate", "Renovar", "Recuperar", "RecoverOnBehalf", "Restablecer", "Retirar", "Revocar", "TemporaryEnroll" y "Desbloquear". |
Encabezados de solicitud
Para ver los encabezados de solicitud comunes, consulte Encabezados de solicitud y respuesta HTTP en los detalles del servicio de LA API REST de CM.
Cuerpo de la solicitud
Ninguno.
Response
En esta sección se describe la respuesta.
Códigos de respuesta
| Código | Descripción |
|---|---|
| 200 | Aceptar |
| 403 | Prohibido |
| 204 | Sin contenido |
| 500 | Error interno |
Encabezados de respuesta
Para ver los encabezados de respuesta comunes, consulte Encabezados de solicitud HTTP y respuesta en los detalles del servicio de LA API REST de CM.
Response body
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 para el objeto de directiva asociada al parámetro de {tipo} 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 |
|---|---|
| ApprovalsNeeded | 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 de los usuarios que tienen autorización para aprobar las 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 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. |
| habilitado | 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. |
| OneTimePasswordPolicy | El método de distribución de contraseñas únicas para las solicitudes de FIM CM para la directiva. |
| Personalización | Opciones de personalización de tarjeta inteligente para la directiva. |
| PolicyDataCollection | Elementos de recopilación de datos que están 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 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