Cómo usar App Connect con Amazon EventBridge

Amazon EventBridge es un servicio de bus de eventos sin servidor que simplifica la arquitectura de su aplicación permitiéndole crear eventos escalables desde sus aplicaciones que pueden integrarse con Amazon Web Services ( AWS ).

Disponibilidad:

App Connect conector
Conector local en contenedores (versión de entrega continua) 12.0.7.0-r3 o posterior
Conector local en contenedores (versión de soporte a largo plazo de Cycle-2 )

Conexión a Amazon EventBridge
¿Qué debo tener en cuenta primero?
Eventos y acciones
Ejemplos

Conexión a Amazon EventBridge

Rellena los campos de conexión que aparecen en la página «Connect > Aplicaciones y API» (antes llamada «Catálogo» ) del Diseñador de App Connect o en el editor de flujos. Si es necesario, trabaja con tu administrador de Amazon EventBridge para obtener estos valores.

Amazon EventBridge tipos de autorización y campos de conexión:

BÁSICA: Clave de acceso secreta : La clave de acceso secreta de tu cuenta de Amazon EventBridge. Obtenga la clave de acceso secreta en la página Credenciales de seguridad de la consola de gestión AWS.; ID de la clave de acceso : El ID de la clave de acceso de tu cuenta de Amazon EventBridge. Obtenga el ID de la clave de acceso en la página Credenciales de seguridad de la consola de gestión AWS.; Región : La región de su instancia de Amazon EventBridge, por ejemplo, us-east-1. Puede encontrar el valor del parámetro Region al final de la URL cuando haya iniciado sesión en la consola de gestión AWS (por ejemplo, https://us-east-2.console.aws.amazon.com/console/home?region=us-east-2#).
Consejo: Para obtener más información, consulta «Puntos de conexión del servicio AWS » en la página de documentación de AWS.; ARN de rol : El nombre de recurso de Amazon (ARN) que especifica un rol de IAM en AWS

OIDC BÁSICO: Región : La región de su instancia de Amazon EventBridge, por ejemplo, us-east-1. Puede encontrar el valor del parámetro Region al final de la URL cuando haya iniciado sesión en la consola de gestión AWS (por ejemplo, https://us-east-2.console.aws.amazon.com/console/home?region=us-east-2#).
Consejo: Para obtener más información, consulta «Puntos de conexión del servicio AWS » en la página de documentación de AWS.; ID de cliente : Especifica el identificador único asignado a una aplicación dentro de un sistema OpenID Connect (OIDC); Secreto del cliente : Especifique el secreto del cliente que se utiliza para autenticar la aplicación cliente; Token de identificación : El token de seguridad en OpenID Connect (OIDC) que contiene afirmaciones sobre la autenticación de un usuario, como su identidad y la validez de la sesión, normalmente representado como un JSON Web Token (JWT); Token de actualización : el token de actualización que se genera a partir del ID de cliente de la aplicación y el secreto del cliente; ARN de rol : El nombre de recurso de Amazon (ARN) que especifica un rol de IAM en AWS, definiendo los permisos concedidos a los usuarios autenticados a través de un proveedor de identidad compatible con OpenID Connect; Servidor OIDC URL : Especifique la dirección URL del servidor OpenID Connect (OIDC) o del proveedor de identidades que gestiona la autenticación y proporciona tokens a los clientes

OIDC WEB: Región : La región de su instancia de Amazon EventBridge, por ejemplo, us-east-1. Puede encontrar el valor del parámetro Region al final de la URL cuando haya iniciado sesión en la consola de gestión AWS (por ejemplo, https://us-east-2.console.aws.amazon.com/console/home?region=us-east-2#).
Consejo: Para obtener más información, consulta «Puntos de conexión del servicio AWS » en la página de documentación de AWS.; ID de cliente : Especifica el identificador único asignado a una aplicación dentro de un sistema OpenID Connect (OIDC); Secreto del cliente : Especifique el secreto del cliente que se utiliza para autenticar la aplicación cliente; ARN de rol : El nombre de recurso de Amazon (ARN) que especifica un rol de IAM en AWS, definiendo los permisos concedidos a los usuarios autenticados a través de un proveedor de identidad compatible con OpenID Connect; Servidor OIDC URL : Especifique la dirección URL del servidor OpenID Connect (OIDC) o del proveedor de identidades que gestiona la autenticación y proporciona tokens a los clientes

Para obtener los valores de conexión para Amazon EventBridge, consulte Obtención de valores de conexión para Amazon EventBridge.

Para conectarse a un punto final de Amazon EventBridge desde la página Aplicaciones y API de App Connect Designer por primera vez, expanda Amazon EventBridge y, a continuación, haga clic en Conectar. Para más información, consulte Gestión de cuentas.

Consejo:

Antes de utilizar la cuenta creada en App Connect en un flujo, cambie el nombre de la cuenta por algo significativo que le ayude a identificarla. Para cambiar el nombre de la cuenta en la página Aplicaciones y API, seleccione la cuenta, abra su menú de opciones (⋮) y, a continuación, haga clic en Cambiar nombre de cuenta.

¿Qué debo tener en cuenta primero?

Antes de utilizar App Connect Designer con Amazon EventBridge, tenga en cuenta las siguientes consideraciones:

Hay dos tipos de eventos (eventos de datos y eventos de gestión) registrados en AWS CloudTrail.
Los eventos de datos (por ejemplo, en Amazon S3 eventos a nivel de objeto, Amazon DynamoDB, y AWS Lambda ) deben tener rutas configuradas para recibir dichos eventos. De forma predeterminada, los recorridos no registran eventos de datos, y estos eventos no se pueden ver en el historial de eventos de CloudTrail. Para activar el registro de eventos de datos, debe añadir explícitamente los recursos o tipos de recursos admitidos a una ruta.
Para obtener instrucciones sobre cómo activar el registro de eventos de datos, consulta «Registro de eventos de datos para rutas ».

Para obtener más información sobre cómo se integran determinados servicios de AWS con AWS y CloudTrail,, consulte los servicios e integraciones compatibles en CloudTrail.
Para utilizar un destino API como destino, debe proporcionar un ARN de rol IAM con los permisos correctos. Para obtener más información, consulte «Permisos necesarios para que EventBridge acceda a los destinos mediante roles de IAM ». El siguiente es un ejemplo de una política de muestra para ser utilizada en un rol que funciona para cualquier App Connect Que se cree a través del conector Webhooks:
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [ "events:InvokeApiDestination" ],
            "Resource": [ "arn:aws:events:*:*:api-destination/appconnect*/*" ]
        }
    ]
}
```
Para que los eventos Amazon S3 los eventos se activen a través de Amazon EventBridge, debe habilitar explícitamente la entrega de eventos de Amazon EventBridge en Amazon S3. Para obtener más información, consulta «Habilitar Amazon EventBridge ».

(Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.
Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación admite eventos configurables, verá un enlace Mostrar más eventos configurables bajo la lista de eventos. Si la aplicación admite la detección dinámica de acciones, verá un enlace Mostrar más debajo de la lista de acciones.
(Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.

Eventos y acciones

Amazon EventBridge eventos

Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.

Objecto	Suceso	Descripción
AWS eventos	Nuevo evento AWS	Especifica un nuevo evento en AWS
Sucesos personalizados	Nuevo evento personalizado	Especifica un nuevo evento personalizado

Amazon EventBridge acciones

Su flujo completa estas acciones en esta aplicación.

Objecto	Acción	Descripción
Autobuses para eventos	Crear bus de eventos	Crea un nuevo bus de eventos dentro de tu cuenta
	Borrar bus de eventos	Elimina el bus de eventos personalizado o el bus de eventos asociado especificado
	Recuperar autobuses de eventos	Recupera todos los buses de eventos de tu cuenta
Sucesos	Enviar sucesos	Envía los eventos AWS

Ejemplos

Mosaico del salpicadero para una plantilla que utiliza Amazon EventBridge

Utilice plantillas para crear rápidamente flujos para Amazon EventBridge

Aprenda a utilizar App Connect plantillas para crear rápidamente flujos que realicen acciones en Amazon EventBridge. Por ejemplo, abra Discover y busque Amazon EventBridge.

Más información

Amazon EventBridge flujo en vista detallada

Utilice App Connect para crear flujos que se integren con Amazon EventBridge.

Lea el blog en la Comunidad IBM® para aprender a enviar eventos desde Amazon EventBridge cada vez que un Salesforce se crea correctamente o cuando Salesforce falla la creación de un cliente potencial. Haga clic en Leer el blog para ir al blog.

Lea este blog