ServiceDesk Plus

Cómo configurar la integración ServiceDesk Plus - ADManager Plus

Documento de configuración: Integración de ServiceDesk Plus con ADManager Plus

ADManager Plus ofrece dos formas de integración con ServiceDesk Plus:

• Widget: Ejecute acciones de Active Directory (AD) directamente desde la consola de ServiceDesk Plus.

  Haga clic aquí para obtener más información sobre la integración de ADManager Plus con ServiceDesk Plus.

• Integración de aplicaciones basada en API: Agilice la gestión de tickets en ServiceDesk Plus importando periódicamente los tickets relevantes y realizando las acciones de AD necesarias en ADManager Plus. La siguiente guía proporciona instrucciones paso a paso para configurar la integración de aplicaciones basadas en API con ServiceDesk Plus.

Requisitos previos

ServiceDesk Plus utiliza claves API para autorizar las solicitudes API.

Privilegios

Para importar usuarios desde tickets (acción de entrada): Asegúrese de que la cuenta utilizada para la autorización tiene permiso para leer todos los tickets.

Para realizar cualquier acción o consulta en ServiceDesk Plus (acción de salida): Asegúrese de que la cuenta utilizada para la autorización tiene permiso para realizar la acción deseada.

Configuración de autorización

• Inicie sesión en ADManager Plus y vaya a Directorio/Ajustes de la aplicación.
• Vaya a Integraciones de aplicaciones y, a continuación, busque y seleccione Integración de ServiceDesk Plus.
• Seleccione la opción Activar integración de ServiceDesk Plus.
• En la página de Configuración de ServiceDesk Plus, haga clic en Autorización.
• Realice los pasos para generar las claves API y el token API en ServiceDesk Plus e introduzca la clave API sustituyendo {AUTH_TOKEN_SDP_OP} en el campo de valor.
• Haga clic en Configurar.

Configuración del webhook de entrada

El webhook de entrada le permite obtener los datos del usuario desde ServiceDesk Plus a ADManager Plus obteniendo los datos necesarios de los campos del ticket. La asignación de atributos configurada en esta sección puede seleccionarse como fuente de datos durante la configuración de la automatización. Para configurar un webhook de entrada para ServiceDesk Plus:

• En Webhook de entrada, haga clic en Configuración de endpoints de ServiceDesk Plus.
• En la pestaña Configuración de endpoints, un endpoint, ServiceDesk Plus USERS ENDPOINT, viene preconfigurado con una URL de endpoint, un método API, cabeceras y campos de parámetros para obtener tickets de los tickets de ServiceDesk Plus.
• Si desea utilizar este endpoint preconfigurado, sustituya {SDP_SERVER} por la URL del portal de su instancia de ServiceDesk Plus en el campo URL del endpoint.
• En la sección Cabecera, sustituya {SDP INSTANCE HOST} por el nombre de host de su instancia de ServiceDesk Plus.
• Sustituya el parámetro {INPUT_DATA} por los datos de entrada que necesite. En los datos de entrada construidos, proporcione las claves de los campos necesarios para la integración. Para los campos personalizados, puede encontrar las claves de campo en Entorno > Personalización > Campos adicionales.

  Muestra de datos de entrada:

  • Muestra 1: {"list_info": {"row_count": 20,"start_index": 1,"sort_field": "subject","sort_order": "asc","get_total_count": true,"search_fields": {"subject": "New hire","priority.name": "high"}}}
  • Muestra 2: {"list_info":{"row_count":"100","start_index":1,"fields_required":["subject","status","udf_fields.udf_char1","udf_fields.udf_char2","udf_fields.udf_long1"],"search_criteria":[{"field":"last_updated_time","condition":" is","value":"$(LAST_24_HRS)"},{"field":"subject","condition":"like","value":"New employee joining the organization","logical_operator":"and"}],"sort_fields":[{"field":"subject","order":"asc"}]}}

  

