Migrar um aplicativo para usar conexões sem senha com o Barramento de Serviço do Azure

await using ServiceBusClient client = new("<CONNECTION-STRING>");

client, err := azservicebus.NewClientFromConnectionString(
    "<CONNECTION-STRING>",
    nil)

if err != nil {
    // handle error
}

JMS:

ConnectionFactory factory = new ServiceBusJmsConnectionFactory(
    "<CONNECTION-STRING>",
    new ServiceBusJmsConnectionFactorySettings());

Cliente receptor:

ServiceBusReceiverClient receiver = new ServiceBusClientBuilder()
    .connectionString("<CONNECTION-STRING>")
    .receiver()
    .topicName("<TOPIC-NAME>")
    .subscriptionName("<SUBSCRIPTION-NAME>")
    .buildClient();

Cliente remetente:

ServiceBusSenderClient client = new ServiceBusClientBuilder()
    .connectionString("<CONNECTION-STRING>")
    .sender()
    .queueName("<QUEUE-NAME>")
    .buildClient();

const client = new ServiceBusClient("<CONNECTION-STRING>");

client = ServiceBusClient(
    fully_qualified_namespace = "<CONNECTION-STRING>"
)

1. No portal do Azure, localize o namespace do Barramento de Serviço usando a barra de pesquisa principal ou a navegação à esquerda.

2. Na página de visão geral do Barramento de Serviço, selecione Controle de acesso (IAM) no menu à esquerda.

3. Na página Controle de acesso (IAM), selecione a guia Atribuições de função.

4. Selecione + Adicionar no menu superior e, em seguida, Adicionar atribuição de função no menu suspenso resultante.

   

5. Use a caixa de pesquisa para filtrar os resultados para a função desejada. Para este exemplo, pesquise o Proprietário de Dados do Barramento de Serviço do Azure e selecione o resultado correspondente e, em seguida, escolha Avançar.

6. Em Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço e, em seguida, selecione + Selecionar membros.

7. No diálogo, pesquise seu nome de usuário do Microsoft Entra (geralmente seu endereço de email user@domain) e escolha Selecionar na parte inferior do diálogo.

8. Selecione Revisar + atribuir para ir para a página final e, em seguida, Revisar + atribuir novamente para concluir o processo.

Para atribuir uma função no nível do recurso usando a CLI do Azure, primeiro você deve recuperar a ID do recurso usando o comando az servicesbus namespace show. É possível filtrar as propriedades de saída usando o parâmetro --query.

az servicebus namespace show --resource-group '<your-resource-group-name>' --name '<your-service-bus-namespace>' --query id

Copie a saída ID do comando anterior. Em seguida, você pode atribuir funções usando o comando az role da CLI do Azure.

az role assignment create --assignee "<user@domain>" \
    --role "Azure Service Bus Data Owner" \
    --scope "<your-resource-id>"

Para atribuir uma função no nível do recurso usando o Azure PowerShell, primeiro você precisa recuperar a ID do recurso usando o comando Get-AzResource.

Get-AzResource -ResourceGroupName "<yourResourceGroupname>" -Name "<yourServiceBusName>"

Copie o valor ID da saída do comando anterior. Em seguida, é possível atribuir funções usando o comando New-AzRoleAssignment no PowerShell.

New-AzRoleAssignment -SignInName <user@domain> `
    -RoleDefinitionName "Azure Service Bus Data Owner" `
    -Scope <yourServiceBusId>

Entre no Azure por meio da CLI do Azure usando o seguinte comando:

az login

Selecione o botão Entrar no canto superior direito do Visual Studio.

Entre usando a conta do Microsoft Entra à qual você atribuiu uma função anteriormente.

Você precisará instalar a CLI do Azure para trabalhar com DefaultAzureCredential pelo Visual Studio Code.

No menu principal do Visual Studio Code, navegue até Terminal > Novo Terminal.

Entre no Azure por meio da CLI do Azure usando o seguinte comando:

az login

Entre no Azure usando o PowerShell com o seguinte comando:

Connect-AzAccount

1. Para usar DefaultAzureCredential em um aplicativo .NET, instale o pacote Azure.Identity:

   dotnet add package Azure.Identity
   

2. Na parte superior do seu arquivo, adicione o código a seguir:

   using Azure.Identity;
   

