Documentación de Oracle Cloud Infrastructure

Integración con Eloqua

Requisitos

Antes de instalar y configurar un sistema orquestado de Eloqua, debe tener en cuenta los siguientes requisitos y tareas.

Componentes Certificados

El sistema puede ser cualquiera de las siguientes opciones:

  • Eloqua

Modos soportados

El sistema orquestado de Eloqua admite los siguientes modos:
  • Sistema gestionado

Operaciones del sistema admitidas

El sistema orquestado de Eloqua admite las siguientes operaciones:
  • Crear usuario
  • Suprimir usuario
  • Restablecer Contraseña
  • Asignar grupos a un usuario
  • Eliminar grupos de un usuario
  • Asignación de licencias a un usuario
  • Eliminar licencias de un usuario

Obtener ID de Cliente y Secreto de Cliente

Registre la aplicación en Eloqua para recibir un ID de cliente y un secreto de cliente únicos.

  1. Conéctese a la instancia de Eloqua.
  2. Vaya a Configuración y, a continuación, a AppCloud Desarrollador.
  3. Seleccione Crear nueva aplicación.
  4. Complete los detalles obligatorios de la solicitud.
  5. En la sección OAuth, introduzca la URL de la aplicación en el campo OAuth URL de devolución de llamada.
  6. Seleccione Guardar. Eloqua genera el ID del cliente y el secreto del cliente. Guarde estas credenciales. Las utiliza al configurar OAuth.

Para obtener pasos detallados, consulte Autenticación mediante OAuth 2.0.

Generar código de autorización (explorador)

Inicie el proceso OAuth dirigiendo a los usuarios al punto final de autorización de Eloqua en un explorador web.

  1. Abra un explorador y utilice la siguiente URL. Sustituya los marcadores de posición por los valores reales: 
    https://login.eloqua.com/auth/oauth2/authorize?response_type=code&client_id=<CLIENT_ID>&redirect_uri=<YOUR_CALLBACK_URL>&scope=full
  2. Autenticar y aprobar.
  3. Después de la aprobación, se le redirigirá a la URL de devolución de llamada: 
    https://yourapp.com/callback?code=AUTH_CODE_VALUE
  4. Copie y guarde AUTH_CODE_VALUE de la URL.

Código de autorización de intercambio para tokens

Envíe el código de autorización, junto con las credenciales, al punto final de token de Eloqua mediante un cliente REST.

Utilice un cliente REST (como Postman) para realizar una solicitud POST:

  1. Punto final 
    POST https://login.eloqua.com/auth/oauth2/token
  2. Cabeceras 
    Authorization: Basic <BASE64(CLIENT_ID:CLIENT_SECRET)>
         Content-Type: application/x-www-form-urlencoded
  3. Cuerpo (datos de formulario) 
    grant_type=authorization_code
         code=<AUTH_CODE_VALUE>
         redirect_uri=<YOUR_CALLBACK_URL>

Una solicitud correcta devuelve una respuesta JSON que contiene tanto el token de acceso como el token de refrescamiento. Copie y guarde el token de refrescamiento. Se utiliza al configurar OAuth.

Configurar

Puede establecer una conexión entre Eloqua y Oracle Access Governance introduciendo los detalles de la conexión. Para ello, utilice la funcionalidad de sistemas orquestados disponible en la consola de Oracle Access Governance.

Navegar a la página Orchestrated Systems

Vaya a la página Orchestrated Systems de la consola de Oracle Access Governance siguiendo estos pasos:
  1. En el icono de menú de navegación de Oracle Access Governance Menú de navegación, seleccione Administración de servicios → Sistemas orquestados.
  2. Seleccione el botón Add an Orchestrated system (Agregar un sistema orquestado) para iniciar el flujo de trabajo.

Seleccionar sistema

En el paso Seleccionar sistema del flujo de trabajo, puede especificar qué tipo de sistema desea incorporar.

  1. Seleccione Eloqua.
  2. Seleccione Next (Siguiente).

Introducir detalles

En el paso Agregar detalles del flujo de trabajo, introduzca los detalles del sistema orquestado:
  1. Introduzca un nombre para el sistema al que desea conectarse en el campo Nombre.
  2. Introduzca una descripción para el sistema en el campo Descripción.
  3. Decida si este sistema orquestado es un origen autorizado y si Oracle Access Governance puede gestionar permisos mediante la definición de las siguientes casillas de control.
    • Este es el origen autorizado de mis identidades

      Seleccione uno de estos procedimientos:

      • Origen de las identidades y sus atributos: el sistema actúa como identidades de origen y atributos asociados. Se crean nuevas identidades a través de esta opción.
      • Solo origen de atributos de identidad: el sistema ingiere detalles de atributos de identidad adicionales y se aplica a las identidades existentes. Esta opción no ingiere ni crea nuevos registros de identidad.
    • Quiero gestionar los permisos de este sistema
    El valor predeterminado en cada caso es No seleccionado.
  4. Seleccione Next (Siguiente).

Agregar propietarios

Puede asociar la propiedad de recursos agregando propietarios principales y adicionales. Esto impulsa el autoservicio, ya que estos propietarios pueden gestionar (leer, actualizar o suprimir) los recursos que poseen. Por defecto, el creador del recurso se designa como propietario del recurso. Puede asignar un propietario principal y hasta 20 propietarios adicionales para los recursos.
Nota

Al configurar el primer sistema orquestado para la instancia de servicio, solo puede asignar propietarios después de activar las identidades en la sección Gestionar identidades.
Para agregar propietarios:
  1. Seleccione un usuario activo de Oracle Access Governance como propietario principal en el campo ¿Quién es el propietario principal?.
  2. Seleccione uno o más propietarios adicionales en la lista ¿Quién más los posee?. Puede agregar hasta 20 propietarios adicionales para el recurso.
Puede ver el propietario principal en la lista. Todos los propietarios pueden ver y gestionar los recursos de los que son propietarios.

Configuración de la Cuenta

En el paso Configuración de cuenta del flujo de trabajo, introduzca cómo desea que Oracle Access Governance gestione las cuentas cuando el sistema esté configurado como un sistema gestionado:
  1. Cuando se solicite un permiso y la cuenta no exista, seleccione esta opción para crear nuevas cuentas. Esta opción está seleccionada por defecto. Cuando se selecciona, Oracle Access Governance crea una cuenta si no existe una cuando se solicita un permiso. Si desactiva esta opción, los permisos se aprovisionan solo para las cuentas existentes en el sistema orquestado. Si no existe ninguna cuenta, la operación de aprovisionamiento falla.
  2. Seleccione los destinatarios de los correos electrónicos de notificación cuando se cree una cuenta. El destinatario predeterminado es User (Usuario). Si no se selecciona ningún destinatario, las notificaciones no se envían cuando se crean las cuentas.
    • Usuario
    • Gestor de usuarios
  3. Configuración de cuentas existentes
    Nota

    Solo puede definir estas configuraciones si lo permite el administrador del sistema. Cuando se activa la configuración de cese de cuenta global, los administradores de la aplicación no pueden gestionar la configuración de cese de cuenta en el nivel de sistema orquestado.
    1. Seleccionar qué hacer con las cuentas cuando comience el cese anticipado: seleccione la acción que se debe realizar cuando comience un cese anticipado. Esto sucede cuando necesita revocar los accesos de identidad antes de la fecha de cese oficial.
      • Suprimir: suprime todas las cuentas y permisos gestionados por Oracle Access Governance.
        Nota

        Si un sistema orquestado específico no soporta la acción, no se realiza ninguna acción.
      • Desactivar: desactiva todas las cuentas y desactiva los permisos gestionados por Oracle Access Governance.
        • Suprimir los permisos para las cuentas desactivadas: para garantizar un acceso residual cero, seleccione esta opción para suprimir los permisos asignados directamente y los permisos otorgados por políticas durante la desactivación de la cuenta.
      • Sin acción: no se realiza ninguna acción cuando Oracle Access Governance marca una identidad para su terminación anticipada.
    2. Seleccionar qué hacer con las cuentas en la fecha de cese: seleccione la acción que se debe realizar durante el cese oficial. Esto sucede cuando necesita revocar los accesos de identidad en la fecha de cese oficial.
      • Suprimir: suprime todas las cuentas y permisos gestionados por Oracle Access Governance.
        Nota

        Si el sistema orquestado específico no soporta la acción Suprimir, no se realiza ninguna acción.
      • Desactivar: desactiva todas las cuentas y desactiva los permisos gestionados por Oracle Access Governance.
        • Suprimir los permisos para las cuentas desactivadas: para garantizar un acceso residual cero, seleccione esta opción para suprimir los permisos asignados directamente y los permisos otorgados por políticas durante la desactivación de la cuenta.
        Nota

        Si el sistema orquestado específico no soporta la acción Desactivar, se suprime la cuenta.
      • Sin acción: Oracle Access Governance no realiza ninguna acción en las cuentas y los permisos.
  4. Cuando una identidad abandona la empresa, debe eliminar el acceso a sus cuentas.
    Nota

    Solo puede definir estas configuraciones si lo permite el administrador del sistema. Cuando se activa la configuración de cese de cuenta global, los administradores de la aplicación no pueden gestionar la configuración de cese de cuenta en el nivel de sistema orquestado.

    Seleccione una de las siguientes acciones para la cuenta:

    • Suprimir: suprime todas las cuentas y permisos gestionados por Oracle Access Governance.
    • Desactivar: desactive todas las cuentas y marque los permisos como inactivos.
      • Suprimir los permisos para las cuentas desactivadas: suprima los permisos asignados directamente y otorgados por la política durante la desactivación de la cuenta para garantizar un acceso residual cero.
    • Sin acción: no realice ninguna acción cuando una identidad abandone la organización.
    Nota

    Estas acciones solo están disponibles si están soportadas por el tipo de sistema orquestado. Por ejemplo, si Suprimir no está soportado, solo verá las opciones Desactivar y Sin acción.
  5. Cuando se eliminan todos los permisos de una cuenta, por ejemplo, cuando una identidad se mueve entre departamentos, puede que tenga que decidir qué hacer con la cuenta. Seleccione una de las siguientes acciones, si son compatibles con el tipo de sistema orquestado:
    • Suprimir
    • Desactivar
    • No hay acciones
  6. Gestionar cuentas que no han sido creadas por Access Governance: seleccione esta opción para gestionar cuentas que se hayan creado directamente en el sistema orquestado. Con esto, puede conciliar cuentas existentes y gestionarlas desde Oracle Access Governance.
Nota

Si no configura el sistema como un sistema gestionado, se mostrará este paso del flujo de trabajo, pero no estará activado. En este caso, debe continuar directamente con el paso Configuración de integración del flujo de trabajo.
Nota

Si el sistema orquestado requiere la detección de esquemas dinámicos, al igual que con las integraciones de tablas de aplicación de base de datos y REST genéricas, solo se puede definir el destino de correo electrónico de notificación (Usuario, Usermanager) al crear el sistema orquestado. No puede definir las reglas de desactivación/supresión para los movimientos y los elementos salientes. Para ello, debe crear el sistema orquestado y, a continuación, actualizar los valores de cuenta como se describe en Configure Orchestrated System Account Settings.

Configuración de Eloqua mediante OAuth

En el paso Configuración de integración del flujo de trabajo, introduzca los detalles de configuración necesarios para permitir que Oracle Access Governance se conecte a Eloqua mediante OAuth.

Seleccione la casilla de control ¿Desea utilizar el token de refrescamiento para la autenticación? e introduzca los detalles de la siguiente manera:

Campo Descripción
Host

Introduzca el nombre de host de la URL. Por ejemplo, secure.<pod>.eloqua.com.
URL de redirección

URL de devolución de llamada después de la autenticación. Debe coincidir con la URL que introdujo durante el registro de la aplicación.

https://yourapp.example.com/callback
URL de servidor de autenticación

URL del servidor OAuth2 de Eloqua para solicitar tokens.

https://login.eloqua.com/auth/oauth2/token
ID de cliente

ID de cliente de la aplicación que se muestra al registrar la integración en Eloqua. Consulte Obtener ID de Cliente y secreto de Cliente.
Secreto de cliente

Secreto de cliente de la aplicación que se muestra al registrar la integración en Eloqua. Consulte Obtener ID de Cliente y secreto de Cliente.
Token de Refrescamiento

Un token que se utiliza para refrescar el token de acceso automáticamente cuando caduca. Por ejemplo, eyJraWQiOi...2IHpuqg. Consulte Código de autorización de intercambio para tokens.
Timeout de solicitud

Tiempo máximo de espera (en milisegundos) antes de cancelar la solicitud. 30000.

Finalizar

El paso final del flujo de trabajo es Terminar, donde es específica la opción de configurar aún más el sistema orquestado antes de ejecutar una carga de datos, o aceptar la configuración por defecto e iniciar una carga de datos. Seleccione una de las siguientes opciones:
  • Personalizar antes de activar el sistema para cargas de datos
  • Activar y preparar la carga de datos con los valores por defecto proporcionados

Configuración Posterior

No hay pasos posteriores a la configuración asociados a un sistema Eloqua.