BambooHR

Cómo configurar la integración de BambooHR en ADManager Plus

Requisitos previos

• BambooHR utiliza la Clave API para autorizar la solicitud API.

Privilegios

Para importar usuarios (acción de entrada): Asegúrese de que la cuenta utilizada para la autorización tiene permiso para leer todas las cuentas de usuario.

Para realizar cualquier acción o consulta en BambooHR (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, luego busque y seleccione BambooHR.
• Seleccione el botón Activar integración de BambooHR.
• Seleccione el botón Activar integración de BambooHR.
• En la página de Configuración de BambooHR, haga clic en Autorización.
• Introduzca la clave API en el campo Nombre de usuario bajo el tipo de autorización Autenticación básica. Utilice como contraseña cualquier hilo generado aleatoriamente.
• Haga clic en Configurar.

Configuración del webhook de entrada

El webhook de entrada le permite obtener datos de los usuarios desde BambooHR a ADManager Plus. 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 realizar la acción deseada en la lista de usuarios recibida de la respuesta de la API. Para configurar un webhook de entrada para BambooHR:

• En Webhook de entrada, haga clic en Configuración de endpoints de BambooHR.
• En la pestaña Configuración de endpoints, un endpoint, BambooHR USERS ENDPOINT, viene preconfigurado con una URL de endpoint, un método API, cabeceras y campos de parámetros para obtener cuentas de usuario de BambooHR. Para utilizar este endpoint preconfigurado, sustituya {companyName} por el nombre de la empresa de su instancia de BambooHR en el campo URL del endpoint. 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 BambooHR. Haga clic aquí para obtener más información.
• Compruebe los datos prellenados, donde se menciona la lista de campos que se van a integrar; si desea incluir algún campo, añádalo a la lista de "campos".

  

  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.
  • Macros: Puede añadir macros a la configuración de sus endpoints para cambiarla dinámicamente según sus necesidades mediante el componente selector de macros.
  • Consulte las referencias de la API de BambooHR 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. Haga clic en Proceder.

  Nota:

  • Consulte las referencias de la API de BambooHR para conocer el Cuerpo del Mensaje que debe configurarse para obtener solo parámetros específicos.
• Haga clic en Fuente de datos - Asignación de atributos del LDAP para hacer coincidir los endpoints y asignar los atributos del LDAP de AD con los atributos respectivos en BambooHR.

  [ADManager Plus también le permite personalizar el formato de los atributos desde BambooHR]

• 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 usuario (por ejemplo, employeeIdentifier).
  Nota: Cuando se configuran varios endpoints, este atributo debe tener el mismo valor en todos ellos.
  • 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 BambooHR.
  • Si desea crear un nuevo formato personalizado para esto, haga clic en Atributo de asignación.
  • 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 actualizar los cambios realizados en AD mediante ADManager Plus en BambooHR y sincronizarlos con AD.

Para configurar un webhook de salida para BambooHR:

• En Webhook de salida, haga clic en Configuración de Webhook de BambooHR.
• Haga clic en + Añadir Webhook.
• Introduzca un nombre y una descripción para este webhook.
• Decida la acción que debe realizarse y consulte las referencias de la API de BambooHR 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.