Adicionando o Armazenamento do Azure usando o Visual Studio Connected Services

Com o Visual Studio, é possível conectar qualquer um dos seguintes Armazenamento do Microsoft Azure usando os Serviços Conectados:

• Aplicativo de console do .NET Framework
• ASP.NET Modelo-Visão-Controlador (MVC) (estrutura .NET)
• ASP.NET Core
• .NET Core (incluindo aplicativo de console, WPF, Windows Forms, biblioteca de classes)
• Função de trabalho do .NET Core
• Funções do Azure
• Aplicativo da Plataforma Universal do Windows
• Xamarin
• Cordova

A funcionalidade do serviço conectado adiciona todas as referências necessárias e o código de conexão ao seu projeto, bem como modifica os arquivos de configuração adequadamente.

Pré-requisitos

• Visual Studio (consulte [Downloads do Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) com a carga de trabalho de desenvolvimento do Azure instalada.
• Um projeto de um dos tipos com suporte
• Uma conta do Azure. Se você não tiver uma conta Azure, ative seus benefícios do Azure para assinantes do Microsoft Visual Studio ou inscreva-se para uma avaliação gratuita.

Conectar-se ao Armazenamento do Microsoft Azure usando serviços conectados

1. Abra o 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, em seguida, selecione Avançar.

   

   Se ainda não estiver conectado, entre em sua conta do Azure. Se não tiver uma conta do Azure, você poderá assinar uma versão de 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, passe para a próxima etapa. Caso contrário, pule para a próxima etapa.

   

6. Para criar uma conta de armazenamento:

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

   2. Preencha a caixa de diálogo Armazenamento do Microsoft Azure: Cria nova 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 escolha Avançar.

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 conforme 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, no Azure Key Vault ou não seja 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 secrets.json local pode ser exposta. Se você estiver usando o Visual Studio 2022 versão 17.12 ou posterior, esse procedimento produzirá um resultado mais seguro, pois gera 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 é configurado para usar a autenticação para acessar a conta de armazenamento. As informações de conexão para essa autenticação são armazenadas localmente, se você escolher o método secrets.json , ou no Azure Key Vault.

Se você usou o arquivo secrets.json , abra o arquivo usando os três pontos ao lado Secrets.json na guia 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 do 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 nenhuma alteração 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. Consulte DefaultAzureCredential.

Próximas etapas

O Armazenamento do Azure dá suporte a blobs e filas, bem como a outros recursos.

Para saber mais sobre como trabalhar com blobs, você pode continuar com o início rápido para o armazenamento de blobs, mas, em vez de começar no início, você pode começar no Início rápido de blobs do Azure (.NET) – exemplos de código.

Para saber mais sobre como trabalhar com filas, comece em Início rápido do Armazenamento de Filas do Azure (.NET) - Exemplos de código.

Conteúdo relacionado

• Fórum do Armazenamento do Azure
• Documentação do Armazenamento do Azure