Saltar al contenido

Conector de Microsoft Entra ID en Jitterbit Studio

Resumen

El conector de Microsoft Entra ID establece acceso a Microsoft Entra ID.

Para conectarse a instancias locales de Microsoft Active Directory, utiliza el conector Active Directory v2.

Importante

Microsoft Entra ID era conocido anteriormente como Microsoft Azure AD.

El conector de Microsoft Entra ID proporciona una interfaz para crear una conexión de Microsoft Entra ID, la base utilizada para generar instancias de actividades de Microsoft Entra ID. Estas actividades, una vez configuradas, interactúan con Microsoft Entra ID a través de la conexión.

Se accede al conector de Microsoft Entra ID desde la pestaña Puntos finales y conectores del proyecto de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para configurar primero una conexión de Microsoft Entra ID. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión específica de Microsoft Entra ID y sus actividades se denominan punto final de Entra ID:

Tipos de actividad de Microsoft Entra ID

  • Consulta: Consulta datos de objetos en Microsoft Entra ID y se pretende utilizar como origen en una operación.

  • Crear: Crea datos de objetos en Microsoft Entra ID y se pretende utilizar como destino en una operación.

  • Actualizar: Actualiza datos de objetos en Microsoft Entra ID y se pretende utilizar como destino en una operación.

  • Eliminar: Elimina datos de objetos de Microsoft Entra ID y se pretende utilizar como destino en una operación.

Los puntos finales creados con este conector se incluyen en reportes de uso de puntos finales y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Deshabilitar actualización automática de conectores.

El conector de Microsoft Entra ID requiere que crees una aplicación registrada para conectarse correctamente con Microsoft Entra ID.

El conector de Microsoft Entra ID utiliza la API de Microsoft Graph v1.0. Consulta la documentación de la API para obtener información sobre los nodos de esquema y los campos.

Solución de problemas

Si experimentas problemas con el conector de Microsoft Entra ID, se recomiendan estos pasos para la solución de problemas:

  1. Haz clic en el botón Prueba en la configuración de conexión para asegurar que la conexión sea exitosa y para asegurar que la versión más reciente del conector se descargue en el agente (a menos que utilices la política de organización Deshabilitar actualización automática de conectores).

  2. Asegúrate de que los registros de aplicaciones de Microsoft Entra ID asociados con la conexión no estén utilizando Azure AD Graph obsoleto.

  3. Revisa los registros de operaciones para obtener información escrita durante la ejecución de la operación.

  4. Habilita el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  5. Si utilizas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:

    <logger name="org.jitterbit.connector.active.directory" level="DEBUG"/>

    Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  6. Si utilizas agentes privados, puedes revisar los registros del agente para obtener más información.

  7. Si ves errores relacionados con nombres de tipo incompatibles con los metadatos, intenta habilitar la opción Establecer tipo OData en la carga útil en Configuración opcional en la configuración de conexión.

  8. Actividad de consulta: Asegúrate de que los parámetros Top y Page Size no se utilicen juntos en una sola consulta. De lo contrario, se producirá un error.

  9. Para consideraciones adicionales de solución de problemas, consulta Solución de problemas de operaciones.

  10. Para problemas y resoluciones específicos del conector de Microsoft Entra ID, consulta la guía Solución de problemas del conector: