[Ultimate]{class="badge positive"}
Criar uma conexão de origem Azure Event Hubs na interface
Leia este tutorial para saber como criar uma conta do Azure Event Hubs usando a interface do usuário do Adobe Experience Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
Se você já tiver uma conexão Event Hubs válida, ignore o restante deste documento e prossiga para o tutorial em configurando um fluxo de dados.
Coletar credenciais necessárias
Para autenticar o conector de origem do Event Hubs, você deve fornecer valores para as seguintes propriedades de conexão:
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Credencial | Descrição |
| Nome da chave SAS | O nome da regra de autorização, que também é conhecido como o nome da chave SAS. |
| Chave SAS | A chave primária do namespace Event Hubs. O sasPolicy ao qual sasKey corresponde deve ter direitos manage configurados para que a lista Event Hubs seja preenchida. |
| Namespace | O namespace do Event Hub que você está acessando. Um namespace Event Hub fornece um contêiner de escopo exclusivo, no qual você pode criar um ou mais Event Hubs. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| Credencial | Descrição |
| Nome da chave SAS | O nome da regra de autorização, que também é conhecido como o nome da chave SAS. |
| Chave SAS | A chave primária do namespace Event Hub. O sasPolicy ao qual sasKey corresponde deve ter direitos manage configurados para que a lista Event Hubs seja preenchida. |
| Namespace | O namespace do Event Hub que você está acessando. Um namespace Event Hub fornece um contêiner de escopo exclusivo, no qual você pode criar um ou mais Event Hubs. |
| Nome do Hub de Eventos | Preencha seu nome Azure Event Hub. Leia a documentação do Microsoft para obter mais informações sobre os nomes de Event Hub. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| Credencial | Descrição |
| ID do locatário | A ID do locatário da qual você deseja solicitar permissão. Sua ID de locatário pode ser formatada como um GUID ou como um nome amigável. Observação: a ID do locatário é chamada de "ID do Diretório" na interface Microsoft Azure. |
| ID de cliente | A ID do aplicativo atribuída ao seu aplicativo. Você pode recuperar essa ID do portal do Microsoft Entra ID no qual você registrou o Azure Active Directory. |
| Valor do segredo do cliente | O segredo do cliente usado com a ID do cliente para autenticar seu aplicativo. Você pode recuperar o segredo do cliente no portal Microsoft Entra ID em que registrou o Azure Active Directory. |
| Namespace | O namespace do Event Hub que você está acessando. Um namespace Event Hub fornece um contêiner de escopo exclusivo, no qual você pode criar um ou mais Event Hubs. |
Para obter mais informações sobre Azure Active Directory, leia o Guia do Azure sobre o uso da Microsoft Entra ID.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Credencial | Descrição |
| ID do locatário | A ID do locatário da qual você deseja solicitar permissão. Sua ID de locatário pode ser formatada como um GUID ou como um nome amigável. Observação: a ID do locatário é chamada de "ID do Diretório" na interface Microsoft Azure. |
| ID de cliente | A ID do aplicativo atribuída ao seu aplicativo. Você pode recuperar essa ID do portal do Microsoft Entra ID no qual você registrou o Azure Active Directory. |
| Valor do segredo do cliente | O segredo do cliente usado com a ID do cliente para autenticar seu aplicativo. Você pode recuperar o segredo do cliente no portal Microsoft Entra ID em que registrou o Azure Active Directory. |
| Namespace | O namespace do Event Hub que você está acessando. Um namespace Event Hub fornece um contêiner de escopo exclusivo, no qual você pode criar um ou mais Event Hubs. |
| Nome do Hub de Eventos | Preencha seu nome Azure Event Hub. Leia a documentação do Microsoft para obter mais informações sobre os nomes de Event Hub. |
Para obter mais informações sobre Azure Active Directory, leia o Guia do Azure sobre o uso da Microsoft Entra ID.
Depois de obter as credenciais necessárias, siga as etapas abaixo para vincular sua conta do Event Hubs à Experience Platform.
Conectar sua conta do Event Hubs
Na interface do Experience Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.
Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
Na categoria Armazenamento na nuvem, selecione Hubs de Eventos do Azure e Adicionar dados.
A caixa de diálogo Conectar-se aos Hubs de Eventos do Azure é exibida. Nesta página, você pode usar credenciais novas ou existentes.
Conta existente
Para usar uma conta existente, selecione a conta Event Hubs que deseja usar e clique em Avançar para continuar.
Nova conta
Para criar uma nova conta, selecione Nova conta e forneça um nome e uma descrição opcional para sua nova conta Event Hubs.
Para criar uma conta Event Hubs com autenticação padrão, use o menu suspenso Autenticação da conta e selecione Autenticação padrão. Em seguida, forneça valores para seu nome da chave SAS, chave SAS e Namespace.
Depois de inserir suas credenciais de autenticação, selecione Conectar à origem.
Para criar uma conta Event Hubs com autenticação SAS, use o menu suspenso Autenticação de conta e selecione Autenticação SAS. Em seguida, forneça valores para seu nome da chave SAS, chave SAS, Namespace e nome dos Hubs de Eventos.
Depois de inserir suas credenciais de autenticação, selecione Conectar à origem.
Para criar uma conta Event Hubs com autenticação do Ative Diretory do Azure Hub de Eventos, use o menu suspenso Autenticação de conta e selecione Ative Diretory do Azure Hub de Eventos. Em seguida, forneça valores para sua ID de Locatário, ID de Cliente, Valor Secreto de Cliente e Namespace.
Para criar uma conta Event Hubs com autenticação do Ative Diretory do Azure com Escopo do Hub de Eventos, use o menu suspenso Autenticação da conta e selecione Ative Diretory do Azure com Escopo do Hub de Eventos. Em seguida, forneça valores para sua ID de Locatário, ID de Cliente, Valor Secreto de Cliente, Namespace e Nome do Hub de Eventos.
Próximas etapas
Seguindo este tutorial, você conectou sua conta do Event Hubs à Experience Platform. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados do seu armazenamento em nuvem para o Experience Platform.