Mit SDKs und Tools verbinden mit Azurite

Sie können eine Verbindung mit Azurite über Azure Storage-SDKs oder Tools wie Azure Storage Explorer herstellen. Die Authentifizierung ist erforderlich, und Azurite unterstützt die Autorisierung mit OAuth, Shared Key und shared access signatures (SAS). Azurite unterstützt auch anonymen Zugang zu öffentlichen Containern.

In diesem Artikel wird beschrieben, wie Sie mithilfe der Azure Storage-SDKs und -Tools eine Verbindung mit dem Azurite-Emulator herstellen. Informationen zum Installieren und Ausführen von Azurite finden Sie unter Install and run Azurite. Weitere Informationen zur Verwendung von Azurite mit den Azure-SDKs finden Sie unter Azure SDKs.

Verbinden Sie Ihre Anwendungen oder Tools mit Azurite

Um Ihre Anwendungen oder Tools mit Azurite zu verbinden, können Sie die folgenden Methoden verwenden:

Verwenden eines bekannten Speicherkontos und Schlüssels

Azurite akzeptiert dasselbe bekannte Konto und denselben Schlüssel, der vom älteren Azure Storage-Emulator verwendet wird.

Kontenbezeichnung: devstoreaccount1
Kontoschlüssel: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Verwenden von benutzerdefinierten Speicherkonten und Schlüsseln

Azurite unterstützt benutzerdefinierte Speicherkontonamen und Schlüssel, indem die AZURITE_ACCOUNTS Umgebungsvariable im folgenden Format festgelegt wird: account1:key1[:key2];account2:key1[:key2];...

Verwenden Sie beispielsweise ein benutzerdefiniertes Speicherkonto mit einem Schlüssel:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Hinweis

Die Kontoschlüssel müssen eine base64-codierte Zeichenfolge sein.

Oder verwenden Sie mehrere Speicherkonten mit jeweils zwei Schlüsseln:

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

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

Azurite aktualisiert standardmäßig benutzerdefinierte Kontonamen und Schlüssel aus der Umgebungsvariable. Mit diesem Feature können Sie den Kontoschlüssel dynamisch drehen oder neue Speicherkonten hinzufügen, ohne Azurite neu zu starten.

Hinweis

Das Standardspeicherkonto devstoreaccount1 ist deaktiviert, wenn Sie benutzerdefinierte Speicherkonten festlegen. Wenn Sie nach dem Aktivieren benutzerdefinierter Speicherkonten weiterhin verwenden devstoreaccount1 möchten, müssen Sie sie der Liste der benutzerdefinierten Konten und Schlüssel in der AZURITE_ACCOUNTS Umgebungsvariable hinzufügen.

Die Kontoschlüssel müssen eine base64-codierte Zeichenfolge sein.

Verwenden von Verbindungszeichenfolgen

Die einfachste Möglichkeit zum Herstellen einer Verbindung mit Azurite aus Ihrer Anwendung besteht darin, eine Verbindungszeichenfolge in der Konfigurationsdatei Ihrer Anwendung zu konfigurieren, die auf die Verknüpfung UseDevelopmentStorage=true verweist. Hier ist ein Beispiel für eine Verbindungszeichenfolge in einer app.config Datei:

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

HTTP-Verbindungszeichenfolgen

Sie können die folgenden Verbindungszeichenfolgen an die Azure-SDKs oder -Tools übergeben, z. B. Azure CLI 2.0 oder Speicher-Explorer.

Die vollständige Verbindungszeichenfolge lautet:

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;

Um eine Verbindung mit einem bestimmten Dienst herzustellen, können Sie die folgenden Verbindungszeichenfolgen verwenden:

Um nur eine Verbindung mit Blob Storage herzustellen, lautet die Verbindungszeichenfolge:

HTTPS-Verbindungszeichenfolgen

Die vollständige HTTPS-Verbindungszeichenfolge lautet:

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;

Um eine Verbindung mit einem bestimmten Dienst herzustellen, können Sie die folgenden Verbindungszeichenfolgen verwenden:

Um nur den BLOB-Dienst zu verwenden, lautet die HTTPS-Verbindungszeichenfolge:

Wenn Sie ihr dotnet dev-certs selbstsigniertes Zertifikat generiert haben, verwenden Sie die folgende Verbindungszeichenfolge.

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

Aktualisieren Sie die Verbindungszeichenfolge bei Verwendung von benutzerdefinierten Speicherkonten und Schlüsseln.

Weitere Informationen finden Sie unter Konfigurieren von Azure Storage-Verbindungszeichenfolgen.

Herstellen einer Verbindung mit Azure SDKs

Führen Sie die folgenden Schritte aus, um eine Verbindung mit Azurite mit den Azure-SDKs herzustellen:

Aktivieren Sie die OAuth-Authentifizierung für Azurite über den --oauth Switch. Weitere Informationen finden Sie unter OAuth-Konfiguration.
Aktivieren Sie HTTPS mithilfe eines selbstsignierten Zertifikats über die --cert optionen --key/--pwd . Weitere Informationen zum Generieren von Zertifikaten finden Sie unter Zertifikatkonfiguration (HTTPS) und HTTPS-Setup.

Nachdem die Zertifikate vorhanden sind, starten Sie Azurite mit den folgenden Befehlszeilenoptionen:

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

Ersetzen Und cert-name.pemcertname-key.pem durch die Namen Ihres Zertifikats und der Schlüsseldateien. Wenn Sie ein PFX-Zertifikat verwenden, verwenden Sie die --pwd Option anstelle der --key Option.

