Create an Azure Event Hubs source connection in the UI
This tutorial provides steps to create an Azure Event Hubs account using the Adobe Experience Platform user interface.
Getting started
This tutorial requires a working understanding of the following components of Adobe Experience Platform:
-
Experience Data Model (XDM) System: The standardized framework by which Experience Platform organizes customer experience data.
- Basics of schema composition: Learn about the basic building blocks of XDM schemas, including key principles and best practices in schema composition.
- Schema Editor tutorial: Learn how to create custom schemas using the Schema Editor UI.
-
Real-Time Customer Profile: Provides a unified, real-time consumer profile based on aggregated data from multiple sources.
If you already have a valid Event Hubs connection, you may skip the remainder of this document and proceed to the tutorial on configuring a dataflow.
Gather required credentials
In order to authenticate your Event Hubs source connector, you must provide values for the following connection properties:
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Credential | Description |
| SAS key name | The name of the authorization rule, which is also known as the SAS key name. |
| SAS key | The primary key of the Event Hubs namespace. The sasPolicy that the sasKey corresponds to must have manage rights configured in order for the Event Hubs list to be populated. |
| Namespace | The namespace of the Event Hubs you are accessing. An Event Hubs namespace provides a unique scoping container, in which you can create one or more Event Hubs. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| Credential | Description |
| SAS key name | The name of the authorization rule, which is also known as the SAS key name. |
| SAS key | The primary key of the Event Hubs namespace. The sasPolicy that the sasKey corresponds to must have manage rights configured in order for the Event Hubs list to be populated. |
| Namespace | The namespace of the Event Hubs you are accessing. An Event Hubs namespace provides a unique scoping container, in which you can create one or more Event Hubs. |
| Event Hub name | The name for your Event Hubs source. |
For more information about these values, refer to this Event Hubs document.
Once you have gathered your required credentials, you can follow the steps below to link your Event Hubs account to Experience Platform.
Connect your Event Hubs account
In the Platform UI, select Sources from the left navigation to access the Sources workspace. The Catalog screen displays a variety of sources you can create an account with.
You can select the appropriate category from the catalog on the left-hand side of your screen. Alternatively, you can find the specific source you wish to work with using the search option.
Under the Cloud storage category, select Azure Event Hubs, and then select Add data.
The Connect to Azure Event Hubs dialog appears. On this page, you can either use new credentials or existing credentials.
Existing account
To use an existing account, select the Event Hubs account you want to use, then select Next to proceed.
New account
To create a new account, select New account, and then provide a name and an optional description for your new Event Hubs account.
To create an Event Hubs account with standard authentication, select Standard authentication and then provide values for your SAS key name, SAS key, and Namespace.
Once you have inputted your authentication credentials, select Connect to source.
To create an Event Hubs account with SAS authentication, select SAS authentication and then provide values for your SAS key name, SAS key, Namespace, and Event Hubs name.
Once you have inputted your authentication credentials, select Connect to source.
Next steps
By following this tutorial, you have connected your Event Hubs account to Experience Platform. You can now continue on to the next tutorial and configure a dataflow to bring data from your cloud storage into Experience Platform.