Ceridian

Cómo configurar la integración de Ceridian Dayforce en ADManager Plus

Requisitos previos

• Ceridian Dayforce utiliza credenciales de autenticación básica para autorizar las solicitudes de API.
• Se requieren credenciales de autenticación: Nombre de usuario y Contraseña obtenidos de Ceridian Dayforce.

Privilegios

Para importar usuarios (acción de entrada): Su rol de usuario debe tener asignado el acceso a la subfunción Lectura de datos en HCM Anywhere > Servicios web en la pestaña Funciones de Administración del sistema > Roles.

Además, por motivos de seguridad, debe habilitar XRefCode en Servicios RESTful > Recursos humanos > Empleado en la pestaña Acceso a nivel de campo a los servicios web de Administración del sistema > Roles.

Para realizar cualquier acción o consulta en Ceridian Dayforce (acción de salida): Su rol de usuario debe tener asignado el acceso a la subfunción PATCH/POST Employee HR Data en HCM Anywhere > Servicios web en la pestaña Funciones de Administración del sistema > Roles.

Además, por motivos de seguridad, debe habilitar el permiso "Puede crear" para la pestaña Autorizaciones correspondiente de Administración del sistema > Roles.

Configuración de la 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 Ceridian Dayforce.
• Active el botón Habilitar integración con Ceridian Dayforce.
• En la página de configuración de Ceridian Dayforce, haga clic en Autorización.
• Ingrese las credenciales, reemplace el nombre de usuario y la contraseña por su respectivo nombre de usuario y contraseña.
• Haga clic en Configurar.

Configuración del webhook de entrada

El webhook de entrada le permite obtener datos de usuario de Ceridian Dayforce y moverlos a ADManager Plus. La correlación de atributos configurada en esta sección se puede elegir 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 Ceridian Dayforce:

• En el Webhook de entrada, haga clic en Configuración del endpoint de Ceridian Dayforce.
• Ceridian Dayforce sigue un diseño de llamada anidada, que requiere dos endpoints para recuperar los datos de usuario: El endpoint de Lista de usuarios que recopila los ID de usuario y el endpoint de Usuarios que obtiene los detalles de cada ID de usuario recopilado.
• Para utilizar estos endpoints preconfigurados, en ambos endpoints reemplace {subdomain} y {clientNamespace} por el respectivo subdominio y espacio de nombres de cliente de su instancia de Dayforce.
• Cada endpoint se debe probar y guardar individualmente antes de continuar. Si desea utilizar un nuevo endpoint para importar usuarios, puede configurar uno utilizando el botón + Añadir endpoint de la API y llenando los campos necesarios según las referencias de la API de Ceridian Dayforce. Haga clic aquí para saber cómo.
• Puede utilizar los parámetros filterUpdatedStartDate y filterUpdatedEndDate para obtener únicamente las respuestas filtradas de Dayforce. Esto le permite recuperar datos específicos para las necesidades de su entorno.

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 del endpoint para modificarlo dinámicamente, según sus necesidades, utilizando el componente selector de macros.
• Consulte las referencias de la API de Ceridian Dayforce 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 se pueden obtener con la llamada a la API. Haga clic en Proceder.

Nota

• Consulte las referencias de la API de Ceridian Dayforce para conocer los parámetros que debe configurar para obtener sólo parámetros específicos.
• Puede configurar varios endpoints para Ceridian Dayforce utilizando el botón + Añadir endpoint de la API. Haga clic aquí para saber cómo.
• Haga clic en Fuente de datos - Asignación de atributos LDAP para correlacionar endpoints y asignar atributos LDAP de AD con los atributos respectivos en Ceridian Dayforce.

[ADManager Plus también le permite personalizar el formato de los atributos en Ceridian Dayforce]

• Haga clic en + Añadir nueva configuración y haga lo siguiente:
  • Ingrese 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 principal 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 del atributo LDAP y asócielo con la columna correspondiente en Ceridian Dayforce.
• Si desea crear un nuevo formato personalizado, haga clic en Asignación de atributos.
• Haga clic en Guardar.

Configuración del webhook de salida

El webhook de salida le permite actualizar los cambios realizados en AD enviando la información desde ADManager Plus a Ceridian Dayforce y sincronizarlos con AD. Para configurar un webhook de entrada para Ceridian Dayforce:

• En el Webhook de salida, haga clic en Configuración del webhook de Ceridian Dayforce.
• Haga clic en + Añadir webhook.
• Ingrese un nombre y una descripción para este webhook.
• Decida la acción que se debe realizar y consulte las referencias de la API de Ceridian Dayforce para conocer los detalles de la API, como la URL, las cabeceras, los parámetros y otros requisitos que serán necesarios.
• En el menú desplegable, seleccione el método HTTP que le permitirá realizar la acción deseada en el endpoint.
• Ingrese la URL del endpoint.
• Configure la URL, Cabeceras, Parámetros y 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 en el que se debe probar esta solicitud de API y haga clic en Aceptar. 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 se pueden integrar en plantillas de orquestación, lo que permite la automatización programada o basada en eventos para realizar consecutivamente la acción configurada en el webhook de salida entre varias acciones sobre un grupo de usuarios o sobre usuarios individuales.