Csatlakozás az Azurite-hoz SDK-kkal és eszközökkel

Az Azurite-hoz azure Storage SDK-kkal vagy olyan eszközökkel csatlakozhat, mint az Azure Storage Explorer. Hitelesítésre van szükség, és az Azurite támogatja az OAuth, a megosztott kulcs és a közös hozzáférésű jogosultságkódok (SAS) használatát. Az Azurite a nyilvános tárolókhoz való névtelen hozzáférést is támogatja.

Ez a cikk bemutatja, hogyan csatlakozhat az Azurite emulátorhoz az Azure Storage SDK-k és -eszközök használatával. Az Azurite telepítéséről és futtatásáról további információt az Azurite telepítése és futtatása című témakörben talál. Az Azurite Azure SDK-kkal való használatáról további információt az Azure SDK-kban talál.

Alkalmazások vagy eszközök csatlakoztatása az Azurite-hoz

Az alkalmazások vagy eszközök az Azurite-hoz való csatlakoztatásához az alábbi módszereket használhatja:

Jól ismert tárfiók és kulcs használata

Az Azurite ugyanazt a jól ismert fiókot és kulcsot fogadja el, amelyet az örökölt Azure Storage Emulator használ.

Fiók neve: devstoreaccount1
Fiókkulcs: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Egyéni tárfiókok és kulcsok használata

Az Azurite az egyéni tárfiókok nevét és kulcsait a AZURITE_ACCOUNTS környezeti változó következő formátumban történő beállításával támogatja: account1:key1[:key2];account2:key1[:key2];....

Használjon például egy egyéni tárfiókot, amely egy kulccsal rendelkezik:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Megjegyzés:

A fiókkulcsnak base64 kódolású sztringnek kell lennie.

Vagy használjon több tárfiókot két kulccsal:

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

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

Az Azurite alapértelmezés szerint percenként frissíti az egyéni fiókneveket és -kulcsokat a környezeti változóból. Ezzel a funkcióval dinamikusan elforgathatja a fiókkulcsot, vagy új tárfiókokat vehet fel az Azurite újraindítása nélkül.

Megjegyzés:

Az egyéni tárfiókok beállításakor az alapértelmezett devstoreaccount1 tárfiók le van tiltva. Ha az egyéni tárfiókok engedélyezése után is használni devstoreaccount1 szeretné, fel kell vennie az egyéni fiókok és kulcsok listájára a AZURITE_ACCOUNTS környezeti változóban.

A fiókkulcsnak base64 kódolású sztringnek kell lennie.

Kapcsolati sztringek használata

Az Azurite-hoz az alkalmazásból való csatlakozás legegyszerűbb módja, ha konfigurál egy kapcsolati sztringet az alkalmazás konfigurációs fájljában, amely a UseDevelopmentStorage=true parancsikonra hivatkozik. Íme egy példa egy kapcsolati sztringre egy app.config fájlban:

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

HTTP-kapcsolati sztringek

Az alábbi kapcsolati sztringeket átadhatja az Azure SDK-knak vagy -eszközöknek, például az Azure CLI 2.0-nak vagy a Storage Explorernek.

A teljes kapcsolati sztring a következő:

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;

Egy adott szolgáltatáshoz való csatlakozáshoz a következő kapcsolati sztringeket használhatja:

Ha csak a Blob Storage-hoz szeretne csatlakozni, a kapcsolati sztring a következő:

HTTPS kapcsolati sztringek

A teljes HTTPS kapcsolati sztring a következő:

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;

Egy adott szolgáltatáshoz való csatlakozáshoz a következő kapcsolati sztringeket használhatja:

Ha csak a blobszolgáltatást szeretné használni, a HTTPS kapcsolati sztring a következő:

Ha önaláírt tanúsítványt hozott dotnet dev-certs létre, használja a következő kapcsolati sztringet.

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

Frissítse a kapcsolati sztringet egyéni tárfiókok és kulcsok használatakor.

További információ: Azure Storage kapcsolati sztringek konfigurálása.

Csatlakozás Azure SDK-k használatával

Ha az Azure SDK-kkal szeretne csatlakozni az Azurite-hoz, kövesse az alábbi lépéseket:

Engedélyezze az OAuth-hitelesítést az Azurite számára a --oauth kapcsolón keresztül. További információ: OAuth-konfiguráció.
Engedélyezze a HTTPS-t egy önaláírt tanúsítvány használatával a --cert lehetőségeken --key/--pwd keresztül. A tanúsítványok létrehozásával kapcsolatos további információkért tekintse meg a tanúsítványkonfigurációt (HTTPS) és a HTTPS-beállítást.

A tanúsítványok létrehozása után indítsa el az Azurite-t a következő parancssori beállításokkal:

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

Cserélje le és certname-key.pem írja be cert-name.pem a tanúsítvány és a kulcsfájlok nevét. HA PFX-tanúsítványt használ, használja a --pwd beállítást a --key beállítás helyett.

