Se connecter à Azurite avec des kits de développement logiciel (SDK) et des outils

Vous pouvez vous connecter à Azurite à partir de sdk Stockage Azure ou d’outils tels que l’Explorateur Stockage Azure. L’authentification est requise et Azurite prend en charge l’autorisation avec OAuth, la clé partagée et les signatures d’accès partagé (SAP). Azurite prend également en charge l’accès anonyme aux conteneurs publics.

Cet article explique comment se connecter à l’émulateur Azurite à l’aide des kits de développement logiciel (SDK) et des outils stockage Azure. Pour plus d’informations sur l’installation et l’exécution d’Azurite, consultez Installer et exécuter Azurite. Pour en savoir plus sur l’utilisation d’Azurite avec les Kits de développement logiciel (SDK) Azure, consultez les kits de développement logiciel (SDK) Azure.

Connecter vos applications ou outils à Azurite

Pour connecter vos applications ou outils à Azurite, vous pouvez utiliser les méthodes suivantes :

Utiliser un compte de stockage et une clé connus

Azurite accepte le même compte et la clé connus utilisés par l’émulateur de stockage Azure hérité.

Nom du compte : devstoreaccount1
Clé de compte : Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Utiliser des comptes et des clés de stockage personnalisés

Azurite prend en charge les noms et clés de compte de stockage personnalisés en définissant la AZURITE_ACCOUNTS variable d’environnement au format suivant : account1:key1[:key2];account2:key1[:key2];...

Par exemple, utilisez un compte de stockage personnalisé qui a une clé :

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Note

Les clés de compte doivent être une chaîne encodée en base64.

Vous pouvez également utiliser plusieurs comptes de stockage avec deux clés chacune :

set AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"

export AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"

Azurite actualise les noms et clés de compte personnalisés de la variable d’environnement toutes les minutes par défaut. Avec cette fonctionnalité, vous pouvez faire pivoter dynamiquement la clé de compte ou ajouter de nouveaux comptes de stockage sans redémarrer Azurite.

Note

Le compte de stockage par défaut devstoreaccount1 est désactivé lorsque vous définissez des comptes de stockage personnalisés. Si vous souhaitez continuer à utiliser devstoreaccount1 après l’activation des comptes de stockage personnalisés, vous devez l’ajouter à la liste des comptes et clés personnalisés dans la AZURITE_ACCOUNTS variable d’environnement.

Les clés de compte doivent être une chaîne encodée en base64.

Utiliser les chaînes de connexion

Le moyen le plus simple de se connecter à Azurite à partir de votre application consiste à configurer une chaîne de connexion dans le fichier de configuration de votre application qui fait référence au raccourci UseDevelopmentStorage=true. Voici un exemple de chaîne de connexion dans un fichier app.config :

<appSettings>
  <add key="StorageConnectionString" value="UseDevelopmentStorage=true" />
</appSettings>

Chaînes de connexion HTTP

Vous pouvez passer les chaînes de connexion suivantes aux kits de développement logiciel (SDK) Ou outils Azure , comme Azure CLI 2.0 ou l’Explorateur Stockage.

La chaîne de connexion complète est la suivante :

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;

Pour vous connecter à un service spécifique, vous pouvez utiliser les chaînes de connexion suivantes :

Pour se connecter au stockage Blob uniquement, la chaîne de connexion est la suivante :

Chaînes de connexion HTTPS

La chaîne de connexion HTTPS complète est la suivante :

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;

Pour vous connecter à un service spécifique, vous pouvez utiliser les chaînes de connexion suivantes :

Pour utiliser le service d’objets blob uniquement, la chaîne de connexion HTTPS est la suivante :

Si vous avez utilisé dotnet dev-certs pour générer votre certificat auto-signé, utilisez la chaîne de connexion suivante.

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://localhost:10000/devstoreaccount1;QueueEndpoint=https://localhost:10001/devstoreaccount1;TableEndpoint=https://localhost:10002/devstoreaccount1;

Mettez à jour la chaîne de connexion lors de l’utilisation de comptes et de clés de stockage personnalisés.

Pour plus d’informations, consultez Configurer des chaînes de connexion stockage Azure.

Se connecter à l’aide de Kits de développement logiciel (SDK) Azure

Pour vous connecter à Azurite avec les Kits de développement logiciel (SDK) Azure, procédez comme suit :

Activez l’authentification OAuth pour Azurite via le --oauth commutateur. Pour en savoir plus, consultez la configuration OAuth.
Activez HTTPS à l’aide d’un certificat auto-signé via les options et --key/--pwd les --cert options. Pour en savoir plus sur la génération de certificats, consultez configuration de certificat (HTTPS) et configuration HTTPS.

Une fois les certificats en place, démarrez Azurite avec les options de ligne de commande suivantes :

azurite --oauth basic --cert cert-name.pem --key cert-name-key.pem

Remplacez et certname-key.pem utilisez cert-name.pem les noms de vos fichiers de certificat et de clé. Si vous utilisez un certificat PFX, utilisez l’option --pwd au lieu de l’option --key .

Pour interagir avec les ressources de stockage Blob, vous pouvez instancier un BlobContainerClient, BlobServiceClientou BlobClient.

