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 recetor:

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 seu namespace do Service Bus usando a barra de pesquisa principal ou a navegação à esquerda.

2. Na página Visão geral do Service Bus, 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, procure Proprietário de Dados do Barramento de Serviço do Azure, selecione o resultado correspondente e escolha Avançar.

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

7. Na caixa de diálogo, procure seu nome de usuário do Microsoft Entra (geralmente seu endereço de e-mail user@domain ) e escolha Selecionar na parte inferior da caixa de diálogo.

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

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

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 de recurso usando o Azure PowerShell, primeiro você deve recuperar a ID do recurso usando o Get-AzResource comando.

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

Copie o ID valor da saída do comando anterior. Em seguida, você pode 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 o Visual Studio Code.

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

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

az login

Entre no Azure usando o PowerShell por meio do seguinte comando:

Connect-AzAccount

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

   dotnet add package Azure.Identity
   

2. Na parte superior do ficheiro, adicione o seguinte código:

   using Azure.Identity;
   

3. Identifique o código que cria um ServiceBusClient objeto para se conectar ao Barramento de Serviço do Azure. Atualize seu código para corresponder ao exemplo a seguir:

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

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

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

2. Na parte superior do ficheiro, adicione o seguinte código:

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

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

   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 utilizar DefaultAzureCredential:

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

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

   • Em uma aplicação Java, instale o azure-identity pacote por meio de uma das seguintes abordagens:

     • Inclua o arquivo BOM.
     • Inclua uma dependência direta.

2. Na parte superior do ficheiro, adicione o seguinte código:

   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 ServiceBusJmsConnectionFactory objeto para se conectar ao Barramento de Serviço do Azure. Atualize seu código para corresponder ao exemplo a seguir:

      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 recetor do Service Bus para se conectar ao Barramento de Serviço do Azure. Atualize seu código para corresponder a um dos seguintes exemplos:

     Cliente recetor:

     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 @azure/identity pacote:

   npm install --save @azure/identity
   

2. Na parte superior do ficheiro, adicione o seguinte código:

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

3. Identifique o código que cria um ServiceBusClient objeto para se conectar ao Barramento de Serviço do Azure. Atualize seu código para corresponder ao exemplo a seguir:

   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 azure-identity pacote:

   pip install azure-identity
   

2. Na parte superior do ficheiro, adicione o seguinte código:

   from azure.identity import DefaultAzureCredential
   

3. Identifique o código que cria um ServiceBusClient objeto para se conectar ao Barramento de Serviço do Azure. Atualize seu código para corresponder ao exemplo a seguir:

   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 oferecem suporte ao Service Connector, que ajuda você a conectar os serviços de computação do Azure a outros serviços de suporte. O Service Connector define automaticamente as configurações de rede e as informações de conexão. Você pode saber mais sobre o Service Connector e quais cenários são suportados na página de visão geral.

Os seguintes serviços de computação são suportados atualmente:

• Serviço de Aplicações do Azure
• Azure Spring Cloud
• Aplicativos de Contêiner do Azure (visualização)

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

1. Na página de visão geral principal do seu 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. Introduza os seguintes valores:

   • Tipo de serviço: Escolha Barramento de serviço.
   • Assinatura: selecione a assinatura que você gostaria de 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ê gostaria de usar.

   Selecione Next: Authentication.

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

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

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

O Service Connector criará automaticamente uma identidade gerenciada atribuída ao 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 da sua instância do Serviço de Aplicativo do Azure, selecione Identidade na navegação à esquerda.

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

   

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

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

   

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

2. Na guia Sistema atribuído, certifique-se de definir o campo Status como ativado. Uma identidade atribuída ao sistema é gerenciada pelo Azure internamente e lida com tarefas administrativas para você. Os detalhes e IDs da identidade nunca são expostos no 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 Sistema atribuído, certifique-se de definir o campo Status como ativado. Uma identidade atribuída ao sistema é gerenciada pelo Azure internamente e lida com tarefas administrativas para você. Os detalhes e IDs da identidade nunca são expostos no seu código.

   

Você pode usar o Service Connector 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 lida automaticamente com 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 az webapp connection comando:

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 o Azure Spring Apps, use o az spring connection comando:

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 az containerapp connection comando:

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 do Azure Spring Apps 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 dos 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 Serviço Kubernetes do Azure (AKS) 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 Service Connector, não precisará 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 ao sistema foi criada para seu aplicativo e atribuída 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 do aplicativo.

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

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

   

3. Na caixa Pesquisa de função, procure 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 a, selecione Identidade gerenciada. Em seguida, escolha +Selecionar membros.

5. No submenu, procure a identidade gerenciada que você criou inserindo o nome do seu serviço de aplicativo. Selecione a identidade atribuída ao sistema e, em seguida, escolha Selecionar para fechar o menu suspenso.

   

6. Selecione Avançar algumas vezes até conseguir selecionar Revisar + atribuir para concluir a atribuição de função.

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

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

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

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