Udostępnij przez

Nawiązywanie połączenia z usługą Azurite przy użyciu zestawów SDK i narzędzi

Możesz nawiązać połączenie z usługą Azurite z poziomu zestawów SDK usługi Azure Storage lub narzędzi, takich jak Eksplorator usługi Azure Storage. Uwierzytelnianie jest wymagane, a Azurite obsługuje autoryzację za pomocą protokołu OAuth, klucza współdzielonego i sygnatur dostępu współdzielonego (SAS). Usługa Azurite obsługuje również anonimowy dostęp do kontenerów publicznych.

W tym artykule opisano sposób nawiązywania połączenia z emulatorem usługi Azurite przy użyciu zestawów SDK i narzędzi usługi Azure Storage. Aby uzyskać informacje na temat sposobu instalowania i uruchamiania rozwiązania Azurite, zobacz Instalowanie i uruchamianie rozwiązania Azurite. Aby dowiedzieć się więcej na temat używania platformy Azurite z zestawami SDK platformy Azure, zobacz Zestawy SDK platformy Azure.

Łączenie aplikacji lub narzędzi z usługą Azurite

Aby połączyć aplikacje lub narzędzia z usługą Azurite, możesz użyć następujących metod:

Używanie dobrze znanego konta magazynu i klucza

Usługa Azurite akceptuje to samo dobrze znane konto i klucz używany przez starszy emulator usługi Azure Storage.

  • Nazwa konta: devstoreaccount1
  • Klucz konta: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Używanie niestandardowych kont magazynu i kluczy

Usługa Azurite obsługuje niestandardowe nazwy i klucze kont magazynu, ustawiając zmienną AZURITE_ACCOUNTS środowiskową w następującym formacie: account1:key1[:key2];account2:key1[:key2];....

Na przykład użyj niestandardowego konta magazynu, które ma jeden klucz:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Uwaga / Notatka

Klucze konta muszą być ciągiem zakodowanym w formacie base64.

Możesz też użyć wielu kont magazynu z dwoma kluczami:

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

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

Usługa Azurite domyślnie odświeża niestandardowe nazwy kont i klucze ze zmiennej środowiskowej co minutę. Dzięki tej funkcji można dynamicznie obracać klucz konta lub dodawać nowe konta magazynu bez ponownego uruchamiania usługi Azurite.

Uwaga / Notatka

Domyślne devstoreaccount1 konto magazynu jest wyłączone podczas ustawiania niestandardowych kont magazynu. Jeśli chcesz nadal używać devstoreaccount1 po włączeniu niestandardowych kont magazynu, musisz dodać je do listy niestandardowych kont i kluczy w zmiennej środowiskowej AZURITE_ACCOUNTS .

Klucze konta muszą być ciągiem zakodowanym w formacie base64.

Używanie parametrów połączenia

Najprostszym sposobem nawiązania połączenia z usługą Azurite z aplikacji jest skonfigurowanie parametrów połączenia w pliku konfiguracji aplikacji, który odwołuje się do skrótu UseDevelopmentStorage=true. Oto przykład parametrów połączenia w pliku app.config :

<appSettings>
  <add key="StorageConnectionString" value="UseDevelopmentStorage=true" />
</appSettings>
Parametry połączenia HTTP

Następujące parametry połączenia można przekazać do zestawów SDK platformy Azure lub narzędzi, takich jak interfejs wiersza polecenia platformy Azure 2.0 lub Eksplorator usługi Storage.

Pełne parametry połączenia to:

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;

Aby nawiązać połączenie z określoną usługą, możesz użyć następujących parametrów połączenia:

Aby nawiązać połączenie tylko z usługą Blob Storage, parametry połączenia to:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;

Parametry połączenia HTTPS

Pełne parametry połączenia HTTPS to:

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;

Aby nawiązać połączenie z określoną usługą, możesz użyć następujących parametrów połączenia:

Aby używać tylko usługi blob, parametry połączenia HTTPS to:

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;

Jeśli użyto dotnet dev-certs polecenia do wygenerowania certyfikatu z podpisem własnym, użyj następujących parametrów połączenia.

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