Les exemples suivants montrent comment autoriser un BlobContainerClient objet à l’aide de trois mécanismes d’autorisation différents : DefaultAzureCredential, chaîne de connexion et clé partagée. DefaultAzureCredential fournit un mécanisme d’authentification basé sur les jetons du porteur et utilise une chaîne de types d’informations d’identification utilisés pour l’authentification. Une fois authentifiées, ces informations d’identification fournissent le jeton OAuth dans le cadre de l’instanciation du client. Pour en savoir plus, consultez la référence de classe DefaultAzureCredential.

// With container URL and DefaultAzureCredential
var client = new BlobContainerClient(
    new Uri("https://127.0.0.1:10000/devstoreaccount1/container-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new BlobContainerClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;", "container-name"
  );

// With account name and key
var client = new BlobContainerClient(
    new Uri("https://127.0.0.1:10000/devstoreaccount1/container-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Pour interagir avec les ressources de stockage file d’attente, vous pouvez instancier un QueueClient ou QueueServiceClient.

Les exemples suivants montrent comment créer et autoriser un QueueClient objet à l’aide de trois mécanismes d’autorisation différents : DefaultAzureCredential, chaîne de connexion et clé partagée. DefaultAzureCredential fournit un mécanisme d’authentification basé sur les jetons du porteur et utilise une chaîne de types d’informations d’identification utilisés pour l’authentification. Une fois authentifiées, ces informations d’identification fournissent le jeton OAuth dans le cadre de l’instanciation du client. Pour en savoir plus, consultez la référence de classe DefaultAzureCredential.

// With queue URL and DefaultAzureCredential
var client = new QueueClient(
    new Uri("https://127.0.0.1:10001/devstoreaccount1/queue-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new QueueClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;", "queue-name"
  );

// With account name and key
var client = new QueueClient(
    new Uri("https://127.0.0.1:10001/devstoreaccount1/queue-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Pour interagir avec les ressources de stockage table, vous pouvez instancier un TableClient ou TableServiceClient.

Les exemples suivants montrent comment créer et autoriser un TableClient objet à l’aide de trois mécanismes d’autorisation différents : DefaultAzureCredential, chaîne de connexion et clé partagée. DefaultAzureCredential fournit un mécanisme d’authentification basé sur les jetons du porteur et utilise une chaîne de types d’informations d’identification utilisés pour l’authentification. Une fois authentifiées, ces informations d’identification fournissent le jeton OAuth dans le cadre de l’instanciation du client. Pour en savoir plus, consultez la référence de classe DefaultAzureCredential.

// With table URL and DefaultAzureCredential
var client = new Client(
    new Uri("https://127.0.0.1:10002/devstoreaccount1/table-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new TableClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;", "table-name"
  );

// With account name and key
var client = new TableClient(
    new Uri("https://127.0.0.1:10002/devstoreaccount1/table-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Connecter l’Explorateur Stockage Azure

Vous pouvez utiliser l’Explorateur Stockage pour afficher les données stockées dans Azurite à l’aide des protocoles HTTP ou HTTPS.

Se connecter à Azurite à l’aide de HTTP

Dans l’Explorateur Stockage, connectez-vous à Azurite en procédant comme suit :

Sélectionnez l’icône Gérer les comptes
Sélectionner Ajouter un compte
Sélectionner Attacher à un émulateur local
Sélectionnez Suivant.
Modifier le champ Nom d’affichage en un nom de votre choix
Sélectionnez Suivant à nouveau
Sélectionner Se connecter

Se connecter à Azurite à l’aide du protocole HTTPS

Par défaut, l’Explorateur Stockage n’ouvre pas de point de terminaison HTTPS qui utilise un certificat auto-signé. Si vous exécutez Azurite avec HTTPS, vous utilisez probablement un certificat auto-signé. Dans l’Explorateur Stockage, importez des certificats SSL via la boîte de dialogue Modifier ->Certificats SSL ->Importer des certificats .

Importer un certificat dans l’Explorateur Stockage

Recherchez le certificat sur votre ordinateur local.
Dans l’Explorateur Stockage, accédez à Modifier ->Certificats SSL ->Importer des certificats et importer votre certificat.

Si vous n’importez pas de certificat, vous obtenez une erreur :

unable to verify the first certificate ou self signed certificate in chain

Ajouter Azurite via la chaîne de connexion HTTPS

Procédez comme suit pour ajouter Azurite HTTPS à l’Explorateur Stockage :

Sélectionner Activer/désactiver l’Explorateur
Sélectionner local &attaché
Cliquez avec le bouton droit sur Comptes de stockage , puis sélectionnez Se connecter au stockage Azure.
Sélectionner Utiliser une chaîne de connexion
Cliquez sur Suivant.
Entrez une valeur dans le champ Nom complet .
Entrez la chaîne de connexion HTTPS de la section précédente de ce document
Sélectionnez Suivant.
Sélectionner Se connecter

Étapes suivantes

Configurer des chaînes de connexion stockage Azure explique comment assembler une chaîne de connexion de stockage Azure valide.
Utilisez Azurite pour exécuter des tests automatisés décrit comment écrire des tests automatisés à l’aide de l’émulateur de stockage Azurite.
Utilisez l’émulateur de stockage Azure pour le développement et le test des documents de l’émulateur de stockage Azure hérité, qui est remplacé par Azurite.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-08-26