[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 inquilino | 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 inquilino | 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 ao Experience Platform.
Conectar sua conta do Event Hubs
Na interface da 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 ao Experience Platform. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados do seu armazenamento na nuvem para o Experience Platform.