Zaktualizuj parametry połączenia podczas korzystania z niestandardowych kont magazynu i kluczy.

Aby uzyskać więcej informacji, zobacz Konfigurowanie parametrów połączenia usługi Azure Storage.

Nawiązywanie połączenia przy użyciu zestawów SDK platformy Azure

Aby nawiązać połączenie z usługą Azurite przy użyciu zestawów SDK platformy Azure, wykonaj następujące kroki:

Po utworzeniu certyfikatów uruchom usługę Azurite przy użyciu następujących opcji wiersza polecenia:

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

Zastąp cert-name.pem wartości i certname-key.pem nazwami certyfikatów i plików kluczy. Jeśli używasz certyfikatu PFX, użyj --pwd opcji zamiast --key opcji .

Aby wchodzić w interakcje z zasobami usługi Blob Storage, możesz utworzyć wystąpienie obiektu BlobContainerClient, BlobServiceClientlub BlobClient.

W poniższych przykładach pokazano, jak autoryzować BlobContainerClient obiekt przy użyciu trzech różnych mechanizmów autoryzacji: DefaultAzureCredential, parametry połączenia i klucz wspólny. DefaultAzureCredential udostępnia mechanizm uwierzytelniania oparty na tokenach elementu nośnego i używa łańcucha typów poświadczeń używanych do uwierzytelniania. Po uwierzytelnieniu to poświadczenie udostępnia token OAuth w ramach wystąpienia klienta. Aby dowiedzieć się więcej, zobacz dokumentację klasy 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==")
  );

Łączenie Eksploratora usługi Azure Storage

Eksplorator usługi Storage umożliwia wyświetlanie danych przechowywanych w usłudze Azurite przy użyciu protokołów HTTP lub HTTPS.

Nawiązywanie połączenia z usługą Azurite przy użyciu protokołu HTTP

W Eksploratorze usługi Storage połącz się z usługą Azurite, wykonując następujące kroki:

  1. Wybierz ikonę Zarządzaj kontami
  2. Wybierz pozycję Dodaj konto
  3. Wybierz pozycję Dołącz do emulatora lokalnego
  4. Wybierz Dalej
  5. Edytuj pole Nazwa wyświetlana , aby wybrać nazwę
  6. Ponownie wybierz pozycję Dalej
  7. Wybierz pozycję Połącz

Nawiązywanie połączenia z usługą Azurite przy użyciu protokołu HTTPS

Domyślnie Eksplorator usługi Storage nie otwiera punktu końcowego HTTPS korzystającego z certyfikatu z podpisem własnym. Jeśli korzystasz z usługi Azurite z protokołem HTTPS, prawdopodobnie używasz certyfikatu z podpisem własnym. W Eksploratorze usługi Storage zaimportuj certyfikaty SSL za pośrednictwem okna dialogowego Edytowanie certyfikatów> SSL ->Importowanie certyfikatów.

Importowanie certyfikatu do Eksploratora usługi Storage

  1. Znajdź certyfikat na komputerze lokalnym.
  2. W Eksploratorze usługi Storage przejdź do pozycji Edytuj ->CERTYFIKATY SSL ->Importuj certyfikaty i zaimportuj certyfikat.

Jeśli nie zaimportujesz certyfikatu, wystąpi błąd:

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

Dodawanie usługi Azurite za pośrednictwem parametrów połączenia HTTPS

Wykonaj następujące kroki, aby dodać protokół Azurite HTTPS do Eksploratora usługi Storage:

  1. Wybierz pozycję Przełącz Eksploratora
  2. Wybierz pozycję Lokalne i dołączone
  3. Kliknij prawym przyciskiem myszy pozycję Konta magazynu i wybierz pozycję Połącz z usługą Azure Storage.
  4. Wybierz pozycję Użyj parametrów połączenia
  5. Wybierz Dalej.
  6. Wprowadź wartość w polu Nazwa wyświetlana .
  7. Wprowadź parametry połączenia HTTPS z poprzedniej sekcji tego dokumentu
  8. Wybierz Dalej
  9. Wybierz pozycję Połącz

Dalsze kroki

  • Last updated on