Adicionando o Armazenamento do Azure usando os Serviços Conectados do Visual Studio

1. Abra seu projeto no Visual Studio.

2. Pressione Ctrl+Q (ou use o botão Pesquisar no IDE do Visual Studio à direita da barra de menus principal).

3. Em Pesquisa de recursos, insira Azure Storagee escolha Armazenamento do Microsoft Azure – Projeto > Serviços conectados > Adicionar > Armazenamento do Azure.

   

4. Na página Conectar-se à Dependência, selecione Armazenamento do Microsoft Azure e selecione Avançar.

   

   Se você ainda não estiver conectado, entre em sua conta do Azure. Se você não tiver uma conta do Azure, poderá se inscrever para uma avaliação gratuita .

5. Na tela Configurar Armazenamento do Microsoft Azure, selecione uma conta de armazenamento existente e selecione Avançar.

   Se você precisar criar uma conta de armazenamento, vá para a próxima etapa. Caso contrário, vá para a etapa a seguir.

   

6. Para criar uma conta de armazenamento:

   1. Selecione Criar nova pelo sinal de adição verde.

   2. Preencha o diálogo Armazenamento do Microsoft Azure: Cria nova caixa de diálogo e selecione Criar.

      

   3. Quando a caixa de diálogo Armazenamento do Azure for exibida, a nova conta de armazenamento aparecerá na lista. Selecione a nova conta de armazenamento na lista e selecione Próximo.

7. Insira um nome de configuração de cadeia de conexão. O nome da configuração faz referência ao nome da configuração da cadeia de conexão como ela aparece no arquivo secrets.json ou no Azure Key Vault.

   

8. Escolha se deseja que a cadeia de conexão seja armazenada em um arquivo de segredos local, em do Azure Key Vault ou não armazenada em nenhum lugar.

   

   Cuidado

   Se você estiver usando uma versão do Visual Studio anterior ao Visual Studio 17.12 e optar por usar um arquivo secrets.json, deverá tomar precauções de segurança, pois a cadeia de conexão no arquivo de secrets.json local poderá ser exposta. Se você estiver usando o Visual Studio 2022 versão 17.12 ou posterior, esse procedimento produzirá um resultado mais seguro, pois produzirá um valor de configuração de conexão, em vez de uma cadeia de conexão com credenciais de autenticação.

9. A tela Resumo das alterações mostra todas as modificações que serão feitas no projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.

   

10. O serviço conectado de armazenamento aparece sob o nó Serviços Conectados do seu projeto.

Entender a autenticação

Depois de executar o procedimento anterior, seu aplicativo será configurado para usar a autenticação para acessar a conta de armazenamento. As informações de conexão dessa autenticação são armazenadas localmente, se você escolheu o método secrets.json ou em seu Azure Key Vault.

Se você usou o arquivo secrets.json, abra o arquivo usando os três pontos ao lado de Secrets.json na guia dos Serviços Conectados para abrir um menu e escolha Gerenciar segredos do usuário. Com o Visual Studio 2022 versão 17.12 e posterior, esse arquivo contém configurações que fazem referência a um URI para obter a cadeia de conexão segura, em vez da própria cadeia de conexão.

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

Com essas configurações no Visual Studio 17.12 e posterior, a autenticação é automática e flexível. Quando você executa ou depura localmente no Visual Studio, suas credenciais do Azure salvas pelo Visual Studio são usadas para acessar a conta de Armazenamento do Azure. Se você iniciar seu aplicativo na linha de comando, primeiro precisará entrar usando a CLI do Azure e essas credenciais serão detectadas e usadas automaticamente. Mas quando seu aplicativo é implantado no Azure e é executado no Azure, ele usa a identidade gerenciada, sem alterações de código. A autenticação funciona em todos os ambientes de hospedagem porque as APIs de Identidade do Azure verificam todas as credenciais encadeadas em sequência e as usam quando são encontradas. Confira DefaultAzureCredential.