From a67f02c8aea60bf7e2588cd85f8929afe967eb0b Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Wed, 2 Sep 2026 16:08:04 +0200 Subject: [PATCH 01/18] Create Bridges and HTTP pages --- .../services/event-broker/_index.md | 218 +++++++++++++ .../event-broker-bridges/_index.md} | 292 +++--------------- .../event-broker-bridges/http-bridge.md | 68 ++++ .../integration/change-data-capture/_index.md | 8 +- .../published-cdc-services.md | 2 +- 5 files changed, 334 insertions(+), 254 deletions(-) create mode 100644 content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md rename content/en/docs/marketplace/platform-supported-content/services/{event-broker.md => event-broker/event-broker-bridges/_index.md} (60%) create mode 100644 content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md new file mode 100644 index 00000000000..2ccf8e70df0 --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -0,0 +1,218 @@ +--- +title: "Mendix Event Broker" +url: /appstore/services/event-broker/ +linktitle: "Event Broker" +description: "Mendix Event Broker" +aliases: +--- + +## Introduction + +Based on [Apache Kafka](https://kafka.apache.org/), the Mendix Event Broker is single-tenant and can only be used by apps running on nodes provisioned for your company. + +Events are published to a Kafka topic. Apps are subscribed to a Kafka topic to receive events, and messages use standard [CloudEvents payload format](https://github.com/cloudevents/spec/blob/v1.0.1/spec.md). + +There is a single Kafka broker for Free Apps that your company Free Apps can connect to. All Free Apps in your company publish and consume from the same Kafka broker. Events are published to one shared Kafka topic, and any Free App in your company can receive these events. + +## Mendix Event Broker License {#event-broker-license} + +Purchase a license to the Mendix Event Broker to deploy unlimited apps on production environments in Mendix Cloud. Ask your Customer Success Manager or Account Manager to reach out to purchase a license. See the [Mendix Event Broker](https://marketplace.mendix.com/link/component/202907) platform service page for more details. + +A license for the Mendix Event Broker is available for any Mendix region, but once selected, you can only run on a single region (no multi-region support). This license is available for all customers. You can also run business events on [your own Kafka cluster](/appstore/services/business-events-deployment/#byok). + +### Enabling the Mendix Event Broker Service {#enable-mx-event-broker} + +Once a license is purchased, a Technical Contact must enable the Event Broker Service on the [Mendix Portal](/developerportal/) for the [Mendix Cloud](/developerportal/deploy/mendix-cloud-deploy/) in the following places: + +1. On the app level under **Environments**, navigate to **Cloud Settings** ({{< icon name="settings-slider-1" >}}) and click [Services](/developerportal/deploy/environments/#services) +2. On the [Environment Details](/developerportal/deploy/environments-details/#services) page for each environment + +The Event Broker must be enabled on both the app and specific environment levels in order to use the Event Broker services. + +### Managing the Mendix Event Broker {#manage-mx-broker} + +Technical Contacts with a license for the Mendix Event Broker can manage its features on the [Event Broker Manager](https://broker.mendix.com/) page. + +#### Users for Event Broker Manager + +Users within the company's email domain that have a Mendix login can participate in the administration of the Mendix Event Broker as either a View or Admin user. They can also be blocked from participation. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user.png" >}} + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user_2.png" width="300" >}} + +Users that are not part of the customer organization (not within the email domain of the customer) can be invited with the same levels of access. Such users still require a standard Mendix login. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_external_user.png" width="300" >}} + +#### Spaces and Environments{#spaces} + +Spaces define which applications can exchange events with each other. When Business Events is enabled for an environment, it is placed in an Event Broker space based on the environment name. This enables apps deployed under the same space to publish and consume events. For example, apps in acceptance environment can only exchange events with other apps' acceptance environments. You can check the space of an app's environment on the [Event Broker Manager](https://broker.mendix.com/) page. + +Spaces are created and assigned based on the app environment name and allow isolation of your business events. The default behavior can be changed if needed. Contact [Mendix Support](https://support.mendix.com/) if you would like to change the space of a specific app environment. + +See the [Enabling the Mendix Event Broker Service](#enable-mx-event-broker) section above for more information. + +#### Topics and Channels {#topics-channels} + +Events are placed in channels, sometimes called topics. Apps subscribed to a channel will receive events published to this channel. + +Events published by Free Apps are published to one shared company channel on a multitenant free Event Broker. Events published by apps running on licensed nodes are published to their own channels on the company Event Broker. These channels, implemented as topics on Kafka, are automatically created upon deployment of the app publishing the events. + +#### Event Access Control {#access-control} + +The Mendix Event Broker allows access control to be applied down to the event level. Each application can be granted or denied access to events using the [Event Broker Manager](https://broker.mendix.com/). + +##### Types of Access + +The overview page contains a list of applications by environment within the organization's event landscape. The table contains columns that provide cases with exceptions: + +* **Implemented but no access** – an application has implemented an event that it is not allowed to access, guaranteeing a failure to subscribe to and/or publish the event +* **Has access but not implemented** – an application has been provided with more access than is required and you could make it more secure. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview.png" >}} + +Selecting the specific application provides an overview of the application's implemented events with their associated access. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_2.png" >}} + +From this view, access to the individual events can be configured. Changes take effect immediately when **Apply Changes** is clicked. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_3.png" width="300" >}} + +##### Default Behavior + +From the main overview page, an administrator can assign the default application behavior when they deploy to an environment for the first time by changing the configuration in the **Manage Default Access** dialog box. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_defaults.png" width="300" >}} + +From here, you can manage the default access settings: + +* **An app can access events defined in it** – enabling this setting allows newly-deployed applications to always have access to any events defined within that application (see [Creating a New Business Event Service](/appstore/services/business-events-configuration/#two-way-be-create) for more information) +* **For other events, in all environments, the app can:** + + * **Publish events it implements** + * **Subscribe to events it implements** + +## Mendix Event Broker Bridges + +Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies, such as AWS SQS, HTTP, Azure Blob Storage, AWS S3, and Apache Iceberg. For information on creating and managing bridges, see [Mendix Event Broker Bridges](/appstore/services/event-broker-bridges/). + +## Externally Defined Events {#externally-defined-events} + +Externally defined events refer to events that are defined outside the Mendix application, specifically outside Studio Pro. + +The Mendix Event Broker allows users to upload an AsyncAPI document for these external events. Once uploaded, users can download a new AsyncAPI document compatible with [Mendix Business Events](/appstore/services/business-events/), which can then be imported into Studio Pro to share the events across Mendix applications or use them in a new [Bridge](#manage-mx-broker-bridge). + +### Upload Events + +Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Uploaded Events** tab on the [Event Broker Manager](https://broker.mendix.com/) page. + +To begin, click **Get Started** or **Upload AsyncAPI Document**. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_get_started.png" >}} + +#### Upload an AsyncAPI File + +Upload an AsyncAPI contract based on the [AsyncAPI format](#asyncapi-format). If there are any errors with the content or file format, an error box will display a list of the issues found. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_1.png" >}} + +#### Verify File Information + +The details of the uploaded file are extracted in the **Verify** section. This allows you to confirm that all information is accurate and meets the required expectations. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_2.png" >}} + +#### Choose Spaces + +Select the spaces where the events will be used. When at least one space is selected, the **Create Service** button will be enabled. Click **Create Service** to create the service. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_3.png" >}} + +#### Successful Page + +You will get a confirmation that the externally defined events have been successfully uploaded and are now ready to be used in Bridges or applications. + +Click **Close** to continue. + +For more information on how to use an event, see [Usages](#event-usages). + +### Overview Page + +After a service is uploaded, it can be viewed on the Overview page. This page presents a list of uploaded events, along with their corresponding services and the spaces selected for the AsyncAPI. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_overview.png" >}} + +### Events and Services Details + +From the Overview page, users can access the Event and Service details by clicking on the event or service name in the table. Each page includes a drop-down selection for a space, which allows you to manage services and events specific to that space. + +#### Event Details + +This page provides information about the uploaded event, including the event name, PUB/SUB details, attributes, and [usages](#event-usages). + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_page.png" >}} + +#### Service Details {#service-details} + +The services details page includes information about the uploaded services, including the service name, description, and associated events. You can also delete a service within the selected space (subject to [deletion conditions](#delete-service)) and download the AsyncAPI contract to import into an existing Mendix application (for more information, see [Application Usages](#usages-app)). + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_service_page.png" >}} + +### Event Usages {#event-usages} + +Once an AsyncAPI contract is successfully uploaded, it can be used through Bridges or applications. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_usages.png" >}} + +#### Bridges + +To use an uploaded event in a Bridge, you must configure a [Bridge with AWS SQS](/appstore/services/event-broker-bridges/#bridge-with-aws-sqs). During the step **Choose business events to connect**, the newly uploaded events in the selected space from the previous step will be visible. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_add_bridge.png" >}} + +#### Applications {#usages-app} + +To use an uploaded event in an application, download the AsyncAPI contract for Studio Pro and import it as a new business event in your Mendix application. The download button is available on the [Service Details](#service-details) page. + +Use the **Use an existing business event service** option to import the file as a new business event. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_import_file.png" >}} + +Click **OK**. This creates the new business event that is ready to be used with the same features as any other imported event. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_imported_file.png" >}} + +### Delete Service {#delete-service} + +You can delete a service on the Service Details page. Deletion is only possible if the service is not being used in the selected space. This action is irreversible. If you want to re-upload the service to the space, you will need to upload the file again. + +{{% alert color="info" %}} + +Deleting a service only removes it from the selected space. The service will remain available in other spaces, if applicable. + +{{% /alert %}} + +### AsyncAPI Format {#asyncapi-format} + +Externally defined events are provided to the Event Broker via an AsyncAPI document, which must include the service information and event definitions. Any other content within the AsyncAPI document, if provided, will be ignored. + +The mandatory information required in the file includes: + +* **Title** – the service name +* **Message** – represents the business events +* **Payload** – the attributes that form the message + +{{% alert color="info" %}} + +Message names must be unique. Duplicate events cannot be uploaded if it is deployed anywhere in the Mendix space or uploaded before. + +{{% /alert %}} + +The supported version of AsyncAPI is 2.0.0, in accordance with [AsyncAPI documentation](https://v2.asyncapi.com/docs/reference/specification/v2.2.0). + +The file requirements are listed below: + +* Size: maximum file size is 1MB. +* Supported files: *.yml*, *.yaml*, *.json* diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md similarity index 60% rename from content/en/docs/marketplace/platform-supported-content/services/event-broker.md rename to content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md index e550103b5f0..bfe7e1cd77a 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md @@ -1,101 +1,14 @@ --- -title: "Mendix Event Broker" -url: /appstore/services/event-broker/ -linktitle: "Event Broker" -description: "Mendix Event Broker" +title: "Mendix Event Broker Bridges" +url: /appstore/services/event-broker-bridges/ +linktitle: "Event Broker Bridges" +description: "Describes how to create and manage Mendix Event Broker Bridges to integrate the Event Broker with external technologies such as AWS SQS, HTTP, Azure Blob Storage, AWS S3, and Apache Iceberg." aliases: + - /appstore/services/event-broker/#manage-mx-broker-bridge --- ## Introduction -Based on [Apache Kafka](https://kafka.apache.org/), the Mendix Event Broker is single-tenant and can only be used by apps running on nodes provisioned for your company. - -Events are published to a Kafka topic. Apps are subscribed to a Kafka topic to receive events, and messages use standard [CloudEvents payload format](https://github.com/cloudevents/spec/blob/v1.0.1/spec.md). - -There is a single Kafka broker for Free Apps that your company Free Apps can connect to. All Free Apps in your company publish and consume from the same Kafka broker. Events are published to one shared Kafka topic, and any Free App in your company can receive these events. - -## Mendix Event Broker License {#event-broker-license} - -Purchase a license to the Mendix Event Broker to deploy unlimited apps on production environments in Mendix Cloud. Ask your Customer Success Manager or Account Manager to reach out to purchase a license. See the [Mendix Event Broker](https://marketplace.mendix.com/link/component/202907) platform service page for more details. - -A license for the Mendix Event Broker is available for any Mendix region, but once selected, you can only run on a single region (no multi-region support). This license is available for all customers. You can also run business events on [your own Kafka cluster](/appstore/services/business-events-deployment/#byok). - -### Enabling the Mendix Event Broker Service {#enable-mx-event-broker} - -Once a license is purchased, a Technical Contact must enable the Event Broker Service on the [Mendix Portal](/developerportal/) for the [Mendix Cloud](/developerportal/deploy/mendix-cloud-deploy/) in the following places: - -1. On the app level under **Environments**, navigate to **Cloud Settings** ({{< icon name="settings-slider-1" >}}) and click [Services](/developerportal/deploy/environments/#services) -2. On the [Environment Details](/developerportal/deploy/environments-details/#services) page for each environment - -The Event Broker must be enabled on both the app and specific environment levels in order to use the Event Broker services. - -### Managing the Mendix Event Broker {#manage-mx-broker} - -Technical Contacts with a license for the Mendix Event Broker can manage its features on the [Event Broker Manager](https://broker.mendix.com/) page. - -#### Users for Event Broker Manager - -Users within the company's email domain that have a Mendix login can participate in the administration of the Mendix Event Broker as either a View or Admin user. They can also be blocked from participation. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user.png" >}} - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user_2.png" width="300" >}} - -Users that are not part of the customer organization (not within the email domain of the customer) can be invited with the same levels of access. Such users still require a standard Mendix login. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_external_user.png" width="300" >}} - -#### Spaces and Environments{#spaces} - -Spaces define which applications can exchange events with each other. When Business Events is enabled for an environment, it is placed in an Event Broker space based on the environment name. This enables apps deployed under the same space to publish and consume events. For example, apps in acceptance environment can only exchange events with other apps' acceptance environments. You can check the space of an app's environment on the [Event Broker Manager](https://broker.mendix.com/) page. - -Spaces are created and assigned based on the app environment name and allow isolation of your business events. The default behavior can be changed if needed. Contact [Mendix Support](https://support.mendix.com/) if you would like to change the space of a specific app environment. - -See the [Enabling the Mendix Event Broker Service](#enable-mx-event-broker) section above for more information. - -#### Topics and Channels {#topics-channels} - -Events are placed in channels, sometimes called topics. Apps subscribed to a channel will receive events published to this channel. - -Events published by Free Apps are published to one shared company channel on a multitenant free Event Broker. Events published by apps running on licensed nodes are published to their own channels on the company Event Broker. These channels, implemented as topics on Kafka, are automatically created upon deployment of the app publishing the events. - -#### Event Access Control {#access-control} - -The Mendix Event Broker allows access control to be applied down to the event level. Each application can be granted or denied access to events using the [Event Broker Manager](https://broker.mendix.com/). - -##### Types of Access - -The overview page contains a list of applications by environment within the organization's event landscape. The table contains columns that provide cases with exceptions: - -* **Implemented but no access** – an application has implemented an event that it is not allowed to access, guaranteeing a failure to subscribe to and/or publish the event -* **Has access but not implemented** – an application has been provided with more access than is required and you could make it more secure. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview.png" >}} - -Selecting the specific application provides an overview of the application's implemented events with their associated access. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_2.png" >}} - -From this view, access to the individual events can be configured. Changes take effect immediately when **Apply Changes** is clicked. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_3.png" width="300" >}} - -##### Default Behavior - -From the main overview page, an administrator can assign the default application behavior when they deploy to an environment for the first time by changing the configuration in the **Manage Default Access** dialog box. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_defaults.png" width="300" >}} - -From here, you can manage the default access settings: - -* **An app can access events defined in it** – enabling this setting allows newly-deployed applications to always have access to any events defined within that application (see [Creating a New Business Event Service](/appstore/services/business-events-configuration/#two-way-be-create) for more information) -* **For other events, in all environments, the app can:** - - * **Publish events it implements** - * **Subscribe to events it implements** - -## Mendix Event Broker Bridges {#manage-mx-broker-bridge} - {{% alert color="info" %}} Mendix Event Broker Bridges was released for GA in 11.4.0. {{% /alert %}} @@ -104,7 +17,7 @@ Mendix Event Broker Bridges facilitate integration between the Mendix Event Brok {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_bridges.png" class="no-border" >}} -### Standard Message Format +## Standard Message Format Every event must carry four mandatory CloudEvents core attributes, each prefixed with `ce_`: @@ -115,17 +28,17 @@ Every event must carry four mandatory CloudEvents core attributes, each prefixed See [CloudEvents](https://github.com/cloudevents/spec/blob/v1.0.1/spec.md#required-attributes) for more information on required attributes. -#### HTTP Bridge Headers +### HTTP Bridge Headers For HTTP Bridges, specific headers are required for authentication. -##### Required Header +#### Required Header * **Authorization** – must be set as a Bearer token using the Personal Access Token (PAT) generated during bridge configuration; for example: `Authorization: Bearer ` For details on how to obtain your Bearer token, see [Using the HTTP Bridge](#using-the-http-bridge). -##### Optional Headers +#### Optional Headers You can include additional HTTP headers in your request to provide event metadata, such as: @@ -133,7 +46,7 @@ You can include additional HTTP headers in your request to provide event metadat All custom HTTP headers will be forwarded as Kafka headers by default. -### Creating a Bridge +## Creating a Bridge Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. @@ -165,11 +78,11 @@ Technical Contacts with a license to the Mendix Event Broker can manage this fea Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. -### Configuring a Bridge with AWS SQS {#bridge-with-aws-sqs} +## Configuring a Bridge with AWS SQS {#bridge-with-aws-sqs} The creation process for AWS SQS bridges includes two additional steps on the Mendix side and policies that need to be implemented on the AWS side. -#### Configure Service +### Configure Service 1. Configure the service by filling out the following: * **Event Broker Space** – the space where the bridge will operate @@ -179,7 +92,7 @@ The creation process for AWS SQS bridges includes two additional steps on the Me 2. Click **Next** to continue the configuration. -#### Connect Events +### Connect Events Select the business events to integrate with AWS SQS: @@ -200,17 +113,17 @@ Select the business events to integrate with AWS SQS: 6. After all events have been configured, click **Start** to start the Mendix Event Broker Bridge. This process will take several minutes to complete. -#### Overview of AWS SQS Bridge +### Overview of AWS SQS Bridge Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_overview.png" class="no-border" width="400" >}} -#### Configure AWS Access Policy +### Configure AWS Access Policy You need to configure AWS access policies for both sending and receiving messages. -##### Sending Messages to Mendix +#### Sending Messages to Mendix Add the object below to the Access Policy of your AWS SQS queue if it is sending messages to Mendix. @@ -230,7 +143,7 @@ Add the object below to the Access Policy of your AWS SQS queue if it is sending } ``` -##### Receiving Messages from Mendix +#### Receiving Messages from Mendix Add the object below to your Access Policy of the AWS SQS queue if it is receiving messages from Mendix. @@ -252,9 +165,9 @@ Add the object below to your Access Policy of the AWS SQS queue if it is receivi } ``` -### Configuring a Bridge with HTTP {#bridge-with-http} +## Configuring a Bridge with HTTP {#bridge-with-http} -#### Configure Service +### Configure Service 1. Configure the service by filling out the following: @@ -266,7 +179,7 @@ Add the object below to your Access Policy of the AWS SQS queue if it is receivi 2. Click **Next** to connect events to your bridge. -#### Connect Events +### Connect Events Select the business events to integrate with the HTTP Bridge: @@ -277,22 +190,22 @@ Select the business events to integrate with the HTTP Bridge: 3. Click **Next** to proceed to the confirmation screen. -#### Overview of HTTP Bridge +### Overview of HTTP Bridge Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_overview.png" class="no-border" width="400" >}} -#### Using the HTTP Bridge {#using-the-http-bridge} +### Using the HTTP Bridge {#using-the-http-bridge} To run the HTTP bridge from your client, include a Bearer token in the request header. 1. Open the HTTP bridge details using the **Options** ({{% icon name="three-dots-menu-horizontal" %}}) menu on the **Overview** page. 2. Add the **Bearer token**. -### Configuring a Bridge with Azure Blob Storage {#bridge-with-azure-blob-storage} +## Configuring a Bridge with Azure Blob Storage {#bridge-with-azure-blob-storage} -#### Configure Service +### Configure Service 1. Configure the service by filling out the following: @@ -306,7 +219,7 @@ To run the HTTP bridge from your client, include a Bearer token in the request h 2. Click **Next** to connect events to your bridge. -#### Connect Events +### Connect Events Select the business events to integrate with Azure Blob Storage: @@ -317,15 +230,15 @@ Select the business events to integrate with Azure Blob Storage: 3. Click **Next** to proceed to the confirmation screen. -#### Overview of Azure Blob Storage Bridge +### Overview of Azure Blob Storage Bridge Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" class="no-border" >}} -### Configuring a Bridge with AWS S3 {#bridge-with-aws-s3} +## Configuring a Bridge with AWS S3 {#bridge-with-aws-s3} -#### Configure Service +### Configure Service 1. Configure the service by filling out the following: @@ -342,7 +255,7 @@ Once the Mendix Event Broker Bridge has been successfully deployed, its configur 2. Click **Next** to connect events to your bridge. -#### Connect Events +### Connect Events Select the business events to integrate with AWS S3: @@ -353,23 +266,23 @@ Select the business events to integrate with AWS S3: 3. Click **Next** to proceed to the confirmation screen. -#### Overview of AWS S3 Bridge +### Overview of AWS S3 Bridge Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_overview.png" class="no-border" >}} -#### Configure AWS Authentication for S3 Bridge {#configure-aws-s3-authentication} +### Configure AWS Authentication for S3 Bridge {#configure-aws-s3-authentication} The Mendix Event Broker runs in AWS and uses cross-account authentication to securely access your S3 bucket. This authentication mechanism leverages AWS IAM roles with trust policies and external IDs to ensure secure, controlled access. -##### Prerequisites +#### Prerequisites * Access to your AWS account with permissions to create and manage IAM roles * An S3 bucket where business events will be stored * The Mendix Event Broker AWS account ID: `044806572671` -##### Create an IAM Role with a Trust Policy +#### Create an IAM Role with a Trust Policy The trust policy defines which AWS accounts can assume the role. @@ -387,7 +300,7 @@ The external ID acts as a shared secret between Mendix and your AWS account. Thi {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_create_a_cross_account_role_in_aws.png" class="no-border" width="400" >}} -##### Attach Permissions Policy to the Role +#### Attach Permissions Policy to the Role The permissions policy defines what actions the Event Broker can perform once the role is assumed. @@ -427,19 +340,19 @@ The permissions policy defines what actions the Event Broker can perform once th The policy above grants the minimum required permissions for the Event Broker to write business events to your S3 bucket. Adjust the permissions as needed based on your security requirements. {{% /alert %}} -##### Complete Role Creation +#### Complete Role Creation 1. Provide a name for your role (for example, `EventBrokerS3AccessRole`). 2. Review the role configuration and click **Create role**. 3. Once created, open the role and copy the **Role ARN** (it will look like this: `arn:aws:iam::YOUR_ACCOUNT_ID:role/EventBrokerS3AccessRole`). -##### Configure the Bridge +#### Configure the Bridge Use the Role ARN and External ID when configuring your AWS S3 bridge in the Event Broker Manager. -### Configuring a Bridge with Iceberg {#bridge-with-iceberg} +## Configuring a Bridge with Iceberg {#bridge-with-iceberg} -#### Configure Service +### Configure Service 1. Configure the service by filling out the following: @@ -457,7 +370,7 @@ Use the Role ARN and External ID when configuring your AWS S3 bridge in the Even {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_configure.png" alt="" width="400" >}} -#### Connect Events +### Connect Events Select the CDC events that you want to deliver from the Event Broker to Iceberg: @@ -471,7 +384,7 @@ Select the CDC events that you want to deliver from the Event Broker to Iceberg: 3. Click **Next** to review and confirm the bridge configuration. -#### Overview of Iceberg Bridge +### Overview of Iceberg Bridge After the bridge is created, you can view its configuration and status on the **Overview** page. @@ -479,7 +392,7 @@ After the bridge is created, you can view its configuration and status on the ** Check the **Bridge Status** on the **Overview** page to verify that it is ready and operating as expected. The following list describes the possible bridge statuses. -#### Bridge Statuses +### Bridge Statuses * **Halted** – The bridge has stopped because an internal component failed. Data is not being delivered. * **Provisioning** – The bridge is being created or initialized and is not yet ready to deliver data. @@ -488,11 +401,11 @@ Check the **Bridge Status** on the **Overview** page to verify that it is ready * **Reconfiguring** – The bridge is applying configuration changes. Data delivery may be temporarily interrupted until the new configuration is synchronized. * **Awaiting Data** – The bridge is running and ready, but no source data is currently flowing. Data delivery will begin when data becomes available. -### Managing Bridges +## Managing Bridges After creating a bridge, you can modify and manage its configuration through the Event Broker Manager. -#### Editing Bridges +### Editing Bridges You can edit HTTP, Azure Blob Storage, AWS S3, and Iceberg bridges to modify their configuration as your integration requirements evolve, without needing to recreate the bridge. @@ -563,122 +476,3 @@ The **Apply** button is only enabled when changes have been made to the bridge c {{% alert color="warning" %}} If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. {{% /alert %}} - -## Externally Defined Events {#externally-defined-events} - -Externally defined events refer to events that are defined outside the Mendix application, specifically outside Studio Pro. - -The Mendix Event Broker allows users to upload an AsyncAPI document for these external events. Once uploaded, users can download a new AsyncAPI document compatible with [Mendix Business Events](/appstore/services/business-events/), which can then be imported into Studio Pro to share the events across Mendix applications or use them in a new [Bridge](#manage-mx-broker-bridge). - -### Upload Events - -Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Uploaded Events** tab on the [Event Broker Manager](https://broker.mendix.com/) page. - -To begin, click **Get Started** or **Upload AsyncAPI Document**. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_get_started.png" >}} - -#### Upload an AsyncAPI File - -Upload an AsyncAPI contract based on the [AsyncAPI format](#asyncapi-format). If there are any errors with the content or file format, an error box will display a list of the issues found. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_1.png" >}} - -#### Verify File Information - -The details of the uploaded file are extracted in the **Verify** section. This allows you to confirm that all information is accurate and meets the required expectations. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_2.png" >}} - -#### Choose Spaces - -Select the spaces where the events will be used. When at least one space is selected, the **Create Service** button will be enabled. Click **Create Service** to create the service. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_3.png" >}} - -#### Successful Page - -You will get a confirmation that the externally defined events have been successfully uploaded and are now ready to be used in Bridges or applications. - -Click **Close** to continue. - -For more information on how to use an event, see [Usages](#event-usages). - -### Overview Page - -After a service is uploaded, it can be viewed on the Overview page. This page presents a list of uploaded events, along with their corresponding services and the spaces selected for the AsyncAPI. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_overview.png" >}} - -### Events and Services Details - -From the Overview page, users can access the Event and Service details by clicking on the event or service name in the table. Each page includes a drop-down selection for a space, which allows you to manage services and events specific to that space. - -#### Event Details - -This page provides information about the uploaded event, including the event name, PUB/SUB details, attributes, and [usages](#event-usages). - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_page.png" >}} - -#### Service Details {#service-details} - -The services details page includes information about the uploaded services, including the service name, description, and associated events. You can also delete a service within the selected space (subject to [deletion conditions](#delete-service)) and download the AsyncAPI contract to import into an existing Mendix application (for more information, see [Application Usages](#usages-app)). - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_service_page.png" >}} - -### Event Usages {#event-usages} - -Once an AsyncAPI contract is successfully uploaded, it can be used through Bridges or applications. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_usages.png" >}} - -#### Bridges - -To use an uploaded event in a Bridge, you must configure a [Bridge with AWS SQS](#bridge-with-aws-sqs). During the step **Choose business events to connect**, the newly uploaded events in the selected space from the previous step will be visible. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_add_bridge.png" >}} - -#### Applications {#usages-app} - -To use an uploaded event in an application, download the AsyncAPI contract for Studio Pro and import it as a new business event in your Mendix application. The download button is available on the [Service Details](#service-details) page. - -Use the **Use an existing business event service** option to import the file as a new business event. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_import_file.png" >}} - -Click **OK**. This creates the new business event that is ready to be used with the same features as any other imported event. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_imported_file.png" >}} - -### Delete Service {#delete-service} - -You can delete a service on the Service Details page. Deletion is only possible if the service is not being used in the selected space. This action is irreversible. If you want to re-upload the service to the space, you will need to upload the file again. - -{{% alert color="info" %}} - -Deleting a service only removes it from the selected space. The service will remain available in other spaces, if applicable. - -{{% /alert %}} - -### AsyncAPI Format {#asyncapi-format} - -Externally defined events are provided to the Event Broker via an AsyncAPI document, which must include the service information and event definitions. Any other content within the AsyncAPI document, if provided, will be ignored. - -The mandatory information required in the file includes: - -* **Title** – the service name -* **Message** – represents the business events -* **Payload** – the attributes that form the message - -{{% alert color="info" %}} - -Message names must be unique. Duplicate events cannot be uploaded if it is deployed anywhere in the Mendix space or uploaded before. - -{{% /alert %}} - -The supported version of AsyncAPI is 2.0.0, in accordance with [AsyncAPI documentation](https://v2.asyncapi.com/docs/reference/specification/v2.2.0). - -The file requirements are listed below: - -* Size: maximum file size is 1MB. -* Supported files: *.yml*, *.yaml*, *.json* diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md new file mode 100644 index 00000000000..b4ce826c576 --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -0,0 +1,68 @@ +--- +title: "Configure an HTTP Bridge" +url: /appstore/services/http-bridge/ +linktitle: "Configure an HTTP Bridge" +--- + +## Introduction + +An HTTP bridge is a one-way bridge that uses HTTP requests to send events from external systems to the Mendix Event Broker. + +## HTTP Bridge Headers + +HTTP Bridges require specific headers for authentication. **Authorization** must be set as a Bearer token using the Personal Access Token (PAT) generated during bridge configuration; for example: `Authorization: Bearer ` + +For details on how to obtain your Bearer token, see the [Using the HTTP Bridge](#using-the-http-bridge) section below. + +### Optional Headers + +You can include additional HTTP headers in your request to provide event metadata, such as: + +* `ce_time` – sets the published time of the event; for example: `2025-06-13T15:36:52.148542+02:00` + +All custom HTTP headers will be forwarded as Kafka headers by default. + +## Creating a Bridge + +Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} + +1. Click **Create a Bridge** to create a new bridge. +2. Select **HTTP**. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. + +Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_overview.png" class="no-border" width="400" >}} + +## Configure Service {#configure-http-bridge} + +1. Configure the service by filling out the following: + + * **Event Broker Space** – the space where the bridge will operate + * **Name** – the name you want to call the bridge + * **AWS region** – the AWS region where your bridge operates + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_configure.png" width="400" >}} + +2. Click **Next** to connect events to your bridge. + +## Connect Events + +Select the business events to integrate with the HTTP Bridge: + +1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of subscribing are shown, as this bridge operates in one direction. +2. Select the event(s) to integrate. Once selected, the URL for the HTTP connection is automatically generated. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_connect_events.png" width="400" >}} + +3. Click **Next** to proceed to the confirmation screen. + +## Using the HTTP Bridge {#using-the-http-bridge} + +To run the HTTP bridge from your client, include a Bearer token in the request header. + +1. Open the HTTP bridge details using the **Options** ({{% icon name="three-dots-menu-horizontal" %}}) menu on the **Overview** page. +2. Add the **Bearer token**. \ No newline at end of file diff --git a/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md b/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md index dcad465b41d..d20f949056b 100644 --- a/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md +++ b/content/en/docs/refguide/modeling/integration/change-data-capture/_index.md @@ -21,7 +21,7 @@ Read events are triggered as snapshots during startup or when a stream changes i The broker that receives these events is either the [Mendix Event Broker](/appstore/services/event-broker/) or a Bring Your Own Kafka (BYOK) cluster. For BYOK configuration details, see [Mendix Event Broker](/appstore/services/event-broker/). -To move the streamed data to a destination (such as Azure Blob Storage or AWS S3), you configure an [Event Broker Bridge](/appstore/services/event-broker/#manage-mx-broker-bridge) separately in the Event Broker Manager after deployment. +To move the streamed data to a destination (such as Azure Blob Storage or AWS S3), you configure an [Event Broker Bridge](/appstore/services/event-broker-bridges/) separately in the Event Broker Manager after deployment. ## Prerequisites @@ -31,7 +31,7 @@ Change Data Capture is not available for Free Apps. A licensed Mendix Cloud envi * A licensed Mendix Cloud environment * A [Mendix Event Broker](/appstore/services/event-broker/) license, or a BYOK Kafka cluster configured as described in [Mendix Event Broker](/appstore/services/event-broker/) -* An [Event Broker Bridge](/appstore/services/event-broker/#manage-mx-broker-bridge) configured in the Event Broker Manager if you want to route CDC events to external storage +* An [Event Broker Bridge](/appstore/services/event-broker-bridges/) configured in the Event Broker Manager if you want to route CDC events to external storage ## Setting Up Change Data Capture @@ -40,7 +40,7 @@ Set up a CDC service in Studio Pro by following the steps below: 1. In Studio Pro, right-click a module in the App Explorer and choose **Add other** > **Change data capture service**. 2. Select the entities to track and set an exposed name for each. For more information on configuring entities, see the [Entities to Track](/refguide/published-cdc-services/#entities) section of *Published CDC Services*. 3. Deploy the app. The Runtime creates Kafka topics for each tracked entity automatically. -4. In the [Event Broker Manager](https://broker.mendix.com/), configure an [Event Broker Bridge](/appstore/services/event-broker/#manage-mx-broker-bridge) to route CDC events to your destination. +4. In the [Event Broker Manager](https://broker.mendix.com/), configure an [Event Broker Bridge](/appstore/services/event-broker-bridges/) to route CDC events to your destination. ## Runtime Configuration {#runtime-configuration} @@ -102,4 +102,4 @@ For details on setting up a BYOK cluster with the Mendix Event Broker, see [Mend * [Published CDC Services](/refguide/published-cdc-services/) * [Mendix Event Broker](/appstore/services/event-broker/) -* [Event Broker Bridges](/appstore/services/event-broker/#manage-mx-broker-bridge) +* [Event Broker Bridges](/appstore/services/event-broker-bridges/) diff --git a/content/en/docs/refguide/modeling/integration/change-data-capture/published-cdc-services.md b/content/en/docs/refguide/modeling/integration/change-data-capture/published-cdc-services.md index 629ca63c05f..8e794c8c21c 100644 --- a/content/en/docs/refguide/modeling/integration/change-data-capture/published-cdc-services.md +++ b/content/en/docs/refguide/modeling/integration/change-data-capture/published-cdc-services.md @@ -99,4 +99,4 @@ The following describe how the CDC service behaves at runtime: * [Change Data Capture](/refguide/change-data-capture/) * [Mendix Event Broker](/appstore/services/event-broker/) -* [Event Broker Bridges](/appstore/services/event-broker/#manage-mx-broker-bridge) +* [Event Broker Bridges](/appstore/services/event-broker-bridges/) From fd0fb4648215178312ff5de72382c417b789fc37 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Wed, 2 Sep 2026 16:14:47 +0200 Subject: [PATCH 02/18] Add AWS SQS Bridge doc --- .../event-broker-bridges/aws-sqs-bridge.md | 100 ++++++++++++++++++ .../event-broker-bridges/http-bridge.md | 4 +- 2 files changed, 102 insertions(+), 2 deletions(-) create mode 100644 content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md new file mode 100644 index 00000000000..55047dc6ee5 --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md @@ -0,0 +1,100 @@ +--- +title: "Configure a Bridge with AWS SQS" +url: /appstore/services/aws-sqs-bridge/ +linktitle: "Configure a Bridge with AWS SQS" +--- + +## Introduction + +An AWS SQS Bridge is a bidirectional bridge using the [Amazon Simple Queue Service](https://aws.amazon.com/sqs/) to send and receive events. The creation process for AWS SQS bridges includes two additional steps on the Mendix side and policies that need to be implemented on the AWS side. + +## Creating a Bridge + +Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} + +1. Click **Create a Bridge** to create a new bridge. +2. Select **AWS SQS**. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. + +Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_overview.png" class="no-border" width="400" >}} + +## Configure Service + +1. Configure the service by filling out the following: + * **Event Broker Space** – the space where the bridge will operate + * **Name** – the name you want to call the bridge + * **AWS region** – the AWS region where your bridge operates + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_configure.png" width="400" >}} +2. Click **Next** to continue the configuration. + +## Connect Events + +Select the business events to integrate with AWS SQS: + +1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. +2. Select the checkbox for the event(s) you want to add, then click **Select**. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_choose_events.png" width="400" >}} + +3. Configure each event with its own SQS URL for each direction the event will be integrated. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_connect_events.png" width="400" >}} + +4. Click **Next** to continue. + +5. Confirm the configuration with the AWS Access Policy. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_approve_policy.png" width="400" >}} + +6. After all events have been configured, click **Start** to start the Mendix Event Broker Bridge. This process will take several minutes to complete. + +## Configure AWS Access Policy + +You need to configure AWS access policies for both sending and receiving messages. + +### Sending Messages to Mendix + +Add the object below to the Access Policy of your AWS SQS queue if it is sending messages to Mendix. + +``` +{ + "Sid": "__sender_statement", + "Effect": "Allow", + "Principal": { + "AWS": [ + "arn:aws:iam::044806572671:role/mendix-event-broker-bridge" + ] + }, + "Action": [ + "SQS:SendMessage" + ], + "Resource": "" +} +``` + +### Receiving Messages from Mendix + +Add the object below to your Access Policy of the AWS SQS queue if it is receiving messages from Mendix. + +``` +{ + "Sid": "__receiver_statement", + "Effect": "Allow", + "Principal": { + "AWS": [ + "arn:aws:iam::044806572671:role/mendix-event-broker-bridge" + ] + }, + "Action": [ + "SQS:ChangeMessageVisibility", + "SQS:DeleteMessage", + "SQS:ReceiveMessage" + ], + "Resource": "" +} +``` \ No newline at end of file diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index b4ce826c576..334d1b9bb8b 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -1,7 +1,7 @@ --- -title: "Configure an HTTP Bridge" +title: "Configure a Bridge with HTTP" url: /appstore/services/http-bridge/ -linktitle: "Configure an HTTP Bridge" +linktitle: "Configure a Bridge with HTTP" --- ## Introduction From e0743a1083a01aa74b78b0296e60124abdc639d8 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Wed, 2 Sep 2026 17:05:34 +0200 Subject: [PATCH 03/18] Add Blob Storage bridge --- .../event-broker-bridges/aws-sqs-bridge.md | 2 +- .../event-broker-bridges/blob-bridge.md | 49 +++++++++++++++++++ .../event-broker-bridges/http-bridge.md | 2 +- 3 files changed, 51 insertions(+), 2 deletions(-) create mode 100644 content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md index 55047dc6ee5..9a0eaefc8ec 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md @@ -1,7 +1,7 @@ --- title: "Configure a Bridge with AWS SQS" url: /appstore/services/aws-sqs-bridge/ -linktitle: "Configure a Bridge with AWS SQS" +linktitle: "AWS SQS Bridge" --- ## Introduction diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md new file mode 100644 index 00000000000..3ad2bdac810 --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md @@ -0,0 +1,49 @@ +--- +title: "Configure a Bridge with Azure Blob Storage" +url: /appstore/services/blob-bridge/ +linktitle: "Azure Blob Storage Bridge" +--- + +## Introduction + +An Azure Blob Bridge is a one-way bridge that receives events via Azure object storage. + +## Creating a Bridge + +Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} + +1. Click **Create a Bridge** to create a new bridge. +2. Select **Azure Blob Storage**. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. + +Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" class="no-border" >}} + +# Configure Service + +1. Configure the service by filling out the following: + + * **Event Broker Space** – the space where the bridge will operate + * **Name** – the name you want to call the bridge + * **Storage Account** – the storage account to access + * **Storage SAS Token** – the storage SAS Token + * **Container Path** – the path of the container where the messages will be stored + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_configure.png" >}} + +2. Click **Next** to connect events to your bridge. + +### Connect Events + +Select the business events to integrate with Azure Blob Storage: + +1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of publishing are shown, as this bridge operates in one direction. +2. Select the event(s) to integrate and specify the prefix path for event storage. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_connect_events.png" >}} + +3. Click **Next** to proceed to the confirmation screen. diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index 334d1b9bb8b..ce54bd09176 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -1,7 +1,7 @@ --- title: "Configure a Bridge with HTTP" url: /appstore/services/http-bridge/ -linktitle: "Configure a Bridge with HTTP" +linktitle: "HTTP Bridge" --- ## Introduction From a3a4b588f66edba054575d7fef280284e3b435db Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Wed, 2 Sep 2026 17:09:33 +0200 Subject: [PATCH 04/18] Add AWS S3 Bridge --- .../event-broker-bridges/aws-s3-bridge.md | 130 ++++++++++++++++++ 1 file changed, 130 insertions(+) create mode 100644 content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md new file mode 100644 index 00000000000..9a9b4c349b6 --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md @@ -0,0 +1,130 @@ +--- +title: "Configure a Bridge with AWS S3" +url: /appstore/services/aws-s3-bridge/ +linktitle: "AWS S3 Bridge" +--- + +## Introduction + +An AWS S3 Bridge is a one-way bridge that receives events via AWS object storage. + +## Creating a Bridge + +Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} + +1. Click **Create a Bridge** to create a new bridge. +2. Select **AWS S3**. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. + +Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_overview.png" class="no-border" >}} + +## Configure Service + +1. Configure the service by filling out the following: + + * **Event Broker Space** – the space where the bridge will operate + * **Name** – the name you want to call the bridge + * **Bucket** – the path of the container where the messages will be stored + * **AWS Region for Bucket** – the AWS region where your S3 bucket is located + * **AWS Role (to Assume)** – the Amazon Resource Name (ARN) of the IAM role that the Event Broker Bridge will assume to access your S3 bucket; this role must be configured with appropriate permissions and a trust policy allowing the Event Broker to assume it + * **AWS Role's External Id** – a unique identifier that provides additional security when the Event Broker assumes your AWS role; this shared secret ensures that only authorized Mendix Event Broker instances can assume the role + + {{% alert color="info" %}}For detailed instructions on how to create the IAM role and obtain these values, see [Configure AWS Authentication for S3 Bridge](#configure-aws-s3-authentication).{{% /alert %}} + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_configure.png" >}} + +2. Click **Next** to connect events to your bridge. + +## Connect Events + +Select the business events to integrate with AWS S3: + +1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of publishing are shown, as this bridge operates in one direction. +2. Select the event(s) to integrate and specify the prefix path for event storage. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_connect_events.png" >}} + +3. Click **Next** to proceed to the confirmation screen. + +## Configure AWS Authentication {#configure-aws-s3-authentication} + +The Mendix Event Broker runs in AWS and uses cross-account authentication to securely access your S3 bucket. This authentication mechanism leverages AWS IAM roles with trust policies and external IDs to ensure secure, controlled access. + +### Prerequisites + +* Access to your AWS account with permissions to create and manage IAM roles +* An S3 bucket where business events will be stored +* The Mendix Event Broker AWS account ID: `044806572671` + +### Create an IAM Role with a Trust Policy + +The trust policy defines which AWS accounts can assume the role. + +1. Navigate to **IAM** > **Roles** in your AWS Console. +2. Click **Create role**. +3. Select **AWS account** as the trusted entity type. +4. Choose **Another AWS account**. +5. Enter the Mendix Event Broker AWS account ID: `044806572671` +6. Select **Require external ID** and enter a unique external ID of your choice. This external ID will be required when configuring the bridge in the Event Broker Manager. +7. Click **Next**. + +{{% alert color="info" %}} +The external ID acts as a shared secret between Mendix and your AWS account. This prevents the confused deputy problem and ensures that only authorized Event Broker instances can assume your role. +{{% /alert %}} + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_create_a_cross_account_role_in_aws.png" class="no-border" width="400" >}} + +### Attach Permissions Policy to the Role + +The permissions policy defines what actions the Event Broker can perform once the role is assumed. + +1. Click **Create policy** to create a new policy, or select an existing policy. +2. If creating a new policy, use the following JSON template to grant the necessary S3 permissions: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Sid": "AllowWriteObjects", + "Effect": "Allow", + "Action": [ + "s3:PutObject", + "s3:PutObjectAcl", + "s3:DeleteObject" + ], + "Resource": "arn:aws:s3:::BUCKET_NAME/*" + }, + { + "Sid": "AllowListBucket", + "Effect": "Allow", + "Action": "s3:ListBucket", + "Resource": "arn:aws:s3:::BUCKET_NAME" + } + ] + } + ``` + +3. Replace `BUCKET_NAME` with your actual S3 bucket name. +4. Name your policy (for example, `EventBrokerS3WritePolicy`) and create it. +5. Attach the policy to your IAM role. +6. Click **Next**. + +{{% alert color="info" %}} +The policy above grants the minimum required permissions for the Event Broker to write business events to your S3 bucket. Adjust the permissions as needed based on your security requirements. +{{% /alert %}} + +### Complete Role Creation + +1. Provide a name for your role (for example, `EventBrokerS3AccessRole`). +2. Review the role configuration and click **Create role**. +3. Once created, open the role and copy the **Role ARN** (it will look like this: `arn:aws:iam::YOUR_ACCOUNT_ID:role/EventBrokerS3AccessRole`). + +### Configure the Bridge + +Use the Role ARN and External ID when configuring your AWS S3 bridge in the Event Broker Manager. \ No newline at end of file From 10f657e1abf484af968de4b049a393c9f4d1fb5d Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Wed, 2 Sep 2026 17:12:58 +0200 Subject: [PATCH 05/18] Add Iceberg Bridge --- .../event-broker-bridges/iceberg-bridge.md | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md new file mode 100644 index 00000000000..42a4caf873d --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md @@ -0,0 +1,67 @@ +--- +title: "Configure a Bridge with Apache Iceberg" +url: /appstore/services/iceberg-bridge/ +linktitle: "Apache Iceberg Bridge" +--- + +## Introduction + +An Apache Iceberg Bridge is a one-way bridge that delivers [Change Data Capture (CDC)](/refguide/change-data-capture/) events to Apache Iceberg tables stored in AWS S3 or Azure Blob Storage. + +## Creating a Bridge + +Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} + +1. Click **Create a Bridge** to create a new bridge. +2. Select **Iceberge**. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. + +Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_overview.png" alt="" class="no-border" width="400" >}} + +## Configure Service + +Configure the service by filling out the following: + +* **Event Broker Space** – the space where the bridge operates +* **Name** – a name for the bridge +* **Choose a data lake** – the data lake that Iceberg uses to store your data + * **Azure Blob Storage** + * **Storage Account** – the storage account to access + * **Storage SAS Token** – the SAS token used to access the storage account + * **Container** – the container where the data is stored + * **AWS S3** + * **Bucket** – the bucket where the data is stored + * **AWS Region for Bucket** – the AWS region where the bucket is located + * **AWS Role (to Assume)** – the AWS role to assume for the required permissions + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_configure.png" alt="" width="400" >}} + +## Connect Events + +Select the CDC events that you want to deliver from the Event Broker to Iceberg: + +1. Click **Add CDC Events** to open a dialog box displaying the available CDC events managed by the Event Broker. Only events that can be subscribed to are shown because the bridge delivers events in one direction, from the Event Broker to Iceberg. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_connect_events.png" alt="" width="400" >}} + +2. Select one or more CDC events to integrate. The Iceberg connection configuration is automatically generated based on the selected events. + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_choose_cdc_events.png" alt="" width="400" >}} + +3. Click **Next** to review and confirm the bridge configuration. + +### Bridge Statuses + +Check the **Bridge Status** on the **Overview** page to verify that it is ready and operating as expected. The following list describes the possible bridge statuses. + +* **Halted** – The bridge has stopped because an internal component failed. Data is not being delivered. +* **Provisioning** – The bridge is being created or initialized and is not yet ready to deliver data. +* **Delivering** – The bridge is healthy, fully configured, and actively delivering data to the destination. +* **Misconfigured** – The bridge is running, but its data flow is not healthy or cannot be fully verified. Check the bridge configuration and data flow. +* **Reconfiguring** – The bridge is applying configuration changes. Data delivery may be temporarily interrupted until the new configuration is synchronized. +* **Awaiting Data** – The bridge is running and ready, but no source data is currently flowing. Data delivery will begin when data becomes available. \ No newline at end of file From 64a506305b9d983316ad0844c75d3bcd4d97d0c9 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 10:20:44 +0200 Subject: [PATCH 06/18] Adjust links --- .../services/event-broker/_index.md | 10 +- .../event-broker-bridges/_index.md | 362 +----------------- .../event-broker-bridges/aws-s3-bridge.md | 2 +- .../event-broker-bridges/aws-sqs-bridge.md | 2 +- .../event-broker-bridges/blob-bridge.md | 2 +- .../event-broker-bridges/http-bridge.md | 2 +- .../event-broker-bridges/iceberg-bridge.md | 2 +- 7 files changed, 19 insertions(+), 363 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md index 2ccf8e70df0..0b418834d3f 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -96,7 +96,15 @@ From here, you can manage the default access settings: ## Mendix Event Broker Bridges -Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies, such as AWS SQS, HTTP, Azure Blob Storage, AWS S3, and Apache Iceberg. For information on creating and managing bridges, see [Mendix Event Broker Bridges](/appstore/services/event-broker-bridges/). +Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies. For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). + +Mendix Event Broker Bridges facilitate integration between the Event BRoker and the following technologies: + +* [AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/) +* [HTTP](/appstore/services/event-broker-bridges/http-bridge/) +* [Azure Blob Storage]((/appstore/services/event-broker-bridges/blob-bridge/) ) +* [AWS S3](/appstore/services/aws-s3-bridge/) +* [Iceberg](/appstore/services/event-broker-bridges/iceberg-bridge/) ## Externally Defined Events {#externally-defined-events} diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md index bfe7e1cd77a..65f972948fb 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md @@ -28,24 +28,6 @@ Every event must carry four mandatory CloudEvents core attributes, each prefixed See [CloudEvents](https://github.com/cloudevents/spec/blob/v1.0.1/spec.md#required-attributes) for more information on required attributes. -### HTTP Bridge Headers - -For HTTP Bridges, specific headers are required for authentication. - -#### Required Header - -* **Authorization** – must be set as a Bearer token using the Personal Access Token (PAT) generated during bridge configuration; for example: `Authorization: Bearer ` - - For details on how to obtain your Bearer token, see [Using the HTTP Bridge](#using-the-http-bridge). - -#### Optional Headers - -You can include additional HTTP headers in your request to provide event metadata, such as: - -* `ce_time` – sets the published time of the event; for example: `2025-06-13T15:36:52.148542+02:00` - -All custom HTTP headers will be forwarded as Kafka headers by default. - ## Creating a Bridge Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. @@ -56,351 +38,17 @@ Technical Contacts with a license to the Mendix Event Broker can manage this fea 2. Select one of the following bridge types: - * **AWS SQS** – bidirectional bridge using the [Amazon Simple Queue Service](https://aws.amazon.com/sqs/) to send and receive events - * **HTTP** – one-way bridge that uses HTTP requests to send events from external systems to the Mendix Event Broker - * **Azure Blob Storage** – one-way bridge that receives events via Azure object storage - * **AWS S3** – one-way bridge that receives events via AWS object storage - * **Iceberg** – one-way bridge that delivers [Change Data Capture (CDC)](/refguide/change-data-capture/) events to Apache Iceberg tables stored in AWS S3 or Azure Blob Storage - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/ebb_general_bridge_create.png" >}} + * [AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/) + * [HTTP](/appstore/services/event-broker-bridges/http-bridge/) + * [Azure Blob Storage]((/appstore/services/event-broker-bridges/blob-bridge/) ) + * [AWS S3](/appstore/services/aws-s3-bridge/) + * [Iceberg](/appstore/services/event-broker-bridges/iceberg-bridge/) 3. Click **Next** to continue creating your bridge. - - * For instructions on configuring AWS SQS, see [Configuring a Bridge with AWS SQS](#bridge-with-aws-sqs). - * For instructions on configuring HTTP, see [Configuring a Bridge with HTTP](#bridge-with-http). - * For instructions on configuring Azure Blob Storage, see [Configuring a Bridge with Azure Blob Storage](#bridge-with-azure-blob-storage). - * For instructions on configuring AWS S3, see [Configuring a Bridge with AWS S3](#bridge-with-aws-s3). - * For instructions on configuring Iceberg, see [Configuring a Bridge with Iceberg](#bridge-with-iceberg). - 4. After configuring the service and connecting events (as described in the bridge-specific sections above), click **Start** on the confirmation screen to deploy the bridge. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/ebb_general_bridge_start.png" >}} - Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. -## Configuring a Bridge with AWS SQS {#bridge-with-aws-sqs} - -The creation process for AWS SQS bridges includes two additional steps on the Mendix side and policies that need to be implemented on the AWS side. - -### Configure Service - -1. Configure the service by filling out the following: - * **Event Broker Space** – the space where the bridge will operate - * **Name** – the name you want to call the bridge - * **AWS region** – the AWS region where your bridge operates - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_configure.png" width="400" >}} - -2. Click **Next** to continue the configuration. - -### Connect Events - -Select the business events to integrate with AWS SQS: - -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. -2. Select the checkbox for the event(s) you want to add, then click **Select**. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_choose_events.png" width="400" >}} - -3. Configure each event with its own SQS URL for each direction the event will be integrated. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_connect_events.png" width="400" >}} - -4. Click **Next** to continue. - -5. Confirm the configuration with the AWS Access Policy. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_approve_policy.png" width="400" >}} - -6. After all events have been configured, click **Start** to start the Mendix Event Broker Bridge. This process will take several minutes to complete. - -### Overview of AWS SQS Bridge - -Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_overview.png" class="no-border" width="400" >}} - -### Configure AWS Access Policy - -You need to configure AWS access policies for both sending and receiving messages. - -#### Sending Messages to Mendix - -Add the object below to the Access Policy of your AWS SQS queue if it is sending messages to Mendix. - -``` -{ - "Sid": "__sender_statement", - "Effect": "Allow", - "Principal": { - "AWS": [ - "arn:aws:iam::044806572671:role/mendix-event-broker-bridge" - ] - }, - "Action": [ - "SQS:SendMessage" - ], - "Resource": "" -} -``` - -#### Receiving Messages from Mendix - -Add the object below to your Access Policy of the AWS SQS queue if it is receiving messages from Mendix. - -``` -{ - "Sid": "__receiver_statement", - "Effect": "Allow", - "Principal": { - "AWS": [ - "arn:aws:iam::044806572671:role/mendix-event-broker-bridge" - ] - }, - "Action": [ - "SQS:ChangeMessageVisibility", - "SQS:DeleteMessage", - "SQS:ReceiveMessage" - ], - "Resource": "" -} -``` - -## Configuring a Bridge with HTTP {#bridge-with-http} - -### Configure Service - -1. Configure the service by filling out the following: - - * **Event Broker Space** – the space where the bridge will operate - * **Name** – the name you want to call the bridge - * **AWS region** – the AWS region where your bridge operates - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_configure.png" width="400" >}} - -2. Click **Next** to connect events to your bridge. - -### Connect Events - -Select the business events to integrate with the HTTP Bridge: - -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of subscribing are shown, as this bridge operates in one direction. -2. Select the event(s) to integrate. Once selected, the URL for the HTTP connection is automatically generated. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_connect_events.png" width="400" >}} - -3. Click **Next** to proceed to the confirmation screen. - -### Overview of HTTP Bridge - -Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_overview.png" class="no-border" width="400" >}} - -### Using the HTTP Bridge {#using-the-http-bridge} - -To run the HTTP bridge from your client, include a Bearer token in the request header. - -1. Open the HTTP bridge details using the **Options** ({{% icon name="three-dots-menu-horizontal" %}}) menu on the **Overview** page. -2. Add the **Bearer token**. - -## Configuring a Bridge with Azure Blob Storage {#bridge-with-azure-blob-storage} - -### Configure Service - -1. Configure the service by filling out the following: - - * **Event Broker Space** – the space where the bridge will operate - * **Name** – the name you want to call the bridge - * **Storage Account** – the storage account to access - * **Storage SAS Token** – the storage SAS Token - * **Container Path** – the path of the container where the messages will be stored - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_configure.png" >}} - -2. Click **Next** to connect events to your bridge. - -### Connect Events - -Select the business events to integrate with Azure Blob Storage: - -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of publishing are shown, as this bridge operates in one direction. -2. Select the event(s) to integrate and specify the prefix path for event storage. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_connect_events.png" >}} - -3. Click **Next** to proceed to the confirmation screen. - -### Overview of Azure Blob Storage Bridge - -Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" class="no-border" >}} - -## Configuring a Bridge with AWS S3 {#bridge-with-aws-s3} - -### Configure Service - -1. Configure the service by filling out the following: - - * **Event Broker Space** – the space where the bridge will operate - * **Name** – the name you want to call the bridge - * **Bucket** – the path of the container where the messages will be stored - * **AWS Region for Bucket** – the AWS region where your S3 bucket is located - * **AWS Role (to Assume)** – the Amazon Resource Name (ARN) of the IAM role that the Event Broker Bridge will assume to access your S3 bucket; this role must be configured with appropriate permissions and a trust policy allowing the Event Broker to assume it - * **AWS Role's External Id** – a unique identifier that provides additional security when the Event Broker assumes your AWS role; this shared secret ensures that only authorized Mendix Event Broker instances can assume the role - - {{% alert color="info" %}}For detailed instructions on how to create the IAM role and obtain these values, see [Configure AWS Authentication for S3 Bridge](#configure-aws-s3-authentication).{{% /alert %}} - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_configure.png" >}} - -2. Click **Next** to connect events to your bridge. - -### Connect Events - -Select the business events to integrate with AWS S3: - -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of publishing are shown, as this bridge operates in one direction. -2. Select the event(s) to integrate and specify the prefix path for event storage. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_connect_events.png" >}} - -3. Click **Next** to proceed to the confirmation screen. - -### Overview of AWS S3 Bridge - -Once the Mendix Event Broker Bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_overview.png" class="no-border" >}} - -### Configure AWS Authentication for S3 Bridge {#configure-aws-s3-authentication} - -The Mendix Event Broker runs in AWS and uses cross-account authentication to securely access your S3 bucket. This authentication mechanism leverages AWS IAM roles with trust policies and external IDs to ensure secure, controlled access. - -#### Prerequisites - -* Access to your AWS account with permissions to create and manage IAM roles -* An S3 bucket where business events will be stored -* The Mendix Event Broker AWS account ID: `044806572671` - -#### Create an IAM Role with a Trust Policy - -The trust policy defines which AWS accounts can assume the role. - -1. Navigate to **IAM** > **Roles** in your AWS Console. -2. Click **Create role**. -3. Select **AWS account** as the trusted entity type. -4. Choose **Another AWS account**. -5. Enter the Mendix Event Broker AWS account ID: `044806572671` -6. Select **Require external ID** and enter a unique external ID of your choice. This external ID will be required when configuring the bridge in the Event Broker Manager. -7. Click **Next**. - -{{% alert color="info" %}} -The external ID acts as a shared secret between Mendix and your AWS account. This prevents the confused deputy problem and ensures that only authorized Event Broker instances can assume your role. -{{% /alert %}} - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_create_a_cross_account_role_in_aws.png" class="no-border" width="400" >}} - -#### Attach Permissions Policy to the Role - -The permissions policy defines what actions the Event Broker can perform once the role is assumed. - -1. Click **Create policy** to create a new policy, or select an existing policy. -2. If creating a new policy, use the following JSON template to grant the necessary S3 permissions: - - ```json - { - "Version": "2012-10-17", - "Statement": [ - { - "Sid": "AllowWriteObjects", - "Effect": "Allow", - "Action": [ - "s3:PutObject", - "s3:PutObjectAcl", - "s3:DeleteObject" - ], - "Resource": "arn:aws:s3:::BUCKET_NAME/*" - }, - { - "Sid": "AllowListBucket", - "Effect": "Allow", - "Action": "s3:ListBucket", - "Resource": "arn:aws:s3:::BUCKET_NAME" - } - ] - } - ``` - -3. Replace `BUCKET_NAME` with your actual S3 bucket name. -4. Name your policy (for example, `EventBrokerS3WritePolicy`) and create it. -5. Attach the policy to your IAM role. -6. Click **Next**. - -{{% alert color="info" %}} -The policy above grants the minimum required permissions for the Event Broker to write business events to your S3 bucket. Adjust the permissions as needed based on your security requirements. -{{% /alert %}} - -#### Complete Role Creation - -1. Provide a name for your role (for example, `EventBrokerS3AccessRole`). -2. Review the role configuration and click **Create role**. -3. Once created, open the role and copy the **Role ARN** (it will look like this: `arn:aws:iam::YOUR_ACCOUNT_ID:role/EventBrokerS3AccessRole`). - -#### Configure the Bridge - -Use the Role ARN and External ID when configuring your AWS S3 bridge in the Event Broker Manager. - -## Configuring a Bridge with Iceberg {#bridge-with-iceberg} - -### Configure Service - -1. Configure the service by filling out the following: - - * **Event Broker Space** – the space where the bridge operates - * **Name** – a name for the bridge - * **Choose a data lake** – the data lake that Iceberg uses to store your data - * **Azure Blob Storage** - * **Storage Account** – the storage account to access - * **Storage SAS Token** – the SAS token used to access the storage account - * **Container** – the container where the data is stored - * **AWS S3** - * **Bucket** – the bucket where the data is stored - * **AWS Region for Bucket** – the AWS region where the bucket is located - * **AWS Role (to Assume)** – the AWS role to assume for the required permissions - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_configure.png" alt="" width="400" >}} - -### Connect Events - -Select the CDC events that you want to deliver from the Event Broker to Iceberg: - -1. Click **Add CDC Events** to open a dialog box displaying the available CDC events managed by the Event Broker. Only events that can be subscribed to are shown because the bridge delivers events in one direction, from the Event Broker to Iceberg. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_connect_events.png" alt="" width="400" >}} - -2. Select one or more CDC events to integrate. The Iceberg connection configuration is automatically generated based on the selected events. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_choose_cdc_events.png" alt="" width="400" >}} - -3. Click **Next** to review and confirm the bridge configuration. - -### Overview of Iceberg Bridge - -After the bridge is created, you can view its configuration and status on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_overview.png" alt="" class="no-border" width="400" >}} - -Check the **Bridge Status** on the **Overview** page to verify that it is ready and operating as expected. The following list describes the possible bridge statuses. - -### Bridge Statuses - -* **Halted** – The bridge has stopped because an internal component failed. Data is not being delivered. -* **Provisioning** – The bridge is being created or initialized and is not yet ready to deliver data. -* **Delivering** – The bridge is healthy, fully configured, and actively delivering data to the destination. -* **Misconfigured** – The bridge is running, but its data flow is not healthy or cannot be fully verified. Check the bridge configuration and data flow. -* **Reconfiguring** – The bridge is applying configuration changes. Data delivery may be temporarily interrupted until the new configuration is synchronized. -* **Awaiting Data** – The bridge is running and ready, but no source data is currently flowing. Data delivery will begin when data becomes available. - ## Managing Bridges After creating a bridge, you can modify and manage its configuration through the Event Broker Manager. diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md index 9a9b4c349b6..e928ecb8358 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md @@ -1,6 +1,6 @@ --- title: "Configure a Bridge with AWS S3" -url: /appstore/services/aws-s3-bridge/ +url: /appstore/services/event-broker-bridges/aws-s3-bridge/ linktitle: "AWS S3 Bridge" --- diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md index 9a0eaefc8ec..2400fe035b2 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md @@ -1,6 +1,6 @@ --- title: "Configure a Bridge with AWS SQS" -url: /appstore/services/aws-sqs-bridge/ +url: /appstore/services/event-broker-bridges/aws-sqs-bridge/ linktitle: "AWS SQS Bridge" --- diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md index 3ad2bdac810..c5c5c2cbb92 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md @@ -1,6 +1,6 @@ --- title: "Configure a Bridge with Azure Blob Storage" -url: /appstore/services/blob-bridge/ +url: /appstore/services/event-broker-bridges/blob-bridge/ linktitle: "Azure Blob Storage Bridge" --- diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index ce54bd09176..cee33e684f0 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -1,6 +1,6 @@ --- title: "Configure a Bridge with HTTP" -url: /appstore/services/http-bridge/ +url: /appstore/services/event-broker-bridges/http-bridge/ linktitle: "HTTP Bridge" --- diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md index 42a4caf873d..4e49be5741e 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md @@ -1,6 +1,6 @@ --- title: "Configure a Bridge with Apache Iceberg" -url: /appstore/services/iceberg-bridge/ +url: /appstore/services/event-broker-bridges/iceberg-bridge/ linktitle: "Apache Iceberg Bridge" --- From 503cd80b71ec1ce2b41e7a72fc9b2473e7b9b1c3 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 11:30:59 +0200 Subject: [PATCH 07/18] Change link location --- .../services/event-broker/_index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md index 0b418834d3f..52625b98417 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -96,9 +96,7 @@ From here, you can manage the default access settings: ## Mendix Event Broker Bridges -Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies. For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). - -Mendix Event Broker Bridges facilitate integration between the Event BRoker and the following technologies: +Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and the following external technologies: * [AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/) * [HTTP](/appstore/services/event-broker-bridges/http-bridge/) @@ -106,6 +104,8 @@ Mendix Event Broker Bridges facilitate integration between the Event BRoker and * [AWS S3](/appstore/services/aws-s3-bridge/) * [Iceberg](/appstore/services/event-broker-bridges/iceberg-bridge/) +For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). + ## Externally Defined Events {#externally-defined-events} Externally defined events refer to events that are defined outside the Mendix application, specifically outside Studio Pro. From d3255b7a76dbf3e789248651f09400cb1fbd93e4 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 14:32:31 +0200 Subject: [PATCH 08/18] Add editing to AWS S3 --- .../services/event-broker/_index.md | 28 ++++++------ .../event-broker-bridges/_index.md | 2 +- .../event-broker-bridges/aws-s3-bridge.md | 45 ++++++++++++++++++- .../event-broker-bridges/blob-bridge.md | 4 +- .../event-broker-bridges/http-bridge.md | 16 +++---- .../event-broker-bridges/iceberg-bridge.md | 4 +- 6 files changed, 72 insertions(+), 27 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md index 52625b98417..aeb7c62e27e 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -29,23 +29,25 @@ Once a license is purchased, a Technical Contact must enable the Event Broker Se The Event Broker must be enabled on both the app and specific environment levels in order to use the Event Broker services. -### Managing the Mendix Event Broker {#manage-mx-broker} +## Managing the Mendix Event Broker {#manage-mx-broker} Technical Contacts with a license for the Mendix Event Broker can manage its features on the [Event Broker Manager](https://broker.mendix.com/) page. -#### Users for Event Broker Manager +### Users for Event Broker Manager -Users within the company's email domain that have a Mendix login can participate in the administration of the Mendix Event Broker as either a View or Admin user. They can also be blocked from participation. +Users within the company's email domain that have a Mendix login can participate in the administration of the Mendix Event Broker as either a View or Admin user. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user.png" >}} +They can also be blocked from participation. + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user_2.png" width="300" >}} Users that are not part of the customer organization (not within the email domain of the customer) can be invited with the same levels of access. Such users still require a standard Mendix login. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_external_user.png" width="300" >}} -#### Spaces and Environments{#spaces} +### Spaces and Environments{#spaces} Spaces define which applications can exchange events with each other. When Business Events is enabled for an environment, it is placed in an Event Broker space based on the environment name. This enables apps deployed under the same space to publish and consume events. For example, apps in acceptance environment can only exchange events with other apps' acceptance environments. You can check the space of an app's environment on the [Event Broker Manager](https://broker.mendix.com/) page. @@ -53,24 +55,24 @@ Spaces are created and assigned based on the app environment name and allow isol See the [Enabling the Mendix Event Broker Service](#enable-mx-event-broker) section above for more information. -#### Topics and Channels {#topics-channels} +### Topics and Channels {#topics-channels} Events are placed in channels, sometimes called topics. Apps subscribed to a channel will receive events published to this channel. Events published by Free Apps are published to one shared company channel on a multitenant free Event Broker. Events published by apps running on licensed nodes are published to their own channels on the company Event Broker. These channels, implemented as topics on Kafka, are automatically created upon deployment of the app publishing the events. -#### Event Access Control {#access-control} +### Event Access Control {#access-control} The Mendix Event Broker allows access control to be applied down to the event level. Each application can be granted or denied access to events using the [Event Broker Manager](https://broker.mendix.com/). -##### Types of Access +#### Types of Access The overview page contains a list of applications by environment within the organization's event landscape. The table contains columns that provide cases with exceptions: * **Implemented but no access** – an application has implemented an event that it is not allowed to access, guaranteeing a failure to subscribe to and/or publish the event * **Has access but not implemented** – an application has been provided with more access than is required and you could make it more secure. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview.png" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview.png" >}} Selecting the specific application provides an overview of the application's implemented events with their associated access. @@ -80,7 +82,7 @@ From this view, access to the individual events can be configured. Changes take {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_3.png" width="300" >}} -##### Default Behavior +#### Default Behavior From the main overview page, an administrator can assign the default application behavior when they deploy to an environment for the first time by changing the configuration in the **Manage Default Access** dialog box. @@ -96,16 +98,16 @@ From here, you can manage the default access settings: ## Mendix Event Broker Bridges -Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and the following external technologies: +Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies. For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). + +Mendix Event BRoker Bridges supports integration with the following technologies: * [AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/) * [HTTP](/appstore/services/event-broker-bridges/http-bridge/) -* [Azure Blob Storage]((/appstore/services/event-broker-bridges/blob-bridge/) ) +* [Azure Blob Storage](/appstore/services/event-broker-bridges/blob-bridge/) * [AWS S3](/appstore/services/aws-s3-bridge/) * [Iceberg](/appstore/services/event-broker-bridges/iceberg-bridge/) -For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). - ## Externally Defined Events {#externally-defined-events} Externally defined events refer to events that are defined outside the Mendix application, specifically outside Studio Pro. diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md index 65f972948fb..a29eefcd575 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md @@ -51,7 +51,7 @@ Once the bridge has been successfully deployed, its configuration and status can ## Managing Bridges -After creating a bridge, you can modify and manage its configuration through the Event Broker Manager. +After creating a bridge, you can modify and manage its configuration through the [Event Broker Manager](https://broker.mendix.com/p/connected-apps). ### Editing Bridges diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md index e928ecb8358..56a8261c268 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md @@ -34,7 +34,7 @@ Once the bridge has been successfully deployed, its configuration and status can * **AWS Role (to Assume)** – the Amazon Resource Name (ARN) of the IAM role that the Event Broker Bridge will assume to access your S3 bucket; this role must be configured with appropriate permissions and a trust policy allowing the Event Broker to assume it * **AWS Role's External Id** – a unique identifier that provides additional security when the Event Broker assumes your AWS role; this shared secret ensures that only authorized Mendix Event Broker instances can assume the role - {{% alert color="info" %}}For detailed instructions on how to create the IAM role and obtain these values, see [Configure AWS Authentication for S3 Bridge](#configure-aws-s3-authentication).{{% /alert %}} + {{% alert color="info" %}}For detailed instructions on how to create the IAM role and obtain these values, see the [Configure AWS Authentication](#configure-aws-s3-authentication) section below.{{% /alert %}} {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_configure.png" >}} @@ -51,6 +51,49 @@ Select the business events to integrate with AWS S3: 3. Click **Next** to proceed to the confirmation screen. +## Editing Bridges + +You can edit an AWS S3 bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an AWS S3 bridge, you can: + +* Add or remove Business Events +* Update Bucket, AWS Region for Bucket, or Prefix Path + + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_aws_s3_edit_mode.png" class="no-border" >}} + +{{% alert color="info" %}}You can edit AWS S3 bridges only when the status is **Running**. {{% /alert %}} + +To edit a bridge: + +1. On the [Event Broker Manager](https://broker.mendix.com/) page, navigate to the **Event Broker Bridges** tab. +2. Click the bridge you want to modify. +3. Click **Edit** to enter editing mode. In editing mode, you can perform the following actions: + + * **Add Business Events**: + + 1. Click **Add Business Events** to open a dialog that displays available events. + 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. + + * **Remove Business Events**: + + 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. + 2. Re-add a removed event by clicking **Add** before applying changes. + + * **Update Service Configuration**: + + * Update the Bucket, AWS Region for Bucket, or Prefix Path as needed + +4. Once you have made your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. + * Click **Cancel** to exit editing mode without saving any changes. + +{{% alert color="info" %}} +The **Apply** button is only enabled when changes have been made to the bridge configuration. +{{% /alert %}} + +{{% alert color="warning" %}} +If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +{{% /alert %}} + ## Configure AWS Authentication {#configure-aws-s3-authentication} The Mendix Event Broker runs in AWS and uses cross-account authentication to securely access your S3 bucket. This authentication mechanism leverages AWS IAM roles with trust policies and external IDs to ensure secure, controlled access. diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md index c5c5c2cbb92..1a729135b38 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md @@ -23,7 +23,7 @@ Once the bridge has been successfully deployed, its configuration and status can {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" class="no-border" >}} -# Configure Service +## Configure Service 1. Configure the service by filling out the following: @@ -37,7 +37,7 @@ Once the bridge has been successfully deployed, its configuration and status can 2. Click **Next** to connect events to your bridge. -### Connect Events +## Connect Events Select the business events to integrate with Azure Blob Storage: diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index cee33e684f0..173ddb63270 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -22,6 +22,13 @@ You can include additional HTTP headers in your request to provide event metadat All custom HTTP headers will be forwarded as Kafka headers by default. +## Using the HTTP Bridge {#using-the-http-bridge} + +To run the HTTP bridge from your client, include a Bearer token in the request header. + +1. Open the HTTP bridge details using the **Options** ({{% icon name="three-dots-menu-horizontal" %}}) menu on the **Overview** page. +2. Add the **Bearer token**. + ## Creating a Bridge Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. @@ -58,11 +65,4 @@ Select the business events to integrate with the HTTP Bridge: {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_connect_events.png" width="400" >}} -3. Click **Next** to proceed to the confirmation screen. - -## Using the HTTP Bridge {#using-the-http-bridge} - -To run the HTTP bridge from your client, include a Bearer token in the request header. - -1. Open the HTTP bridge details using the **Options** ({{% icon name="three-dots-menu-horizontal" %}}) menu on the **Overview** page. -2. Add the **Bearer token**. \ No newline at end of file +3. Click **Next** to proceed to the confirmation screen. \ No newline at end of file diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md index 4e49be5741e..534fdbb94e3 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md @@ -15,7 +15,7 @@ Technical Contacts with a license to the Mendix Event Broker can manage this fea {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} 1. Click **Create a Bridge** to create a new bridge. -2. Select **Iceberge**. +2. Select **Iceberg**. 3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. 4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. @@ -39,7 +39,7 @@ Configure the service by filling out the following: * **AWS Region for Bucket** – the AWS region where the bucket is located * **AWS Role (to Assume)** – the AWS role to assume for the required permissions -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_configure.png" alt="" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_configure.png" alt="" width="400" >}} ## Connect Events From bca92e9736c16ab20758605c6161878868b8e648 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 15:14:42 +0200 Subject: [PATCH 09/18] Add Editing to Blob bridges --- .../event-broker-bridges/blob-bridge.md | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md index 1a729135b38..27bbdb7f1bc 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md @@ -47,3 +47,46 @@ Select the business events to integrate with Azure Blob Storage: {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_connect_events.png" >}} 3. Click **Next** to proceed to the confirmation screen. + +## Editing Bridges + +You can edit an Azure Blob Storage bridge bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an Azure Blob Storage bridge, you can: + +* Add or remove Business Events +* Update Storage Account, Storage SAS Token, Container Path, or Prefix Path + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_azure_blob_edit_mode.png" class="no-border" >}} + +{{% alert color="info" %}}You can edit Azure Blob Storage bridges only when the status is **Running**. {{% /alert %}} + +To edit a bridge: + +1. On the [Event Broker Manager](https://broker.mendix.com/) page, navigate to the **Event Broker Bridges** tab. +2. Click the bridge you want to modify. +3. Click **Edit** to enter editing mode. In editing mode, you can perform the following actions: + + * **Add Business Events**: + + 1. Click **Add Business Events** to open a dialog that displays available events. + 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. + + * **Remove Business Events**: + + 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. + 2. Re-add a removed event by clicking **Add** before applying changes. + + * **Update Service Configuration**: + + * Update the Storage Account, Storage SAS Token, Container Path, or Prefix Path as needed + +4. Once you have made your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. + * Click **Cancel** to exit editing mode without saving any changes. + +{{% alert color="info" %}} +The **Apply** button is only enabled when changes have been made to the bridge configuration. +{{% /alert %}} + +{{% alert color="warning" %}} +If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +{{% /alert %}} From e7dc1e80a65b042d8cce23969cf76b9c56083fb6 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 15:17:12 +0200 Subject: [PATCH 10/18] Add editing to HTTP --- .../event-broker-bridges/http-bridge.md | 38 ++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index 173ddb63270..2c54ee90908 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -65,4 +65,40 @@ Select the business events to integrate with the HTTP Bridge: {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_connect_events.png" width="400" >}} -3. Click **Next** to proceed to the confirmation screen. \ No newline at end of file +3. Click **Next** to proceed to the confirmation screen. + +## Editing Bridges + +You can edit an HTTP bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an HTTP bridge, you can add or remove Business Events. + +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_http_edit_mode.png" class="no-border" >}} + +{{% alert color="info" %}}You can edit HTTP bridges only when the status is **Running**. {{% /alert %}} + +To edit a bridge: + +1. On the [Event Broker Manager](https://broker.mendix.com/) page, navigate to the **Event Broker Bridges** tab. +2. Click the bridge you want to modify. +3. Click **Edit** to enter editing mode. In editing mode, you can perform the following actions: + + * **Add Business Events**: + + 1. Click **Add Business Events** to open a dialog that displays available events. + 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. + + * **Remove Business Events**: + + 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. + 2. Re-add a removed event by clicking **Add** before applying changes. + +4. Once you have made your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. + * Click **Cancel** to exit editing mode without saving any changes. + +{{% alert color="info" %}} +The **Apply** button is only enabled when changes have been made to the bridge configuration. +{{% /alert %}} + +{{% alert color="warning" %}} +If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +{{% /alert %}} \ No newline at end of file From 2ca2b72dc9a6ac3dbe30ea39cae45cffd64a691d Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 15:19:49 +0200 Subject: [PATCH 11/18] Add editing to Iceberg --- .../event-broker-bridges/iceberg-bridge.md | 52 ++++++++++++++++--- 1 file changed, 44 insertions(+), 8 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md index 534fdbb94e3..8a06ff1589a 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md @@ -41,6 +41,17 @@ Configure the service by filling out the following: {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_configure.png" alt="" width="400" >}} +### Bridge Statuses + +Check the **Bridge Status** on the **Overview** page to verify that it is ready and operating as expected. The following list describes the possible bridge statuses. + +* **Halted** – The bridge has stopped because an internal component failed. Data is not being delivered. +* **Provisioning** – The bridge is being created or initialized and is not yet ready to deliver data. +* **Delivering** – The bridge is healthy, fully configured, and actively delivering data to the destination. +* **Misconfigured** – The bridge is running, but its data flow is not healthy or cannot be fully verified. Check the bridge configuration and data flow. +* **Reconfiguring** – The bridge is applying configuration changes. Data delivery may be temporarily interrupted until the new configuration is synchronized. +* **Awaiting Data** – The bridge is running and ready, but no source data is currently flowing. Data delivery will begin when data becomes available. + ## Connect Events Select the CDC events that you want to deliver from the Event Broker to Iceberg: @@ -55,13 +66,38 @@ Select the CDC events that you want to deliver from the Event Broker to Iceberg: 3. Click **Next** to review and confirm the bridge configuration. -### Bridge Statuses +## Editing Bridges -Check the **Bridge Status** on the **Overview** page to verify that it is ready and operating as expected. The following list describes the possible bridge statuses. +You can edit an Apache Iceberg bridge bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an Iceberg bridge, you can add or remove CDC events. -* **Halted** – The bridge has stopped because an internal component failed. Data is not being delivered. -* **Provisioning** – The bridge is being created or initialized and is not yet ready to deliver data. -* **Delivering** – The bridge is healthy, fully configured, and actively delivering data to the destination. -* **Misconfigured** – The bridge is running, but its data flow is not healthy or cannot be fully verified. Check the bridge configuration and data flow. -* **Reconfiguring** – The bridge is applying configuration changes. Data delivery may be temporarily interrupted until the new configuration is synchronized. -* **Awaiting Data** – The bridge is running and ready, but no source data is currently flowing. Data delivery will begin when data becomes available. \ No newline at end of file +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_iceberg_edit_mode.png" class="no-border" >}} + +{{% alert color="info" %}}You can edit Iceberg bridges only when the status is **Delivering**. {{% /alert %}} + +To edit a bridge: + +1. On the [Event Broker Manager](https://broker.mendix.com/) page, navigate to the **Event Broker Bridges** tab. +2. Click the bridge you want to modify. +3. Click **Edit** to enter editing mode. In editing mode, you can perform the following actions: + + * **Add CDC Events** (Iceberg): + + 1. Click **Add CDC Events** to open a dialog box that displays available CDC events. + 2. Select the CDC events you want to add and click **Select**. Added events display an **Added** badge and can be removed before applying changes. + + * **Remove CDC Events** (Iceberg): + + 1. Navigate to the CDC event you want to remove and click **Remove**. Removed events display a **Removed** badge, and their name and metadata appear grayed out. + 2. To re-add a removed CDC event, click **Add** before applying changes. + +4. Once you have made your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. + * Click **Cancel** to exit editing mode without saving any changes. + +{{% alert color="info" %}} +The **Apply** button is only enabled when changes have been made to the bridge configuration. +{{% /alert %}} + +{{% alert color="warning" %}} +If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +{{% /alert %}} From 7adfc52670c42d89675ae9a5b75316129dec2990 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 3 Sep 2026 15:22:15 +0200 Subject: [PATCH 12/18] Remove editing from Bridges doc --- .../event-broker-bridges/_index.md | 74 +------------------ 1 file changed, 1 insertion(+), 73 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md index a29eefcd575..1127f26fcb5 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md @@ -51,76 +51,4 @@ Once the bridge has been successfully deployed, its configuration and status can ## Managing Bridges -After creating a bridge, you can modify and manage its configuration through the [Event Broker Manager](https://broker.mendix.com/p/connected-apps). - -### Editing Bridges - -You can edit HTTP, Azure Blob Storage, AWS S3, and Iceberg bridges to modify their configuration as your integration requirements evolve, without needing to recreate the bridge. - -{{% alert color="info" %}}You can edit HTTP, Azure Blob Storage, and AWS S3 bridges only when their status is **Running**. You can edit an Iceberg bridge only when its status is **Delivering**.{{% /alert %}} - -You can edit: - -* **HTTP Bridge** – add or remove business events -* **Azure Blob Storage Bridge** – add or remove business events, update Storage Account, Storage SAS Token, Container Path, or Prefix Path -* **AWS S3 Bridge** – add or remove business events, update Bucket, AWS Region for Bucket, or Prefix Path -* **Iceberg Bridge** – add or remove CDC events - -To edit a bridge: - -1. On the [Event Broker Manager](https://broker.mendix.com/) page, navigate to the **Event Broker Bridges** tab. -2. Click the bridge you want to modify. -3. Click **Edit** to enter editing mode. - - In editing mode, you can perform the following actions: - - * **Add Business Events** (HTTP, Azure Blob Storage, and AWS S3): - - 1. Click **Add Business Events** to open a dialog that displays available events. - 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. - - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_http_edit_mode.png" class="no-border" >}} - - * **Remove Business Events** (HTTP, Azure Blob Storage, and AWS S3): - - 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. - 2. Re-add a removed event by clicking **Add** before applying changes. - - * **Add CDC Events** (Iceberg): - - 1. Click **Add CDC Events** to open a dialog box that displays available CDC events. - 2. Select the CDC events you want to add and click **Select**. Added events display an **Added** badge and can be removed before applying changes. - - * **Remove CDC Events** (Iceberg): - - 1. Navigate to the CDC event you want to remove and click **Remove**. Removed events display a **Removed** badge, and their name and metadata appear grayed out. - 2. To re-add a removed CDC event, click **Add** before applying changes. - - * **Update Service Configuration** (Azure Blob Storage and AWS S3 only): - - * **Azure Blob Storage** – update the Storage Account, Storage SAS Token, Container Path, or Prefix Path as needed - * **AWS S3** – update the Bucket, AWS Region for Bucket, or Prefix Path as needed - - **HTTP** - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_http_edit_mode.png" class="no-border" >}} - - **Azure Blob Storage** - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_azure_blob_edit_mode.png" class="no-border" >}} - - **AWS S3** - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_aws_s3_edit_mode.png" class="no-border" >}} - - **Iceberg** - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_iceberg_edit_mode.png" class="no-border" >}} - -4. Once you have made your changes, you can: - * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** for HTTP, Azure Blob Storage, and AWS S3 bridges, or **Delivering** for Iceberg bridges, once the reconfiguration is complete. - * Click **Cancel** to exit editing mode without saving any changes. - -{{% alert color="info" %}} -The **Apply** button is only enabled when changes have been made to the bridge configuration. -{{% /alert %}} - -{{% alert color="warning" %}} -If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. -{{% /alert %}} +After creating a bridge, you can modify and manage its configuration through the [Event Broker Manager](https://broker.mendix.com/p/connected-apps). \ No newline at end of file From fced8cd7f251a3198c7c534018e8ac81c328cba0 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Fri, 4 Sep 2026 10:40:55 +0200 Subject: [PATCH 13/18] Proof main doc --- .../services/event-broker/_index.md | 58 +++++++++---------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md index aeb7c62e27e..49bfc9eb2d2 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -2,7 +2,7 @@ title: "Mendix Event Broker" url: /appstore/services/event-broker/ linktitle: "Event Broker" -description: "Mendix Event Broker" +description: "Describes the Mendix Event Broker service, including licensing, configuration, access control, and externally defined events." aliases: --- @@ -33,21 +33,21 @@ The Event Broker must be enabled on both the app and specific environment levels Technical Contacts with a license for the Mendix Event Broker can manage its features on the [Event Broker Manager](https://broker.mendix.com/) page. -### Users for Event Broker Manager +### Users for Event Broker Manager Users within the company's email domain that have a Mendix login can participate in the administration of the Mendix Event Broker as either a View or Admin user. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user.png" alt="" >}} They can also be blocked from participation. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user_2.png" width="300" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_internal_user_2.png" alt="" width="300" >}} Users that are not part of the customer organization (not within the email domain of the customer) can be invited with the same levels of access. Such users still require a standard Mendix login. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_external_user.png" width="300" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_external_user.png" alt="" width="300" >}} -### Spaces and Environments{#spaces} +### Spaces and Environments {#spaces} Spaces define which applications can exchange events with each other. When Business Events is enabled for an environment, it is placed in an Event Broker space based on the environment name. This enables apps deployed under the same space to publish and consume events. For example, apps in acceptance environment can only exchange events with other apps' acceptance environments. You can check the space of an app's environment on the [Event Broker Manager](https://broker.mendix.com/) page. @@ -70,23 +70,23 @@ The Mendix Event Broker allows access control to be applied down to the event le The overview page contains a list of applications by environment within the organization's event landscape. The table contains columns that provide cases with exceptions: * **Implemented but no access** – an application has implemented an event that it is not allowed to access, guaranteeing a failure to subscribe to and/or publish the event -* **Has access but not implemented** – an application has been provided with more access than is required and you could make it more secure. +* **Has access but not implemented** – an application has been provided with more access than is required and you can make it more secure. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview.png" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview.png" alt="" >}} Selecting the specific application provides an overview of the application's implemented events with their associated access. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_2.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_2.png" alt="" >}} From this view, access to the individual events can be configured. Changes take effect immediately when **Apply Changes** is clicked. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_3.png" width="300" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_overview_3.png" alt="" width="300" >}} #### Default Behavior From the main overview page, an administrator can assign the default application behavior when they deploy to an environment for the first time by changing the configuration in the **Manage Default Access** dialog box. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_defaults.png" width="300" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_access_control_defaults.png" alt="" width="300" >}} From here, you can manage the default access settings: @@ -100,7 +100,7 @@ From here, you can manage the default access settings: Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies. For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). -Mendix Event BRoker Bridges supports integration with the following technologies: +Mendix Event Broker Bridges support integration with the following technologies: * [AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/) * [HTTP](/appstore/services/event-broker-bridges/http-bridge/) @@ -112,7 +112,7 @@ Mendix Event BRoker Bridges supports integration with the following technologies Externally defined events refer to events that are defined outside the Mendix application, specifically outside Studio Pro. -The Mendix Event Broker allows users to upload an AsyncAPI document for these external events. Once uploaded, users can download a new AsyncAPI document compatible with [Mendix Business Events](/appstore/services/business-events/), which can then be imported into Studio Pro to share the events across Mendix applications or use them in a new [Bridge](#manage-mx-broker-bridge). +The Mendix Event Broker lets you upload an AsyncAPI document for these external events. Once uploaded, you can download a new AsyncAPI document compatible with [Mendix Business Events](/appstore/services/business-events/), which can then be imported into Studio Pro to share the events across Mendix applications or use them in a new [Bridge](#manage-mx-broker-bridge). ### Upload Events @@ -120,29 +120,29 @@ Technical Contacts with a license to the Mendix Event Broker can manage this fea To begin, click **Get Started** or **Upload AsyncAPI Document**. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_get_started.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_get_started.png" alt="" >}} #### Upload an AsyncAPI File Upload an AsyncAPI contract based on the [AsyncAPI format](#asyncapi-format). If there are any errors with the content or file format, an error box will display a list of the issues found. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_1.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_1.png" alt="" >}} #### Verify File Information The details of the uploaded file are extracted in the **Verify** section. This allows you to confirm that all information is accurate and meets the required expectations. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_2.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_2.png" alt="" >}} #### Choose Spaces Select the spaces where the events will be used. When at least one space is selected, the **Create Service** button will be enabled. Click **Create Service** to create the service. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_3.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_create_3.png" alt="" >}} #### Successful Page -You will get a confirmation that the externally defined events have been successfully uploaded and are now ready to be used in Bridges or applications. +A confirmation appears when the externally defined events are uploaded and ready to use in Bridges or applications. Click **Close** to continue. @@ -152,35 +152,35 @@ For more information on how to use an event, see [Usages](#event-usages). After a service is uploaded, it can be viewed on the Overview page. This page presents a list of uploaded events, along with their corresponding services and the spaces selected for the AsyncAPI. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_overview.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_overview.png" alt="" >}} ### Events and Services Details -From the Overview page, users can access the Event and Service details by clicking on the event or service name in the table. Each page includes a drop-down selection for a space, which allows you to manage services and events specific to that space. +From the Overview page, you can access the Event and Service details by clicking the event or service name in the table. Each page includes a drop-down selection for a space, which allows you to manage services and events specific to that space. #### Event Details This page provides information about the uploaded event, including the event name, PUB/SUB details, attributes, and [usages](#event-usages). -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_page.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_page.png" alt="" >}} #### Service Details {#service-details} The services details page includes information about the uploaded services, including the service name, description, and associated events. You can also delete a service within the selected space (subject to [deletion conditions](#delete-service)) and download the AsyncAPI contract to import into an existing Mendix application (for more information, see [Application Usages](#usages-app)). -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_service_page.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_service_page.png" alt="" >}} ### Event Usages {#event-usages} Once an AsyncAPI contract is successfully uploaded, it can be used through Bridges or applications. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_usages.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_event_usages.png" alt="" >}} #### Bridges To use an uploaded event in a Bridge, you must configure a [Bridge with AWS SQS](/appstore/services/event-broker-bridges/#bridge-with-aws-sqs). During the step **Choose business events to connect**, the newly uploaded events in the selected space from the previous step will be visible. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_add_bridge.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_add_bridge.png" alt="" >}} #### Applications {#usages-app} @@ -188,11 +188,11 @@ To use an uploaded event in an application, download the AsyncAPI contract for S Use the **Use an existing business event service** option to import the file as a new business event. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_import_file.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_import_file.png" alt="" >}} Click **OK**. This creates the new business event that is ready to be used with the same features as any other imported event. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_imported_file.png" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_imported_file.png" alt="" >}} ### Delete Service {#delete-service} @@ -206,7 +206,7 @@ Deleting a service only removes it from the selected space. The service will rem ### AsyncAPI Format {#asyncapi-format} -Externally defined events are provided to the Event Broker via an AsyncAPI document, which must include the service information and event definitions. Any other content within the AsyncAPI document, if provided, will be ignored. +Externally defined events are provided to the Event Broker via an AsyncAPI document, which must include the service information and event definitions. Any other content within the AsyncAPI document, if provided, is ignored. The mandatory information required in the file includes: @@ -216,13 +216,13 @@ The mandatory information required in the file includes: {{% alert color="info" %}} -Message names must be unique. Duplicate events cannot be uploaded if it is deployed anywhere in the Mendix space or uploaded before. +Message names must be unique. Duplicate events cannot be uploaded if they are deployed anywhere in the Mendix space or have been uploaded before. {{% /alert %}} The supported version of AsyncAPI is 2.0.0, in accordance with [AsyncAPI documentation](https://v2.asyncapi.com/docs/reference/specification/v2.2.0). -The file requirements are listed below: +The file requirements are: * Size: maximum file size is 1MB. * Supported files: *.yml*, *.yaml*, *.json* From b8cfbea1c7581ca8734a9e62a9f1d33ec8c24727 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Fri, 4 Sep 2026 10:44:18 +0200 Subject: [PATCH 14/18] Proof Bridges index --- .../event-broker/event-broker-bridges/_index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md index 1127f26fcb5..1860054de86 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/_index.md @@ -10,16 +10,16 @@ aliases: ## Introduction {{% alert color="info" %}} -Mendix Event Broker Bridges was released for GA in 11.4.0. +Mendix Event Broker Bridges were released for GA in 11.4.0. {{% /alert %}} -Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies, such as AWS SQS, HTTP, Azure Blob Storage, AWS S3, and Apache Iceberg. These bridges enable the exchange of events between your Mendix Cloud environment and external systems, ensuring efficient communication across diverse technological landscapes. +Mendix Event Broker Bridges integrate the Mendix Event Broker with external technologies, such as AWS SQS, HTTP, Azure Blob Storage, AWS S3, and Apache Iceberg. These bridges enable the exchange of events between your Mendix Cloud environment and external systems. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_bridges.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_bridges.png" alt="" class="no-border" >}} ## Standard Message Format -Every event must carry four mandatory CloudEvents core attributes, each prefixed with `ce_`: +Every event must include four CloudEvents core attributes, each prefixed with `ce_`: * `ce_id` as id * `ce_source` as source @@ -32,7 +32,7 @@ See [CloudEvents](https://github.com/cloudevents/spec/blob/v1.0.1/spec.md#requir Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} 1. Click **Create a Bridge** to create a new bridge. @@ -40,14 +40,14 @@ Technical Contacts with a license to the Mendix Event Broker can manage this fea * [AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/) * [HTTP](/appstore/services/event-broker-bridges/http-bridge/) - * [Azure Blob Storage]((/appstore/services/event-broker-bridges/blob-bridge/) ) + * [Azure Blob Storage](/appstore/services/event-broker-bridges/blob-bridge/) * [AWS S3](/appstore/services/aws-s3-bridge/) * [Iceberg](/appstore/services/event-broker-bridges/iceberg-bridge/) 3. Click **Next** to continue creating your bridge. 4. After configuring the service and connecting events (as described in the bridge-specific sections above), click **Start** on the confirmation screen to deploy the bridge. -Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. +After the bridge deploys, you can view its configuration and status on the **Overview** page. ## Managing Bridges From dddc46582ad2f4572235ffba90918662398f41a0 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Fri, 4 Sep 2026 11:42:58 +0200 Subject: [PATCH 15/18] Proof new Bridges docs --- .../event-broker-bridges/aws-s3-bridge.md | 43 ++++++++++--------- .../event-broker-bridges/aws-sqs-bridge.md | 31 ++++++------- .../event-broker-bridges/blob-bridge.md | 35 +++++++-------- .../event-broker-bridges/http-bridge.md | 37 ++++++++-------- 4 files changed, 75 insertions(+), 71 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md index 56a8261c268..05ffe1f0bd9 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md @@ -2,6 +2,7 @@ title: "Configure a Bridge with AWS S3" url: /appstore/services/event-broker-bridges/aws-s3-bridge/ linktitle: "AWS S3 Bridge" +description: "How to configure and manage an AWS S3 bridge using the Mendix Event Broker." --- ## Introduction @@ -12,16 +13,16 @@ An AWS S3 Bridge is a one-way bridge that receives events via AWS object storage Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} 1. Click **Create a Bridge** to create a new bridge. 2. Select **AWS S3**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-service) below. 4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. -Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. +After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_overview.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_overview.png" alt="" class="no-border" >}} ## Configure Service @@ -34,31 +35,31 @@ Once the bridge has been successfully deployed, its configuration and status can * **AWS Role (to Assume)** – the Amazon Resource Name (ARN) of the IAM role that the Event Broker Bridge will assume to access your S3 bucket; this role must be configured with appropriate permissions and a trust policy allowing the Event Broker to assume it * **AWS Role's External Id** – a unique identifier that provides additional security when the Event Broker assumes your AWS role; this shared secret ensures that only authorized Mendix Event Broker instances can assume the role - {{% alert color="info" %}}For detailed instructions on how to create the IAM role and obtain these values, see the [Configure AWS Authentication](#configure-aws-s3-authentication) section below.{{% /alert %}} + {{% alert color="info" %}}For instructions on creating the IAM role and obtaining these values, see the [Configure AWS Authentication](#configure-aws-s3-authentication) section below.{{% /alert %}} - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_configure.png" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_configure.png" alt="" >}} 2. Click **Next** to connect events to your bridge. ## Connect Events -Select the business events to integrate with AWS S3: +To connect business events to AWS S3, follow these steps: -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of publishing are shown, as this bridge operates in one direction. -2. Select the event(s) to integrate and specify the prefix path for event storage. +1. Click **Add Business Events** to open a dialog box that displays all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events that can publish appear, as this bridge operates in one direction. +2. Select the events to integrate and specify the prefix path for event storage. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_connect_events.png" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_connect_events.png" alt="" >}} 3. Click **Next** to proceed to the confirmation screen. ## Editing Bridges -You can edit an AWS S3 bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an AWS S3 bridge, you can: +You can edit an AWS S3 bridge to modify the configuration as your integration requirements evolve, without recreating it. For an AWS S3 bridge, you can: * Add or remove Business Events * Update Bucket, AWS Region for Bucket, or Prefix Path - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_aws_s3_edit_mode.png" class="no-border" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_aws_s3_edit_mode.png" alt="" class="no-border" >}} {{% alert color="info" %}}You can edit AWS S3 bridges only when the status is **Running**. {{% /alert %}} @@ -71,19 +72,19 @@ To edit a bridge: * **Add Business Events**: 1. Click **Add Business Events** to open a dialog that displays available events. - 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. + 2. Select the events you want to add and click **Select**. Added events display an **Added** badge and can be removed before applying changes. * **Remove Business Events**: - 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. + 1. Navigate to the event you want to remove and click **Remove**. Removed events display a **Removed** badge, and their name and metadata appear grayed out. 2. Re-add a removed event by clicking **Add** before applying changes. * **Update Service Configuration**: * Update the Bucket, AWS Region for Bucket, or Prefix Path as needed -4. Once you have made your changes, you can: - * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. +4. After you make your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message indicates whether the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status changes to **Reconfiguring** and returns to **Running** when reconfiguration is complete. * Click **Cancel** to exit editing mode without saving any changes. {{% alert color="info" %}} @@ -91,12 +92,12 @@ The **Apply** button is only enabled when changes have been made to the bridge c {{% /alert %}} {{% alert color="warning" %}} -If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +If an error occurs during editing, the bridge automatically rolls back to its previous running state to ensure continuity of service. {{% /alert %}} ## Configure AWS Authentication {#configure-aws-s3-authentication} -The Mendix Event Broker runs in AWS and uses cross-account authentication to securely access your S3 bucket. This authentication mechanism leverages AWS IAM roles with trust policies and external IDs to ensure secure, controlled access. +The Mendix Event Broker runs in AWS and uses cross-account authentication to securely access your S3 bucket. This authentication mechanism uses AWS IAM roles with trust policies and external IDs to ensure secure, controlled access. ### Prerequisites @@ -113,14 +114,14 @@ The trust policy defines which AWS accounts can assume the role. 3. Select **AWS account** as the trusted entity type. 4. Choose **Another AWS account**. 5. Enter the Mendix Event Broker AWS account ID: `044806572671` -6. Select **Require external ID** and enter a unique external ID of your choice. This external ID will be required when configuring the bridge in the Event Broker Manager. +6. Select **Require external ID** and enter a unique external ID of your choice. You need this external ID when configuring the bridge in Event Broker Manager. 7. Click **Next**. {{% alert color="info" %}} The external ID acts as a shared secret between Mendix and your AWS account. This prevents the confused deputy problem and ensures that only authorized Event Broker instances can assume your role. {{% /alert %}} - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_create_a_cross_account_role_in_aws.png" class="no-border" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_create_a_cross_account_role_in_aws.png" alt="" class="no-border" width="400" >}} ### Attach Permissions Policy to the Role @@ -166,7 +167,7 @@ The policy above grants the minimum required permissions for the Event Broker to 1. Provide a name for your role (for example, `EventBrokerS3AccessRole`). 2. Review the role configuration and click **Create role**. -3. Once created, open the role and copy the **Role ARN** (it will look like this: `arn:aws:iam::YOUR_ACCOUNT_ID:role/EventBrokerS3AccessRole`). +3. After creating the role, open it and copy the **Role ARN** (for example, `arn:aws:iam::YOUR_ACCOUNT_ID:role/EventBrokerS3AccessRole`). ### Configure the Bridge diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md index 2400fe035b2..41201e5579a 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md @@ -2,26 +2,27 @@ title: "Configure a Bridge with AWS SQS" url: /appstore/services/event-broker-bridges/aws-sqs-bridge/ linktitle: "AWS SQS Bridge" +description: "How to configure and manage an AWS SQS bridge using the Mendix Event Broker." --- ## Introduction -An AWS SQS Bridge is a bidirectional bridge using the [Amazon Simple Queue Service](https://aws.amazon.com/sqs/) to send and receive events. The creation process for AWS SQS bridges includes two additional steps on the Mendix side and policies that need to be implemented on the AWS side. +An AWS SQS Bridge is a bidirectional bridge using the [Amazon Simple Queue Service](https://aws.amazon.com/sqs/) to send and receive events. The creation process for AWS SQS bridges includes two additional steps on the Mendix side and policies you must configure on the AWS side. ## Creating a Bridge Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} 1. Click **Create a Bridge** to create a new bridge. 2. Select **AWS SQS**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-service) below. 4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. -Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. +After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_overview.png" class="no-border" width="400" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_overview.png" alt="" class="no-border" width="400" >}} ## Configure Service @@ -29,29 +30,29 @@ Once the bridge has been successfully deployed, its configuration and status can * **Event Broker Space** – the space where the bridge will operate * **Name** – the name you want to call the bridge * **AWS region** – the AWS region where your bridge operates - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_configure.png" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_configure.png" alt="" width="400" >}} 2. Click **Next** to continue the configuration. ## Connect Events -Select the business events to integrate with AWS SQS: +To connect business events to AWS SQS, follow these steps: -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. -2. Select the checkbox for the event(s) you want to add, then click **Select**. +1. Click **Add Business Events** to open a dialog box that displays all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. +2. Select the checkbox for the events you want to add, then click **Select**. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_choose_events.png" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_choose_events.png" alt="" width="400" >}} -3. Configure each event with its own SQS URL for each direction the event will be integrated. +3. Configure each event with its own SQS URL for each direction the event is integrated. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_connect_events.png" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_connect_events.png" alt="" width="400" >}} 4. Click **Next** to continue. 5. Confirm the configuration with the AWS Access Policy. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_approve_policy.png" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_approve_policy.png" alt="" width="400" >}} -6. After all events have been configured, click **Start** to start the Mendix Event Broker Bridge. This process will take several minutes to complete. +6. After all events have been configured, click **Start** to start the Mendix Event Broker Bridge. This process takes several minutes to complete. ## Configure AWS Access Policy @@ -79,7 +80,7 @@ Add the object below to the Access Policy of your AWS SQS queue if it is sending ### Receiving Messages from Mendix -Add the object below to your Access Policy of the AWS SQS queue if it is receiving messages from Mendix. +Add the object below to the Access Policy of your AWS SQS queue if it is receiving messages from Mendix. ``` { diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md index 27bbdb7f1bc..4c672c83355 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md @@ -2,6 +2,7 @@ title: "Configure a Bridge with Azure Blob Storage" url: /appstore/services/event-broker-bridges/blob-bridge/ linktitle: "Azure Blob Storage Bridge" +description: "How to configure and manage an Azure Blob Storage bridge using the Mendix Event Broker." --- ## Introduction @@ -12,16 +13,16 @@ An Azure Blob Bridge is a one-way bridge that receives events via Azure object s Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} 1. Click **Create a Bridge** to create a new bridge. 2. Select **Azure Blob Storage**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. +3. Create and configure your bridge by following the steps in [Configure Service](#configure-service) below. 4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. -Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. +After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" alt="" class="no-border" >}} ## Configure Service @@ -33,29 +34,29 @@ Once the bridge has been successfully deployed, its configuration and status can * **Storage SAS Token** – the storage SAS Token * **Container Path** – the path of the container where the messages will be stored - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_configure.png" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_configure.png" alt="" >}} 2. Click **Next** to connect events to your bridge. ## Connect Events -Select the business events to integrate with Azure Blob Storage: +To connect business events to Azure Blob Storage, follow these steps: -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of publishing are shown, as this bridge operates in one direction. -2. Select the event(s) to integrate and specify the prefix path for event storage. +1. Click **Add Business Events** to open a dialog box that displays all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events that can publish appear, as this bridge operates in one direction. +2. Select the events to integrate and specify the prefix path for event storage. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_connect_events.png" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_connect_events.png" alt="" >}} 3. Click **Next** to proceed to the confirmation screen. ## Editing Bridges -You can edit an Azure Blob Storage bridge bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an Azure Blob Storage bridge, you can: +You can edit an Azure Blob Storage bridge to modify the configuration as your integration requirements evolve, without recreating it. For an Azure Blob Storage bridge, you can: * Add or remove Business Events * Update Storage Account, Storage SAS Token, Container Path, or Prefix Path -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_azure_blob_edit_mode.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_azure_blob_edit_mode.png" alt="" class="no-border" >}} {{% alert color="info" %}}You can edit Azure Blob Storage bridges only when the status is **Running**. {{% /alert %}} @@ -67,20 +68,20 @@ To edit a bridge: * **Add Business Events**: - 1. Click **Add Business Events** to open a dialog that displays available events. - 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. + 1. Click **Add Business Events** to open a dialog box that displays available events. + 2. Select the events you want to add and click **Select**. Added events display an **Added** badge and can be removed before applying changes. * **Remove Business Events**: - 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. + 1. Navigate to the event you want to remove and click **Remove**. Removed events display a **Removed** badge, and their name and metadata appear grayed out. 2. Re-add a removed event by clicking **Add** before applying changes. * **Update Service Configuration**: * Update the Storage Account, Storage SAS Token, Container Path, or Prefix Path as needed -4. Once you have made your changes, you can: - * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. +4. After you make your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message indicates whether the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status changes to **Reconfiguring** and returns to **Running** when reconfiguration is complete. * Click **Cancel** to exit editing mode without saving any changes. {{% alert color="info" %}} @@ -88,5 +89,5 @@ The **Apply** button is only enabled when changes have been made to the bridge c {{% /alert %}} {{% alert color="warning" %}} -If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +If an error occurs during editing, the bridge automatically rolls back to its previous running state to ensure continuity of service. {{% /alert %}} diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index 2c54ee90908..1fb9d553334 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -2,6 +2,7 @@ title: "Configure a Bridge with HTTP" url: /appstore/services/event-broker-bridges/http-bridge/ linktitle: "HTTP Bridge" +description: "How to configure and manage an HTTP bridge using the Mendix Event Broker." --- ## Introduction @@ -10,7 +11,7 @@ An HTTP bridge is a one-way bridge that uses HTTP requests to send events from e ## HTTP Bridge Headers -HTTP Bridges require specific headers for authentication. **Authorization** must be set as a Bearer token using the Personal Access Token (PAT) generated during bridge configuration; for example: `Authorization: Bearer ` +HTTP bridges require specific headers for authentication. **Authorization** must be set as a Bearer token using the Personal Access Token (PAT) generated during bridge configuration; for example: `Authorization: Bearer ` For details on how to obtain your Bearer token, see the [Using the HTTP Bridge](#using-the-http-bridge) section below. @@ -20,7 +21,7 @@ You can include additional HTTP headers in your request to provide event metadat * `ce_time` – sets the published time of the event; for example: `2025-06-13T15:36:52.148542+02:00` -All custom HTTP headers will be forwarded as Kafka headers by default. +All custom HTTP headers are forwarded as Kafka headers by default. ## Using the HTTP Bridge {#using-the-http-bridge} @@ -33,16 +34,16 @@ To run the HTTP bridge from your client, include a Bearer token in the request h Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} 1. Click **Create a Bridge** to create a new bridge. 2. Select **HTTP**. 3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. 4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. -Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. +After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_overview.png" class="no-border" width="400" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_overview.png" alt="" class="no-border" width="400" >}} ## Configure Service {#configure-http-bridge} @@ -52,26 +53,26 @@ Once the bridge has been successfully deployed, its configuration and status can * **Name** – the name you want to call the bridge * **AWS region** – the AWS region where your bridge operates - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_configure.png" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_configure.png" alt="" width="400" >}} 2. Click **Next** to connect events to your bridge. ## Connect Events -Select the business events to integrate with the HTTP Bridge: +To connect business events to the HTTP bridge, follow these steps: -1. Click **Add Business Events** to open a dialog displaying all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events capable of subscribing are shown, as this bridge operates in one direction. -2. Select the event(s) to integrate. Once selected, the URL for the HTTP connection is automatically generated. +1. Click **Add Business Events** to open a dialog box that displays all events managed by the Event Broker, including Mendix app-defined events and uploaded AsyncAPI events. Only events that can subscribe appear, as this bridge operates in one direction. +2. Select the events to integrate. After selecting events, the bridge automatically generates the URL for the HTTP connection. - {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_connect_events.png" width="400" >}} + {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_connect_events.png" alt="" width="400" >}} 3. Click **Next** to proceed to the confirmation screen. ## Editing Bridges -You can edit an HTTP bridge to modify the configuration as your integration requirements evolve, without needing to recreate it. For an HTTP bridge, you can add or remove Business Events. +You can edit an HTTP bridge to modify the configuration as your integration requirements evolve, without recreating it. For an HTTP bridge, you can add or remove Business Events. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_http_edit_mode.png" class="no-border" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/edit-bridge/ebb_http_edit_mode.png" alt="" class="no-border" >}} {{% alert color="info" %}}You can edit HTTP bridges only when the status is **Running**. {{% /alert %}} @@ -83,16 +84,16 @@ To edit a bridge: * **Add Business Events**: - 1. Click **Add Business Events** to open a dialog that displays available events. - 2. Select the events you want to add and click **Select**. Added events will display an **Added** badge and can be removed before applying changes. + 1. Click **Add Business Events** to open a dialog box that displays available events. + 2. Select the events you want to add and click **Select**. Added events display an **Added** badge and can be removed before applying changes. * **Remove Business Events**: - 1. Navigate to the event you want to remove and click **Remove**. Removed events will display a **Removed** badge, and their name and metadata will appear grayed out. + 1. Navigate to the event you want to remove and click **Remove**. Removed events display a **Removed** badge, and their name and metadata appear grayed out. 2. Re-add a removed event by clicking **Add** before applying changes. -4. Once you have made your changes, you can: - * Click **Apply** to save and apply the changes. A confirmation message will indicate if the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status will change to **Reconfiguring** and will return to **Running** once the reconfiguration is complete. +4. After you make your changes, you can: + * Click **Apply** to save and apply the changes. A confirmation message indicates whether the changes were successful. Changes to the event configuration take effect when applied. After applying changes, the bridge status changes to **Reconfiguring** and returns to **Running** when reconfiguration is complete. * Click **Cancel** to exit editing mode without saving any changes. {{% alert color="info" %}} @@ -100,5 +101,5 @@ The **Apply** button is only enabled when changes have been made to the bridge c {{% /alert %}} {{% alert color="warning" %}} -If an error occurs during the editing process, the bridge will automatically roll back to its previous running state to ensure continuity of service. +If an error occurs during editing, the bridge automatically rolls back to its previous running state to ensure continuity of service. {{% /alert %}} \ No newline at end of file From 358aa895c522c3a46fe6161366641ced78c8bb95 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Fri, 4 Sep 2026 11:50:11 +0200 Subject: [PATCH 16/18] Fix links --- .../services/event-broker/_index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md index 49bfc9eb2d2..d5ab6222960 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -112,7 +112,7 @@ Mendix Event Broker Bridges support integration with the following technologies: Externally defined events refer to events that are defined outside the Mendix application, specifically outside Studio Pro. -The Mendix Event Broker lets you upload an AsyncAPI document for these external events. Once uploaded, you can download a new AsyncAPI document compatible with [Mendix Business Events](/appstore/services/business-events/), which can then be imported into Studio Pro to share the events across Mendix applications or use them in a new [Bridge](#manage-mx-broker-bridge). +The Mendix Event Broker lets you upload an AsyncAPI document for these external events. Once uploaded, you can download a new AsyncAPI document compatible with [Mendix Business Events](/appstore/services/business-events/), which can then be imported into Studio Pro to share the events across Mendix applications or use them in a new [bridge](/appstore/services/event-broker-bridges/). ### Upload Events @@ -178,7 +178,7 @@ Once an AsyncAPI contract is successfully uploaded, it can be used through Bridg #### Bridges -To use an uploaded event in a Bridge, you must configure a [Bridge with AWS SQS](/appstore/services/event-broker-bridges/#bridge-with-aws-sqs). During the step **Choose business events to connect**, the newly uploaded events in the selected space from the previous step will be visible. +To use an uploaded event in a bridge, you must [configure a bridge with AWS SQS](/appstore/services/event-broker-bridges/aws-sqs-bridge/). During the step **Choose business events to connect**, the newly uploaded events in the selected space from the previous step will be visible. {{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_add_bridge.png" alt="" >}} @@ -192,7 +192,7 @@ Use the **Use an existing business event service** option to import the file as Click **OK**. This creates the new business event that is ready to be used with the same features as any other imported event. -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_imported_file.png" alt="" >}} +{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/event_broker_ede_imported_file.png" >}} ### Delete Service {#delete-service} From bab8033dfaf7e6135423e8772db409c2ca942d1d Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Fri, 4 Sep 2026 11:53:25 +0200 Subject: [PATCH 17/18] Link title --- .../platform-supported-content/services/event-broker/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md index d5ab6222960..46f591a3e00 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/_index.md @@ -98,7 +98,7 @@ From here, you can manage the default access settings: ## Mendix Event Broker Bridges -Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies. For information on creating and managing bridges, see [Event Broker Bridges](/appstore/services/event-broker-bridges/). +Mendix Event Broker Bridges facilitate integration between the Mendix Event Broker and external technologies. For information on creating and managing bridges, see [Mendix Event Broker Bridges](/appstore/services/event-broker-bridges/). Mendix Event Broker Bridges support integration with the following technologies: From cae24f67668a52b17f599fe94412e19c78e8287a Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Tue, 8 Sep 2026 13:57:17 +0200 Subject: [PATCH 18/18] Remove Configure sections from Bridge docs --- .../event-broker-bridges/aws-s3-bridge.md | 15 --------------- .../event-broker-bridges/aws-sqs-bridge.md | 15 --------------- .../event-broker-bridges/blob-bridge.md | 15 --------------- .../event-broker-bridges/http-bridge.md | 15 --------------- .../event-broker-bridges/iceberg-bridge.md | 15 --------------- 5 files changed, 75 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md index 05ffe1f0bd9..cc82c1dcfb9 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-s3-bridge.md @@ -9,21 +9,6 @@ description: "How to configure and manage an AWS S3 bridge using the Mendix Even An AWS S3 Bridge is a one-way bridge that receives events via AWS object storage. -## Creating a Bridge - -Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} - -1. Click **Create a Bridge** to create a new bridge. -2. Select **AWS S3**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-service) below. -4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. - -After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-s3/ebb_aws_s3_overview.png" alt="" class="no-border" >}} - ## Configure Service 1. Configure the service by filling out the following: diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md index 41201e5579a..4e2618a002a 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/aws-sqs-bridge.md @@ -9,21 +9,6 @@ description: "How to configure and manage an AWS SQS bridge using the Mendix Eve An AWS SQS Bridge is a bidirectional bridge using the [Amazon Simple Queue Service](https://aws.amazon.com/sqs/) to send and receive events. The creation process for AWS SQS bridges includes two additional steps on the Mendix side and policies you must configure on the AWS side. -## Creating a Bridge - -Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} - -1. Click **Create a Bridge** to create a new bridge. -2. Select **AWS SQS**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-service) below. -4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. - -After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/aws-sqs/ebb_aws_sqs_overview.png" alt="" class="no-border" width="400" >}} - ## Configure Service 1. Configure the service by filling out the following: diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md index 4c672c83355..bf7710e7f83 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/blob-bridge.md @@ -9,21 +9,6 @@ description: "How to configure and manage an Azure Blob Storage bridge using the An Azure Blob Bridge is a one-way bridge that receives events via Azure object storage. -## Creating a Bridge - -Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} - -1. Click **Create a Bridge** to create a new bridge. -2. Select **Azure Blob Storage**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-service) below. -4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. - -After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/azure-blob-storage/ebb_azure_blob_overview.png" alt="" class="no-border" >}} - ## Configure Service 1. Configure the service by filling out the following: diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md index 1fb9d553334..bea6b4d58f2 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/http-bridge.md @@ -30,21 +30,6 @@ To run the HTTP bridge from your client, include a Bearer token in the request h 1. Open the HTTP bridge details using the **Options** ({{% icon name="three-dots-menu-horizontal" %}}) menu on the **Overview** page. 2. Add the **Bearer token**. -## Creating a Bridge - -Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" alt="" class="no-border" >}} - -1. Click **Create a Bridge** to create a new bridge. -2. Select **HTTP**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. -4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. - -After the bridge deploys successfully, you can view its configuration and status on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/http/ebb_http_overview.png" alt="" class="no-border" width="400" >}} - ## Configure Service {#configure-http-bridge} 1. Configure the service by filling out the following: diff --git a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md index 8a06ff1589a..399146b5881 100644 --- a/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/services/event-broker/event-broker-bridges/iceberg-bridge.md @@ -8,21 +8,6 @@ linktitle: "Apache Iceberg Bridge" An Apache Iceberg Bridge is a one-way bridge that delivers [Change Data Capture (CDC)](/refguide/change-data-capture/) events to Apache Iceberg tables stored in AWS S3 or Azure Blob Storage. -## Creating a Bridge - -Technical Contacts with a license to the Mendix Event Broker can manage this feature from the **Event Broker Bridges** tab on the [Event Broker Manager](https://broker.mendix.com/) page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/event_broker_bridges_create.png" class="no-border" >}} - -1. Click **Create a Bridge** to create a new bridge. -2. Select **Iceberg**. -3. Create and configure your bridge by following the steps in [Configure Service](#configure-http-bridge) below. -4. After configuring the service and connecting events (as described below), click **Start** on the confirmation screen to deploy the bridge. - -Once the bridge has been successfully deployed, its configuration and status can be viewed on the **Overview** page. - -{{< figure src="/attachments/appstore/platform-supported-content/services/event-broker/bridges/iceberg/ebb_iceberg_overview.png" alt="" class="no-border" width="400" >}} - ## Configure Service Configure the service by filling out the following: