OAuth 2.0 de 3 patas en conectores de Jitterbit Studio

Descripción general

La autenticación de una conexión con OAuth 2.0 de 3 patas (3LO) está disponible para ciertos conectores de Studio cuando se usa la versión del agente 10.83 / 11.21 o posterior. 3LO permite que los conectores compatibles accedan a recursos en nombre de un usuario (sin acceder directamente a las credenciales del usuario) mediante el uso de una aplicación en la nube o una aplicación privada.

Las aplicaciones en la nube son aplicaciones OAuth de 3 patas proporcionadas por Jitterbit.

Las aplicaciones privadas son aplicaciones OAuth de 3 patas que configuras y posees dentro del endpoint y luego registras en la página Registros de aplicaciones de la consola de administración con estos valores de la aplicación OAuth de 3 patas:

ID de cliente y secreto de cliente
Alcances
URL de autorización
URL del token de acceso
URL del token de actualización

Una vez que se registra la aplicación OAuth de 3 patas en la página Registros de aplicaciones, está disponible para seleccionarse en el menú Aplicación OAuth bajo Aplicaciones privadas en la configuración de la conexión. Para obtener información sobre cómo configurar una conexión 3LO, consulta la documentación del conector individual.

Conectores compatibles con 3LO

Actualmente, estos conectores son compatibles con la autenticación con OAuth 2.0 de 3 patas:

Arquitectura del sistema

Estos pasos detallan cómo se procesa una conexión 3LO dentro de la arquitectura del sistema al autenticar un conector compatible usando un registro de aplicación OAuth 2.0:

Al conectarse al endpoint, se dirige al usuario a la URL de autorización del proveedor OAuth.
En la URL de autorización, se solicita al usuario que verifique las credenciales y consienta la solicitud de autorización de Harmony.
Una vez que el proveedor OAuth autoriza exitosamente la solicitud, emite un código de autorización a Harmony.
Harmony intercambia el código de autorización por un token de acceso del proveedor OAuth.
Harmony usa el token de acceso para recuperar el recurso requerido de la API del conector.

Notas importantes

Ten en cuenta lo siguiente cuando uses autenticación OAuth de 3 patas:

Endpoints globales: La autenticación con OAuth de 3 patas no es compatible con endpoints globales.
Invalidación del token de acceso: La implementación 3LO de Jitterbit no es compatible con proveedores que invaliden todos los tokens de acceso emitidos anteriormente cuando se emite un nuevo token de acceso (por ejemplo, mediante actualización). Solo un token de acceso puede ser válido por token de actualización en cualquier momento.
Expiración por inactividad del token de actualización: Algunos proveedores (por ejemplo, Microsoft) expiran un token de actualización después de un período de inactividad, como 90 días sin uso. La implementación 3LO de Jitterbit no es compatible con llamar al endpoint del token de actualización según una programación para restablecer el reloj de inactividad y prevenir la expiración. Los tokens de actualización se usan solo cuando una operación requiere acceso al endpoint.
Transferencia de proyecto: Cada endpoint selecciona su propia aplicación OAuth (registro de aplicación), por lo que el mismo proyecto puede usar una aplicación OAuth diferente en cada entorno (por ejemplo, una para desarrollo y otra para producción). Cuando transfieres componentes a otro entorno, la aplicación OAuth utilizada por un endpoint en el entorno de destino se conserva a menos que selecciones Transferir aplicación para el endpoint.

Administrar endpoints

Una vez que se ha configurado la conexión, se puede usar la página Proyectos de la Management Console para ver los endpoints implementados para los cuales se ha configurado OAuth de 3 etapas en un proyecto (consulta la pestaña Endpoints).