Prise en main de Stockage Blob Azure et .NET

Article
10/26/2023

Cet article montre comment se connecter au Stockage Blob Azure avec la bibliothèque de client du Stockage Blob Azure pour .NET. Une fois la connexion établie, votre code peut opérer sur les conteneurs, les blobs et les fonctionnalités du service Stockage Blob Azure.

Référence API | Code source de la bibliothèque | Package (NuGet) | Échantillons | Envoyer des commentaires

Prérequis

Abonnement Azure : créez-en un gratuitement
Compte de stockage Azure : créez un compte de stockage
Dernière version du SDK .NET pour votre système d’exploitation. Veillez à disposer du Kit de développement logiciel (SDK), et non du runtime.

Configuration de votre projet

Cette section vous guide tout au long de la préparation d’un projet à utiliser avec la bibliothèque cliente Stockage Blob Azure pour .NET.

À partir du répertoire du projet, installez les packages des bibliothèques de client Stockage Blob Azure et Azure Identity à l’aide de la commande dotnet add package. Le package Azure.Identity est nécessaire pour les connexions sans mot de passe aux services Azure.

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

Ajoutez les instructions using suivantes au début de votre fichier de code.

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

Informations sur la bibliothèque de client de blob :

Azure.Storage.Blobs : contient les classes primaires (objets clients) que vous pouvez utiliser pour opérer sur le service, les conteneurs et les blobs.
Azure.Storage.Blobs.Specialized : contient des classes que vous pouvez utiliser pour effectuer des opérations spécifiques sur un type de blob comme des blobs de blocs.
Azure.Storage.Blobs.Models : ensemble des autres classes utilitaires, structures et types d’énumération.

Autoriser l’accès et la connexion au Stockage Blob

Pour connecter une application à Stockage Blob, créez une instance de la classe BlobServiceClient. Cet objet est votre point de départ pour interagir avec les ressources de données au niveau du compte de stockage. Vous pouvez l’utiliser pour opérer sur le compte de stockage et ses conteneurs. Vous pouvez également utiliser le client de service pour créer des clients de conteneurs ou des clients d’objets blob, en fonction de la ressource que vous devez utiliser.

Pour en savoir plus sur la création et la gestion d’objets clients, consultez Créer et gérer des objets clients qui interagissent avec des ressources de données.

Vous pouvez autoriser un objet BlobServiceClient en utilisant un jeton d’autorisation Microsoft Entra, une clé d’accès au compte ou une signature d’accès partagé (SAS).

Pour en savoir plus sur chacun de ces mécanismes d’autorisation, consultez Autoriser l’accès aux données dans Stockage Azure.

Pour autoriser avec Microsoft Entra ID, vous devez utiliser un principal de sécurité. Le type de principal de sécurité dont vous avez besoin dépend de l’endroit où vous exécutez votre application. Utilisez ce tableau comme guide.

Emplacement d’exécution de l’application	Principal de sécurité	Assistance
Ordinateur local (développement et test)	Principal du service	Pour découvrir comment inscrire l’application, configurer un groupe Microsoft Entra, attribuer des rôles et configurer des variables d’environnement, consultez Autoriser l’accès à l’aide de principaux de service de développeur
Ordinateur local (développement et test)	Identité de l’utilisateur	Pour découvrir comment configurer un groupe Microsoft Entra, attribuer des rôles et se connecter à Azure, consultez Autoriser l’accès à l’aide des informations d’identification du développeur
Hébergé dans Azure	Identité managée	Pour savoir comment activer une identité managée et attribuer des rôles, consultez Autoriser l’accès à partir d’applications hébergées sur Azure en utilisant une identité managée.
Hébergé en dehors d’Azure (par exemple, des applications locales)	Principal du service	Pour savoir comment inscrire l’application, attribuer des rôles et configurer des variables d’environnement, consultez Autoriser l’accès à partir d’applications locales en utilisant un principal de service d’application.

Autoriser l’accès en utilisant DefaultAzureCredential

Un moyen simple et facile d’autoriser l’accès et de se connecter au Stockage Blob consiste à obtenir un jeton OAuth en créant une instance DefaultAzureCredential. Vous pouvez ensuite utiliser ces informations d’identification pour créer un objet BlobServiceClient.

L’exemple suivant crée un objet BlobServiceClient autorisé à l’aide de DefaultAzureCredential :

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

Si vous savez exactement quel type d’informations d’identification vous allez utiliser pour authentifier les utilisateurs, vous pouvez obtenir un jeton OAuth à l’aide d’autres classes dans la bibliothèque de client Azure Identity pour .NET. Ces classes dérivent de la classe TokenCredential.

Créez un Uri à l’aide du point de terminaison du service BLOB et du jeton SAP. Créez ensuite une classe BlobServiceClient à l’aide de l’Uri.

public static void GetBlobServiceClientSAS(ref BlobServiceClient blobServiceClient,
    string accountName, string sasToken)
{
    string blobUri = "https://" + accountName + ".blob.core.windows.net";

    blobServiceClient = new BlobServiceClient
    (new Uri($"{blobUri}?{sasToken}"), null);
}

Pour en savoir plus sur la génération et la gestion des jetons SAP, consultez les articles suivants :

Créez une classe StorageSharedKeyCredential à l’aide du nom du compte de stockage et de la clé du compte. Utilisez ensuite cet objet pour initialiser une classe BlobServiceClient.

public static void GetBlobServiceClient(ref BlobServiceClient blobServiceClient,
    string accountName, string accountKey)
{
    Azure.Storage.StorageSharedKeyCredential sharedKeyCredential =
        new StorageSharedKeyCredential(accountName, accountKey);

    string blobUri = "https://" + accountName + ".blob.core.windows.net";

    blobServiceClient = new BlobServiceClient
        (new Uri(blobUri), sharedKeyCredential);
}

Vous pouvez également créer une classe BlobServiceClient à l’aide d’une chaîne de connexion.

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);

Pour plus d’informations sur la façon d’obtenir des clés de compte et découvrir les meilleures pratiques pour gérer et protéger correctement vos clés, consultez Gérer les clés d’accès au compte de stockage.

Important

La clé d’accès au compte doit être utilisée avec précaution. Si votre clé d’accès de compte est perdue ou accidentellement placée dans un emplacement non sécurisé, votre service peut devenir vulnérable. Toute personne disposant de la clé d’accès est en mesure d’autoriser les demandes sur le compte de stockage et a accès efficacement à toutes les données. DefaultAzureCredential offre des avantages et des fonctionnalités de sécurité améliorées, et est l’approche recommandée pour la gestion de l’autorisation auprès des services Azure.

Pour en savoir plus sur chacun de ces mécanismes d’autorisation, consultez Autoriser l’accès aux données dans Stockage Azure.

Générer votre application

Quand vous créez des applications pour utiliser des ressources de données dans Stockage Blob Azure, votre code interagit principalement avec trois types de ressources : comptes de stockage, conteneurs et objets blob. Pour en savoir plus sur ces types de ressources, leur relation entre elles et la façon dont les applications interagissent avec les ressources, consultez Comprendre comment les applications interagissent avec les ressources de données du Stockage Blob.

Les guides suivants vous montrent comment utiliser des ressources de données et effectuer des actions spécifiques à l’aide de la bibliothèque de client Stockage Azure pour .NET :

Guide	Description
Créer un conteneur	Créez des conteneurs.
Supprimer et restaurer des conteneurs	Supprimez des conteneurs et, si la suppression réversible est activée, restaurez des conteneurs supprimés.
Lister des conteneurs	Répertoriez les conteneurs dans un compte et les différentes options disponibles pour personnaliser une liste.
Gérer les propriétés et les métadonnées	Obtenez et définissez les propriétés et les métadonnées pour des conteneurs.
Créer et gérer des baux de conteneur	Établissez et gérez un verrou sur un conteneur.
Créer et gérer des baux de blob	Établissez et gérez un verrou sur un blob.
Ajouter des données à des blobs	Découvrez comment créer un blob d’ajout, puis ajouter des données à ce blob.
Charger des objets blob	Découvrez comment charger des blobs à l’aide de chaînes, de flux, de chemins d’accès de fichiers et d’autres méthodes.
Télécharger des objets blob	Téléchargez des blobs à l’aide de chaînes, de flux et de chemins d’accès de fichiers.
Copier des objets blob	Copiez un blob d’un emplacement à un autre.
Lister des objets blob	Répertoriez les blobs de différentes façons.
Supprimer et restaurer	Supprimez des blobs et, si la suppression réversible est activée, restaurez des blobs supprimés.
Rechercher des blobs à l’aide d’étiquettes	Définissez et récupérez des étiquettes, puis utilisez-les pour rechercher des objets blob.
Gérer des propriétés et des métadonnées	Obtenez et définissez des propriétés et des métadonnées pour des blobs.
Définissez le niveau d’accès d’un blob	Définissez ou modifiez le niveau d’accès d’un objet blob de blocs.