Ajout d’Azure Storage à l’aide de Visual Studio Connected Services

Avec Visual Studio, vous pouvez connecter l’un des éléments suivants au stockage Azure à l’aide de la fonctionnalité Services connectés :

• Application console du .NET Framework
• ASP.NET Modèle -View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (y compris l’application console, WPF, Windows Forms, bibliothèque de classes)
• Rôle de travail .NET Core
• Azure Functions
• Application de plateforme Windows universelle
• Cordoue

La fonctionnalité de service connecté ajoute toutes les références et le code de connexion nécessaires à votre projet et modifie vos fichiers de configuration de manière appropriée.

Conditions préalables

• Visual Studio (voir [Téléchargements Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) avec la charge de travail développement Azure installée.
• Projet d’un des types pris en charge
• Un compte Azure. Si vous n’avez pas de compte Azure, activez vos avantages Azure pour les abonnés Visual Studio ou inscrivez-vous à un essai gratuit.

Se connecter au stockage Azure à l’aide des services connectés

1. Ouvrez votre projet dans Visual Studio.

2. Appuyez sur Ctrl+Q (ou utilisez le bouton de recherche dans l’IDE Visual Studio à droite de la barre de menus principale).

3. Dans Recherche de fonctionnalités, entrez Azure Storage, puis choisissez Stockage Azure - Project > Services connectés > Ajouter > Stockage Azure.

   

4. Dans la page Se connecter à la dépendance, sélectionnez Stockage Azure, puis sélectionnez Suivant.

   

   Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’avez pas de compte Azure, vous pouvez vous inscrire à un essai gratuit .

5. Dans l'écran Se connecter au stockage Azure, sélectionnez un compte de stockage existant, puis sélectionnez Suivant.

   Si vous devez créer un compte de stockage, passez à l’étape suivante. Sinon, passez à l’étape suivante.

   

6. Pour créer un compte de stockage :

   1. Sélectionnez Créer nouveau par le signe plus vert.

   2. Renseignez les informations demandées dans la boîte de dialogue Stockage Azure : Créer nouveau, puis sélectionnez Créer.

      

   3. Lorsque la boîte de dialogue stockage Azure s’affiche, le nouveau compte de stockage apparaît dans la liste. Sélectionnez le nouveau compte de stockage dans la liste, et sélectionnez suivant.

7. Entrez un nom de paramètre de chaîne de connexion. Le nom du paramètre fait référence au nom du paramètre de chaîne de connexion tel qu’il apparaît dans le fichier secrets.json ou dans Azure Key Vault.

   

8. Indiquez si vous souhaitez que la chaîne de connexion soit stockée dans un fichier de secrets locaux, dans azure Key Vault, ou non stockée n’importe où.

   

   Attention

   Si vous utilisez une version de Visual Studio antérieure à Visual Studio 17.12 et que vous choisissez d’utiliser un fichier secrets.json, vous devez prendre des précautions de sécurité, car la chaîne de connexion dans le fichier local secrets.json peut être exposée. Si vous utilisez Visual Studio 2022 version 17.12 ou ultérieure, cette procédure produit un résultat plus sécurisé, car elle génère une valeur de paramètre de connexion, au lieu d’une chaîne de connexion avec des informations d’identification d’authentification.

9. L'écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous menez à bien le processus. Si les modifications semblent correctes, choisissez Terminer.

   

10. Le service connecté au stockage apparaît sous le nœud Services connectés de votre projet.

Comprendre l’authentification

Après avoir exécuté la procédure précédente, votre application est configurée pour utiliser l’authentification pour accéder au compte de stockage. Les informations de connexion pour cette authentification sont stockées localement, si vous avez choisi la méthode secrets.json ou dans votre coffre de clés Azure.

Si vous avez utilisé le fichier secrets.json, ouvrez le fichier en utilisant les trois points en regard de Secrets.json sous l’onglet Services connectés pour ouvrir un menu, puis choisissez Gérer les secrets utilisateur. Avec Visual Studio 2022 version 17.12 et ultérieures, ce fichier contient des paramètres qui référencent un URI pour obtenir la chaîne de connexion sécurisée, plutôt que la chaîne de connexion elle-même.

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

Avec ces paramètres dans Visual Studio 17.12 et versions ultérieures, l’authentification est automatique et flexible. Lorsque vous exécutez ou déboguez localement à partir de Visual Studio, vos informations d’identification Azure enregistrées par Visual Studio sont utilisées pour accéder au compte stockage Azure. Si vous lancez votre application à partir de la ligne de commande, vous devez d’abord vous connecter à l’aide d’Azure CLI, et ces informations d’identification sont automatiquement détectées et utilisées. Toutefois, lorsque votre application est déployée sur Azure et s’exécute dans Azure, elle utilise une identité managée, sans aucune modification du code. L’authentification fonctionne dans tous les environnements d’hébergement, car les API d’identité Azure vérifient toutes les informations d’identification chaînées dans la séquence et les utilisent lorsqu’elles sont trouvées. Voir DefaultAzureCredential.

Étapes suivantes

Le stockage Azure prend en charge les blobs et les files d’attente, et d’autres fonctionnalités.

Pour savoir comment utiliser des blobs, vous pouvez passer au guide de démarrage rapide pour le stockage Blob, mais au lieu de commencer au début, accédez à Démarrage rapide avec les blobs Azure (.NET) - Exemples de code.

Pour apprendre à utiliser les files d'attente, commencez par Guide de démarrage rapide Azure Queue Storage (.NET) - Exemples de code.

Contenu connexe

• Forum Azure Storage
• Documentation d’Azure Storage