• Sin embargo, si desea utilizar un nuevo endpoint para importar usuarios, puede configurar uno utilizando el botón + Añadir endpoint de la API y rellenando los campos requeridos según las referencias de la API de ServiceDesk Plus. Haga clic aquí para obtener más información.

  Nota:

  • El par clave-valor de la API está preconfigurado como cabecera para autenticar las solicitudes de la API, tal y como se configuró durante la Configuración de la autorización.
  • Puede añadir macros a la configuración de sus endpoints para que funcionen dinámicamente según sus necesidades utilizando el componente selector de macros.
  • Consulte las referencias de la API de ServiceDesk Plus y configure cabeceras y parámetros adicionales si es necesario.
• Una vez hecho esto, haga clic en Probar y guardar. Una ventana de respuesta mostrará todos los parámetros solicitados que pueden obtenerse mediante la llamada a la API. Después de verificar si los parámetros solicitados han sido llamados a la acción, haga clic en Proceder.

  Nota:

  • Consulte las referencias de la API de ServiceDesk Plus para conocer los Parámetros que deben configurarse para obtener solo datos específicos de los tickets.
• Haga clic en Fuente de datos - Asignación de atributos del LDAP para asignar los atributos del LDAP de AD con los atributos respectivos en el ticket de ServiceDesk Plus.
• Haga clic en + Añadir nueva configuración y realice lo siguiente:
  • Introduzca el Nombre de la Configuración y la Descripción y seleccione la Categoría de Automatización en el menú desplegable.
  • En el campo Seleccionar endpoint, seleccione el endpoint deseado y una Clave primaria que sea exclusiva de un ticket, por ejemplo, ID(resquest.id).
  • En el campo Asignación de atributos, seleccione el atributo en el menú desplegable Nombre de atributo del LDAP y asígnelo a la columna correspondiente en ServiceDesk Plus.
  • Si desea crear un nuevo formato personalizado, haga clic en Añadir nuevo formato.
  • Haga clic en Guardar.
• Configure una automatización con la acción requerida, la frecuencia de repetición y la configuración de asignación de atributos configurada anteriormente.

Configuración del webhook de salida

El webhook de salida le permite enviar los cambios realizados en AD a ServiceDesk Plus y llevar a cabo tareas en ServiceDesk Plus, todo ello desde ADManager Plus. Los webhooks configurados en esta sección pueden incluirse en una Plantilla de Orquestación, que puede utilizarse durante automatizaciones programadas y basadas en eventos. Para configurar webhooks de salida para ServiceDesk Plus:

• En Webhook de salida, haga clic en Configuración de Webhook de ServiceDesk Plus.
• Haga clic en + Añadir Webhook.
• Introduzca un nombre y una descripción para este webhook.
• Decida la acción a realizar y consulte las referencias de la API de ServiceDesk Plus para conocer los detalles de la API, como la URL, las cabeceras, los parámetros y otros requisitos que serán necesarios.
• Seleccione en el menú desplegable el método HTTP que le permitirá realizar la acción deseada en el endpoint.
• Introduzca la URL del endpoint.
• Configure las Cabeceras, Parámetros y el Cuerpo del mensaje en el formato adecuado en función de la llamada a la API que desee realizar.

  

• Haga clic en Probar y guardar.
• A continuación, una ventana emergente mostrará una lista de usuarios y grupos de AD para probar la llamada a la API configurada. Seleccione el usuario o grupo deseado sobre el que debe probarse esta solicitud de API y haga clic en OK. Esto realizará una llamada en tiempo real a la URL del endpoint, y los objetos seleccionados se modificarán según la configuración.
• A continuación, se mostrarán la respuesta del webhook y los detalles de la solicitud. Compruebe que se ajustan al comportamiento esperado de la API y haga clic en Guardar.
• Los webhooks configurados pueden integrarse en plantillas de orquestación, permitiendo una automatización programada o basada en eventos, para realizar consecutivamente la acción configurada en el webhook de salida entre acciones sobre un grupo de usuarios o sobre usuarios individuales.
Nota: Utilice macros para enviar los datos del objeto sobre el que se ejecuta el webhook.

Vea esta guía en vídeo paso a paso para integrar de manera eficiente ManageEngine ADManager Plus con ServiceDesk Plus.