SAP SuccessFactors

Cómo configurar la integración de SAP SuccessFactors en ADManager Plus

Documento de configuración: Integrar SAP SuccessFactors con ADManager Plus

Prerrequisitos:

SAP SuccessFactors utiliza claves de API para autorizar las solicitudes de API.

Privilegios:

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

Para realizar cualquier acción o consulta en SAP SuccessFactors (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 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 SAP SuccessFactors.
• Active el botón Habilitar integración con SAP SuccessFactors.
• En la página de configuración de SAP SuccessFactors, haga clic en Autorización.
• Obtenga el valor de la clave x-api-key de su instancia de SuccessFactors e ingréselo en el campo Valor.
• Haga clic en Configurar

Configuración del webhook de entrada

El webhook de entrada le permite obtener datos de usuario de SAP SuccessFactors para 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 configurar un webhook de entrada para SAP SuccessFactors:

• En el Webhook de entrada, haga clic en Configuración del endpoint de SAP SuccessFactors.
• En la pestaña Configuración del endpoint, un endpoint (ENDPOINT DE USUARIOS de SAP SuccessFactors) viene preconfigurado con los campos de URL del endpoint, Método de API, Cabeceras y Parámetros para obtener las cuentas de usuario de SAP SuccessFactors. Si desea utilizar este endpoint preconfigurado, reemplace "Yourhost" por el subdominio de su instancia de SuccessFactors. 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 llenando los campos necesarios según las referencias de la API de SAP SuccessFactors. Haga clic aquí para saber cómo.

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: Explique cómo pueden utilizar las macros para cambiar dinámicamente el endpoint y adaptarlo a sus necesidades.
• Consulte las referencias de la API de SAP SuccessFactors 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. Luego de comprobar si los parámetros solicitados han sido llamados a la acción, haga clic en Proceder.

Nota:

• Consulte las referencias de la API de SAP SuccessFactors para conocer los parámetros que debe configurar para obtener sólo parámetros específicos.
• Puede configurar varios endpoints para SAP SuccessFactors 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 SAP SuccessFactors.
• 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 SAP SuccessFactors.
  • 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 asignación de atributos configurada anteriormente.

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 SAP SuccessFactors y sincronizarlos con AD. Para configurar un webhook de salida para SAP SuccessFactors:

• En el Webhook de salida, haga clic en Configuración del webhook de SAP SuccessFactors.
• 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 SAP SuccessFactors 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 las Cabeceras, Parámetros, y Tipo de 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.
Nota: Utilice macros para enviar los datos del objeto en el que se ejecuta el webhook.