3. Identifique o código que cria um objeto ServiceBusClient para conexão com o Barramento de Serviço do Azure. Atualize o código para que ele corresponda ao seguinte exemplo:

    var serviceBusNamespace = $"{namespace}.servicebus.windows.net";
    ServiceBusClient client = new(
        serviceBusNamespace,
        new DefaultAzureCredential());
   

1. Para usar DefaultAzureCredential em um aplicativo Go, instale o módulo azidentity:

   go get -u github.com/Azure/azure-sdk-for-go/sdk/azidentity
   

2. Na parte superior do seu arquivo, adicione o código a seguir:

   import (
       "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   )
   

3. Identifique os locais em seu código que criam uma instância de Client para se conectar ao Barramento de Serviço do Azure. Atualize o código para que ele corresponda ao seguinte exemplo:

   credential, err := azidentity.NewDefaultAzureCredential(nil)
   
   if err != nil {
       // handle error
   }
   
   serviceBusNamespace := fmt.Sprintf(
       "%s.servicebus.windows.net",
       namespace)
   client, err := azservicebus.NewClient(serviceBusNamespace, credential, nil)
   
   if err != nil {
       // handle error
   }
   

1. Para usar DefaultAzureCredential:

   • Em um aplicativo JMS, adicione pelo menos a versão 1.0.0 do pacote azure-servicebus-jms ao seu aplicativo:

     <dependency>
         <groupId>com.microsoft.azure</groupId>
         <artifactId>azure-servicebus-jms</artifactId>
         <version>1.0.0</version>
     </dependency>
     

   • Em um aplicativo Java, instale o pacote azure-identity por meio de uma das seguintes abordagens:

     • Incluir o arquivo da BOM.
     • Incluir uma dependência direta.

2. Na parte superior do seu arquivo, adicione o código a seguir:

   import com.azure.identity.DefaultAzureCredentialBuilder;
   

3. Atualize o código que se conecta ao Barramento de Serviço do Azure:

   • Em um aplicativo JMS, identifique o código que cria um objeto ServiceBusJmsConnectionFactory para conexão com o Barramento de Serviço do Azure. Atualize o código para que ele corresponda ao seguinte exemplo:

      DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
          .build();
      String serviceBusNamespace = 
          namespace + ".servicebus.windows.net";
     
      ConnectionFactory factory = new ServiceBusJmsConnectionFactory(
          credential,
          serviceBusNamespace,
          new ServiceBusJmsConnectionFactorySettings());
     

   • Em um aplicativo Java, identifique o código que cria um objeto cliente remetente ou receptor do Barramento de Serviço para se conectar ao Barramento de Serviço do Azure. Atualize seu código para corresponder a um dos exemplos a seguir:

     Cliente receptor:

     DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
         .build();
     String serviceBusNamespace = 
         namespace + ".servicebus.windows.net";
     
     ServiceBusReceiverClient receiver = new ServiceBusClientBuilder()
         .credential(serviceBusNamespace, credential)
         .receiver()
         .topicName("<TOPIC-NAME>")
         .subscriptionName("<SUBSCRIPTION-NAME>")
         .buildClient();
     

     Cliente remetente:

     DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
         .build();
     String serviceBusNamespace = 
         namespace + ".servicebus.windows.net";
     
     ServiceBusSenderClient client = new ServiceBusClientBuilder()
         .credential(serviceBusNamespace, credential)
         .sender()
         .queueName("<QUEUE-NAME>")
         .buildClient();
     

1. Para usar DefaultAzureCredential em um aplicativo Node.js, instale o pacote @azure/identity:

   npm install --save @azure/identity
   

2. Na parte superior do seu arquivo, adicione o código a seguir:

   const { DefaultAzureCredential } = require("@azure/identity");
   

3. Identifique o código que cria um objeto ServiceBusClient para conexão com o Barramento de Serviço do Azure. Atualize o código para que ele corresponda ao seguinte exemplo:

   const credential = new DefaultAzureCredential();
   const serviceBusNamespace = `${namespace}.servicebus.windows.net`;    
   
   const client = new ServiceBusClient(
     serviceBusNamespace,
     credential
   );
   

1. Para usar DefaultAzureCredential em um aplicativo Python, instale o pacote azure-identity:

   pip install azure-identity
   

2. Na parte superior do seu arquivo, adicione o código a seguir:

   from azure.identity import DefaultAzureCredential
   

3. Identifique o código que cria um objeto ServiceBusClient para conexão com o Barramento de Serviço do Azure. Atualize o código para que ele corresponda ao seguinte exemplo:

   credential = DefaultAzureCredential()
   service_bus_namespace = "%s.servicebus.windows.net" % namespace
   
   client = ServiceBusClient(
       fully_qualified_namespace = service_bus_namespace,
       credential = credential
   )
   

Alguns ambientes de hospedagem de aplicativos dão suporte ao Conector de Serviço, o que ajuda a conectar os serviços de computação do Azure a outros serviços de suporte. O Conector de Serviço define automaticamente as configurações de rede e as informações de conexão. Você pode saber mais sobre o Conector de Serviço e quais cenários têm suporte na página de visão geral.

Atualmente, há suporte para os seguintes serviços de computação:

• Serviço de aplicativo do Azure
• Azure Spring Cloud
• Aplicativos de Contêiner do Azure (versão prévia)

Para este guia de migração, você usará o Serviço de Aplicativo, mas as etapas são semelhantes nos Aplicativos Spring do Azure e nos Aplicativos de Contêiner do Azure.

1. Na página de visão geral principal do Serviço de Aplicativo, selecione Conector de serviço na navegação à esquerda.

2. Selecione + Criar no menu superior e o painel Criar conexão será aberto. Insira os valores a seguir:

   • Tipo de serviço: escolha Barramento de serviço.
   • Assinatura: selecione a assinatura que você deseja usar.
   • Nome da conexão: insira um nome para sua conexão, como connector_appservice_servicebus.
   • Tipo de cliente: deixe o valor padrão selecionado ou escolha o cliente específico que você deseja usar.

   Selecione Próximo: Autenticação.

3. Verifique se a identidade gerenciada atribuída pelo sistema (Recomendado) está selecionada e escolha Avançar: Rede.

4. Deixe os valores padrão selecionados e escolha Avançar: Examinar + Criar.

5. Depois que o Azure validar suas configurações, selecione Criar.

O Conector de serviço criará automaticamente uma identidade gerenciada atribuída pelo sistema para o serviço de aplicativo. O conector também atribuirá à identidade gerenciada uma função de Proprietário de Dados do Barramento de Serviço do Azure para o barramento de serviço selecionado.

1. Na página de visão geral principal do Serviço de Aplicativo do Azure, selecione Identidade na navegação à esquerda.

2. Na guia Atribuída ao Sistema, certifique-se de definir o campo Status como ativado. Uma identidade atribuída pelo sistema é gerenciada internamente pelo Azure e lida com tarefas administrativas para você. Os detalhes e as IDs da identidade nunca são expostos em seu código.

   

1. Na página de visão geral principal da instância dos Aplicativos Spring do Azure, selecione Identidade na navegação à esquerda.

2. Na guia Atribuída ao Sistema, certifique-se de definir o campo Status como ativado. Uma identidade atribuída pelo sistema é gerenciada internamente pelo Azure e lida com tarefas administrativas para você. Os detalhes e as IDs da identidade nunca são expostos em seu código.

   

1. Na página de visão geral principal da instância dos Aplicativos de Contêiner do Azure, selecione Identidade na navegação à esquerda.

2. Na guia Atribuída ao Sistema, certifique-se de definir o campo Status como ativado. Uma identidade atribuída pelo sistema é gerenciada internamente pelo Azure e lida com tarefas administrativas para você. Os detalhes e as IDs da identidade nunca são expostos em seu código.

   

1. Na página de visão geral principal da sua máquina virtual, selecione Identidade na navegação à esquerda.

2. Na guia Atribuída ao Sistema, certifique-se de definir o campo Status como ativado. Uma identidade atribuída pelo sistema é gerenciada internamente pelo Azure e lida com tarefas administrativas para você. Os detalhes e as IDs da identidade nunca são expostos em seu código.

   

Você pode usar o Conector de Serviço para criar uma conexão entre um ambiente de hospedagem de computação do Azure e um serviço de destino usando a CLI do Azure. A CLI manipula automaticamente a criação de uma identidade gerenciada e atribui a função adequada, conforme explicado nas instruções do portal.

Se você estiver usando um Serviço de Aplicativo do Azure, use o comando az webapp connection:

az webapp connection create servicebus \
    --resource-group <resource-group-name> \
    --name <webapp-name> \
    --target-resource-group <target-resource-group-name> \
    --namespace <target-service-bus-namespace> \
    --system-identity

Se você estiver usando os Aplicativos Spring do Azure, use o comando az spring connection:

az spring connection create servicebus \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --app <app-name> \
    --deployment <deployment-name> \
    --target-resource-group <target-resource-group> \
    --namespace <target-service-bus-namespace> \
    --system-identity

Se você estiver usando os Aplicativos de Contêiner do Azure, use o comando az containerapp connection:

az containerapp connection create servicebus \
    --resource-group <resource-group-name> \
    --name <webapp-name> \
    --target-resource-group <target-resource-group-name> \
    --namespace <target-service-bus-namespace> \
    --system-identity

Você pode atribuir uma identidade gerenciada a uma instância do Serviço de Aplicativo do Azure com o comando az webapp identity assign.

az webapp identity assign \
    --resource-group <resource-group-name> \
    --name <webapp-name>

Você pode atribuir uma identidade gerenciada a uma instância de Aplicativos Spring do Azure com o comando az spring app identity assign.

az spring app identity assign \
    --resource-group <resource-group-name> \
    --name <app-name> \
    --service <service-name>

Você pode atribuir uma identidade gerenciada a uma instância de Aplicativos de Contêiner do Azure com o comando az container app identity assign.

az containerapp identity assign \
    --resource-group <resource-group-name> \
    --name <app-name>

Você pode atribuir uma identidade gerenciada a uma máquina virtual com o comando az vm identity assign.

az vm identity assign \
    --resource-group <resource-group-name> \
    --name <virtual-machine-name>

Você pode atribuir uma identidade gerenciada a uma instância do AKS (Serviço de Kubernetes do Azure) com o comando az aks update.

az aks update \
    --resource-group <resource-group-name> \
    --name <virtual-machine-name> \
    --enable-managed-identity

Se você conectou seus serviços usando o Conector de serviço, não será necessário concluir esta etapa. As configurações necessárias foram tratadas para você:

• Se você selecionou uma identidade gerenciada durante a criação da conexão, uma identidade gerenciada atribuída pelo sistema foi criada para seu aplicativo e atribuiu a função de Proprietário de Dados do Barramento de Serviço do Azure, no Barramento de Serviço.

• Se você selecionou a cadeia de conexão, a cadeia de conexão foi adicionada como uma variável de ambiente de aplicativo.

1. Navegue até a página de visão geral do Barramento de Serviço e selecione Controle de Acesso (IAM) na navegação à esquerda.

2. Escolha Adicionar atribuição de função.

   

3. Na caixa de pesquisa Função, pesquise por Proprietário de Dados do Barramento de Serviço do Azure, que é uma função comum usada para gerenciar operações de dados para blobs. Você pode atribuir qualquer função apropriada para seu caso de uso. Selecione o Proprietário de Dados do Barramento de Serviço do Azure na lista e escolha Avançar.

4. Na tela Adicionar atribuição de função, para a opção Atribuir acesso à, selecione Identidade gerenciada. Em seguida, escolha +Selecionar membros.

5. No submenu, pesquise a identidade gerenciada que você criou inserindo o nome do serviço de aplicativo. Selecione a identidade atribuída pelo sistema e escolha Selecionar para fechar o menu de submenu.

   

6. Selecione Avançar algumas vezes até que você possa selecionar Revisão + atribuir para concluir a atribuição de função.

Para atribuir uma função no nível do recurso usando a CLI do Azure, primeiro você deve recuperar a ID do recurso usando o comando az servicebus show. É possível filtrar as propriedades de saída usando o parâmetro --query.

az servicebus show \
    --resource-group '<your-resource-group-name>' \
    --name '<your-service-bus-namespace>' \
    --query id

Copie a ID de saída do comando anterior. Em seguida, você pode atribuir funções usando o comando az role da CLI do Azure.

az role assignment create \
    --assignee "<your-username>" \
    --role "Azure Service Bus Data Owner" \
    --scope "<your-resource-id>"