Acesse Hubs de Eventos do Azure a partir de uma VM usando uma identidade gerenciada

Este artigo mostra como conectar aos Hubs de Eventos do Azure a partir de um aplicativo que roda em uma máquina virtual (VM) Azure usando uma identidade gerenciada. Quando você usa uma identidade gerenciada, sua aplicação se autentica em Hubs de Eventos sem armazenar strings de conexão ou chaves de acesso no código ou configuração. O Azure provisiona e rotaciona as credenciais automaticamente.

Neste artigo, você concluirá as seguintes tarefas:

Para entender como a autenticação de identidade gerenciada funciona com Event Hubs, veja Autenticação de identidade gerenciada para Hubs de Eventos do Azure.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuita se ainda não tiver a sua.
• Um namespace de Hubs de Eventos e um hub de eventos. Para criá-las, veja Início Rápido: Criar um hub de eventos usando o portal do Azure.
• Uma máquina virtual do Azure. Para criar uma, veja Quickstart: Crie uma VM Windows no portal do Azure ou Quickstart: Crie uma VM Linux no portal do Azure.
• Permissão para atribuir funções do Azure no escopo de destino. O papel de Proprietário ou Administrador de Acesso ao Usuário inclui essa permissão.
• O SDK .NET instalado na VM para construir e executar a aplicação de exemplo.

Ative uma identidade gerenciada na VM

Ative uma identidade gerenciada atribuída ao sistema na VM. O Azure cria uma identidade no Microsoft Entra ID que está atrelada ao ciclo de vida da VM.

1. Entre no portal do Azure.

2. Acesse a sua máquina virtual.

3. Na página da VM, selecione Identidade de Segurança> no menu esquerdo.

4. Na página de Identidade , confirme que você está na aba Sistemas Atribuídos .

5. Para o campo Status, selecione Ativado.

6. Selecione Salvar na barra de comandos e depois selecione sim para confirmar.

   Após o Azure criar a identidade, o ID do Objeto (principal) aparece na página. Você usa essa identidade na próxima seção.

Para habilitar uma identidade gerenciada atribuída pelo usuário, veja Configurar identidades gerenciadas para recursos do Azure em uma VM. Uma identidade atribuída pelo usuário é um recurso independente que você pode atribuir a mais de uma VM.

Conceda acesso à identidade gerenciada aos Centros de Eventos

Atribua um papel Azure embutido à identidade gerenciada para que ele possa enviar eventos para seu hub de eventos. Este exemplo atribui a função Hubs de Eventos do Azure Data Sender no escopo de apenas um hub de eventos. Conceda o escopo mais restrito que atenda às necessidades da sua aplicação.

1. No portal do Azure, vá para o hub de eventos.
2. Na página do hub de eventos, selecione Controle de Acesso (IAM) no menu esquerdo.
3. Selecione Adicionar>Adicionar atribuição de função.
4. Na aba Função, selecione Hubs de Eventos do Azure Data Sender e depois selecione Próximo.
5. Na guia Membros , para atribuir acesso, selecione Identidade gerenciada.
6. Selecione + Selecionar membros, escolha a identidade gerenciada da Máquina virtual que você habilitou na seção anterior e, em seguida, selecione Selecionar.
7. Clique em Revisar + atribuir para concluir a atribuição de função.

Para ver a lista completa de funções e escopos, consulte funções internas do Azure para o Hubs de Eventos do Azure. Para atribuir funções no portal Azure, veja Atribuir papéis no Azure usando o portal Azure.

Crie e execute a aplicação de exemplo na VM

Crie um aplicativo de console .NET que envie eventos para o seu hub de eventos. Quando o aplicativo roda na VM, DefaultAzureCredential detecta automaticamente a identidade gerenciada, então você não fornece uma cadeia de conexão ou chave.

1. Conectar-se à VM. Para uma VM Windows, use o Área de Trabalho Remota. Para uma VM Linux, use SSH.

2. Em um terminal na VM, crie um projeto e adicione os pacotes necessários:

   dotnet new console --name EventHubsManagedIdentitySample
   cd EventHubsManagedIdentitySample
   dotnet add package Azure.Messaging.EventHubs
   dotnet add package Azure.Identity
   

3. Substitua o conteúdo de Program.cs pelo seguinte código. Substitua <namespace> pelo nome do namespace do seu Event Hub e <event-hub-name> pelo nome do seu event hub.

   using Azure.Identity;
   using Azure.Messaging.EventHubs;
   using Azure.Messaging.EventHubs.Producer;
   
   // DefaultAzureCredential detects the managed identity available on the VM.
   var credential = new DefaultAzureCredential();
   
   var producerClient = new EventHubProducerClient(
       "<namespace>.servicebus.windows.net",
       "<event-hub-name>",
       credential);
   
   using EventDataBatch eventBatch = await producerClient.CreateBatchAsync();
   eventBatch.TryAdd(new EventData("First event from a managed identity"));
   eventBatch.TryAdd(new EventData("Second event from a managed identity"));
   
   await producerClient.SendAsync(eventBatch);
   await producerClient.DisposeAsync();
   
   Console.WriteLine("Events sent to the event hub.");
   

4. Construa e execute a aplicação na VM:

   dotnet run
   

   A aplicação utiliza a identidade gerenciada da VM para autenticar e enviar os eventos. Quando os eventos são enviados, o console exibe Events sent to the event hub.

5. Para confirmar que os eventos chegaram, use o Data Explorer no portal do Azure para seu hub de eventos, ou as métricas na página de Visão Geral do namespace.

Conteúdo relacionado

• Autenticação de identidade gerenciada para o Hubs de Eventos do Azure
• Habilitar a identidade gerenciada para um namespace do Hubs de Eventos do Azure
• Autorizar o acesso aos recursos dos Hubs de Eventos usando o Microsoft Entra ID
• O que são identidades gerenciadas para recursos do Azure?