Um mit Blob Storage-Ressourcen zu interagieren, können Sie ein BlobContainerClient, BlobServiceClientoder BlobClient.

Die folgenden Beispiele zeigen, wie Sie ein BlobContainerClient Objekt mithilfe von drei verschiedenen Autorisierungsmechanismen autorisieren: DefaultAzureCredential, Verbindungszeichenfolge und gemeinsam genutzter Schlüssel. DefaultAzureCredential stellt einen bearer tokenbasierten Authentifizierungsmechanismus bereit und verwendet eine Kette von Anmeldeinformationstypen, die für die Authentifizierung verwendet werden. Nach der Authentifizierung stellt diese Anmeldeinformationen das OAuth-Token als Teil der Clientinstanziierung bereit. Weitere Informationen finden Sie in der DefaultAzureCredential-Klassenreferenz.

// 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==")
  );

Um mit Warteschlangenspeicherressourcen zu interagieren, können Sie ein oder .QueueClientQueueServiceClient

Die folgenden Beispiele zeigen, wie Sie ein QueueClient Objekt mithilfe von drei verschiedenen Autorisierungsmechanismen erstellen und autorisieren: DefaultAzureCredential, Verbindungszeichenfolge und gemeinsam genutzter Schlüssel. DefaultAzureCredential stellt einen bearer tokenbasierten Authentifizierungsmechanismus bereit und verwendet eine Kette von Anmeldeinformationstypen, die für die Authentifizierung verwendet werden. Nach der Authentifizierung stellt diese Anmeldeinformationen das OAuth-Token als Teil der Clientinstanziierung bereit. Weitere Informationen finden Sie in der DefaultAzureCredential-Klassenreferenz.

// 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==")
  );

Um mit Tabellenspeicherressourcen zu interagieren, können Sie ein oder .TableClientTableServiceClient

Die folgenden Beispiele zeigen, wie Sie ein TableClient Objekt mithilfe von drei verschiedenen Autorisierungsmechanismen erstellen und autorisieren: DefaultAzureCredential, Verbindungszeichenfolge und gemeinsam genutzter Schlüssel. DefaultAzureCredential stellt einen bearer tokenbasierten Authentifizierungsmechanismus bereit und verwendet eine Kette von Anmeldeinformationstypen, die für die Authentifizierung verwendet werden. Nach der Authentifizierung stellt diese Anmeldeinformationen das OAuth-Token als Teil der Clientinstanziierung bereit. Weitere Informationen finden Sie in der DefaultAzureCredential-Klassenreferenz.

// 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==")
  );

Verbinden des Azure Storage-Explorers

Sie können den Speicher-Explorer verwenden, um die in Azurite gespeicherten Daten mithilfe der HTTP- oder HTTPS-Protokolle anzuzeigen.

Herstellen einer Verbindung mit Azurite mit HTTP

Stellen Sie im Speicher-Explorer eine Verbindung mit Azurite her, indem Sie die folgenden Schritte ausführen:

Wählen Sie das Symbol " Konten verwalten " aus.
Wählen Sie "Konto hinzufügen" aus.
Wählen Sie "An einen lokalen Emulator anfügen" aus.
Wählen Sie Weiter aus.
Bearbeiten des Anzeigenamenfelds auf einen Namen Ihrer Wahl
Wählen Sie erneut "Weiter" aus.
Wählen Sie "Verbinden" aus.

Herstellen einer Verbindung mit Azurite mit HTTPS

Der Speicher-Explorer öffnet standardmäßig keinen HTTPS-Endpunkt, der ein selbstsigniertes Zertifikat verwendet. Wenn Sie Azurite mit HTTPS ausführen, verwenden Sie wahrscheinlich ein selbstsigniertes Zertifikat. Importieren Sie im Speicher-Explorer SSL-Zertifikate über das Dialogfeld "Zertifikate importieren>">.

Importieren des Zertifikats in den Speicher-Explorer

Suchen Sie das Zertifikat auf Ihrem lokalen Computer.
Wechseln Sie im Speicher-Explorer zu Edit ->SSL Certificates ->Import Certificates and import your certificate.

Wenn Sie kein Zertifikat importieren, wird eine Fehlermeldung angezeigt:

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

Hinzufügen von Azurite über HTTPS-Verbindungszeichenfolge

Führen Sie die folgenden Schritte aus, um Azurite HTTPS zum Speicher-Explorer hinzuzufügen:

Explorer umschalten
Lokal und angefügt auswählen
Klicken Sie mit der rechten Maustaste auf Speicherkonten , und wählen Sie "Mit Azure Storage verbinden" aus.
Wählen Sie "Verbindungszeichenfolge verwenden" aus.
Wählen Sie Weiteraus.
Geben Sie einen Wert in das Feld "Anzeigename " ein.
Geben Sie die HTTPS-Verbindungszeichenfolge aus dem vorherigen Abschnitt dieses Dokuments ein.
Wählen Sie Weiter aus.
Wählen Sie "Verbinden" aus.

Nächste Schritte

Konfigurieren von Azure Storage-Verbindungszeichenfolgen erläutert, wie sie eine gültige Azure Storage-Verbindungszeichenfolge zusammenstellen.
Die Verwendung von Azurite zum Ausführen automatisierter Tests beschreibt, wie automatisierte Tests mithilfe des Azurite-Speicher-Emulators geschrieben werden.
Verwenden Sie den Azure Storage-Emulator für die Entwicklung und Das Testen von Dokumenten des älteren Azure Storage-Emulators, der von Azurite abgelöst wird.

Feedback

War diese Seite hilfreich?

Last updated on 2025-08-26