A Blob Storage-erőforrások használatához létrehozhat egy vagy BlobServiceClientBlobClienttöbb példánytBlobContainerClient.

Az alábbi példák azt mutatják be, hogyan engedélyezheti az BlobContainerClient objektumokat három különböző engedélyezési mechanizmussal: DefaultAzureCredential, kapcsolati sztring és megosztott kulcs. DefaultAzureCredential Egy tulajdonosi jogkivonat-alapú hitelesítési mechanizmust biztosít, és a hitelesítéshez használt hitelesítő adattípusok láncát használja. A hitelesítés után ez a hitelesítő adat biztosítja az OAuth-jogkivonatot az ügyfél példányosításának részeként. További információ: DefaultAzureCredential class reference.

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

A Queue Storage-erőforrások használatához példányosíthat egy QueueClient vagy QueueServiceClient.

Az alábbi példák bemutatják, hogyan hozhat létre és engedélyezhet QueueClient objektumokat három különböző engedélyezési mechanizmussal: DefaultAzureCredential, kapcsolati sztring és megosztott kulcs. DefaultAzureCredential Egy tulajdonosi jogkivonat-alapú hitelesítési mechanizmust biztosít, és a hitelesítéshez használt hitelesítő adattípusok láncát használja. A hitelesítés után ez a hitelesítő adat biztosítja az OAuth-jogkivonatot az ügyfél példányosításának részeként. További információ: DefaultAzureCredential class reference.

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

A Table Storage-erőforrások használatához létrehozhat egy TableClient vagy TableServiceClient.

Az alábbi példák bemutatják, hogyan hozhat létre és engedélyezhet TableClient objektumokat három különböző engedélyezési mechanizmussal: DefaultAzureCredential, kapcsolati sztring és megosztott kulcs. DefaultAzureCredential Egy tulajdonosi jogkivonat-alapú hitelesítési mechanizmust biztosít, és a hitelesítéshez használt hitelesítő adattípusok láncát használja. A hitelesítés után ez a hitelesítő adat biztosítja az OAuth-jogkivonatot az ügyfél példányosításának részeként. További információ: DefaultAzureCredential class reference.

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

Az Azure Storage Explorer csatlakoztatása

A Storage Explorerrel http- vagy HTTPS-protokollokkal tekintheti meg az Azurite-ban tárolt adatokat.

Csatlakozás az Azurite-hoz HTTP használatával

A Storage Explorerben az alábbi lépések végrehajtásával csatlakozzon az Azurite-hoz:

Válassza a Fiókok kezelése ikont
Válassza a Fiók hozzáadása lehetőséget
Válassza a Csatolás helyi emulátorhoz lehetőséget
Válassza a Tovább lehetőséget
A Megjelenítendő név mező szerkesztése tetszőleges névre
Válassza ismét a Tovább gombot
Válassza a Csatlakozás lehetőséget

Csatlakozás az Azurite-hoz HTTPS használatával

A Storage Explorer alapértelmezés szerint nem nyit meg önaláírt tanúsítványt használó HTTPS-végpontot. Ha HTTPS-lel futtatja az Azurite-ot, valószínűleg önaláírt tanúsítványt használ. A Storage Explorerben importálja az SSL-tanúsítványokat az -SSL-tanúsítványok>szerkesztése ->Tanúsítványok importálása párbeszédpanelen.

Tanúsítvány importálása a Storage Explorerbe

Keresse meg a tanúsítványt a helyi gépen.
A Storage Explorerben nyissa meg az -SSL-tanúsítványok> szerkesztése –>Tanúsítványok importálása és a tanúsítvány importálása lehetőséget.

Ha nem importál tanúsítványt, hibaüzenet jelenik meg:

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

Azurite hozzáadása HTTPS kapcsolati sztringen keresztül

Az alábbi lépéseket követve adja hozzá az Azurite HTTPS-t a Storage Explorerhez:

Válassza a Váltókezelő lehetőséget
Válassza a Helyi > Csatolva lehetőséget
Kattintson a jobb gombbal a Tárfiókokra , és válassza a Csatlakozás az Azure Storage-hoz lehetőséget.
Válassza a Kapcsolati sztring használata lehetőséget
Válassza a Következőlehetőséget.
Adjon meg egy értéket a Megjelenítendő név mezőben.
Adja meg a dokumentum előző szakaszából származó HTTPS kapcsolati sztringet
Válassza a Tovább lehetőséget
Válassza a Csatlakozás lehetőséget

Következő lépések

Az Azure Storage kapcsolati sztringjeinek konfigurálása bemutatja, hogyan állíthat össze érvényes Azure Storage-kapcsolati sztringet.
Az Azurite használatával automatizált teszteket futtathat , és leírja, hogyan írhat automatizált teszteket az Azurite Storage emulátor használatával.
Az Azure Storage Emulator használatával fejlesztheti és tesztelheti a régi Azure Storage Emulatort, amelyet az Azurite helyettesít.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-08-26