Bien démarrer avec Stockage Blob Azure et Go

Article
06/26/2024

Cet article montre comment se connecter à Stockage Blob Azure à l’aide du module client Stockage Blob Azure pour Go. Une fois la connexion établie, votre code peut opérer sur les conteneurs, les blobs et les fonctionnalités du service Stockage Blob Azure.

Documentation de référence sur les API | Code source de la bibliothèque | Package (pkg.go.dev)

Prérequis

Abonnement Azure : créez-en un gratuitement
Compte de stockage Azure : créez un compte de stockage
Go 1.18+

Configuration de votre projet

Cette section vous guide tout au long de la préparation d’un projet à utiliser avec le module client Stockage Blob Azure pour Go.

À partir de vote GOPATH, installez le module azblob à l’aide de la commande suivante :

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

Pour vous authentifier auprès de Microsoft Entra ID (recommandé), installez le module azidentity à l’aide de la commande suivante :

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

Ouvrez ensuite votre fichier de code, et ajoutez les instructions chemins d’accès d’importation nécessaires. Dans cet exemple, nous ajoutons ce qui suit à notre fichier .go :

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

Informations sur le module client de Blob :

azblob : contient les méthodes qui vous permettent d’effectuer des opérations sur le service, les conteneurs et les blobs.

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

Pour connecter une application à Stockage Blob, créez un objet client à l’aide d’azblob.NewClient. 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.

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

Vous pouvez autoriser un objet client à l’aide du jeton d’autorisation Microsoft Entra (recommandé), d’une clé d’accès au compte, ou d’une signature d’accès partagé (SAP).

Pour autoriser avec Microsoft Entra ID, vous devez utiliser un principal de sécurité. Les articles suivants fournissent des conseils sur différents scénarios d’authentification :

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 l’objet client à l’aide d’azblob.NewClient.

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

Pour utiliser un jeton de signature d’accès partagé (SAP), ajoutez le jeton à la chaîne d’URL du compte et créez l’objet client à l’aide d’azblob.NewClientWithNoCredential.

func getServiceClientSAS(accountURL string, sasToken string) *azblob.Client {
    // Create a new service client with an existing SAS token

    // Append the SAS to the account URL with a "?" delimiter
    accountURLWithSAS := fmt.Sprintf("%s?%s", accountURL, sasToken)

    client, err := azblob.NewClientWithNoCredential(accountURLWithSAS, nil)
    handleError(err)

    return client
}

Remarque

Pour les scénarios où les signatures d’accès partagé (SAP) sont utilisées, Microsoft recommande d’utiliser une SAP de délégation d’utilisateur. Une SAP de délégation d’utilisateur est sécurisée avec des informations d’identification Microsoft Entra au lieu de la clé de compte. Pour plus d’informations, consultez Accorder un accès limité aux données avec des signatures d’accès partagé (SAP).

Pour utiliser une clé partagée de compte de stockage, fournissez la clé sous forme de chaîne, puis initialisez un objet client à l’aide d’azblob.NewClientWithSharedKeyCredential.

func getServiceClientSharedKey(accountName string, accountKey string) *azblob.Client {
    // Create a new service client with shared key credential
    credential, err := azblob.NewSharedKeyCredential(accountName, accountKey)
    handleError(err)

    accountURL := fmt.Sprintf("https://%s.blob.core.windows.net", accountName)

    client, err := azblob.NewClientWithSharedKeyCredential(accountURL, credential, nil)
    handleError(err)

    return client
}

Vous pouvez également créer un objet client avec une chaîne de connexion.

func getServiceClientConnectionString(connectionString string) *azblob.Client {
    // Create a new service client with connection string
    client, err := azblob.NewClientFromConnectionString(connectionString, nil)
    handleError(err)

    return client
}

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.

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. Si vous souhaitez en savoir plus sur ces types de ressources, sur leurs liens entre eux et sur l’interaction des applications avec les ressources, veuillez consulter la rubrique Comprendre comment les applications interagissent avec les ressources de données du Stockage Blob.

Les guides suivants montrent comment utiliser des ressources de données, puis effectuer des actions spécifiques à l’aide du module client Stockage Blob Azure pour Go :

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 (conteneurs)	Gérer des métadonnées et des propriétés de conteneur.
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.
Lister des objets blob	Répertoriez les blobs de différentes façons.
Supprimer et restaurer des blobs	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 les propriétés et les métadonnées (blobs)	Gérer des métadonnées et des propriétés de conteneur.

Remarque

Les exemples de code de ce guide sont conçus pour vous aider à bien démarrer avec Stockage Blob Azure et Go. Vous devez modifier la gestion des erreurs et les valeurs Context pour répondre aux besoins de votre application.

Partage via