Menyambungkan ke Azurite dengan SDK dan alat

Anda dapat menyambungkan ke Azurite dari Azure Storage SDK, atau alat seperti Azure Storage Explorer. Autentikasi diperlukan, dan Azurite mendukung otorisasi dengan OAuth, Kunci Bersama, dan tanda tangan akses bersama (SAS). Azurite juga mendukung akses anonim ke kontainer publik.

Artikel ini menjelaskan cara menyambungkan ke emulator Azurite menggunakan SDK dan alat Azure Storage. Untuk informasi tentang cara menginstal dan menjalankan Azurite, lihat Menginstal dan menjalankan Azurite. Untuk mempelajari selengkapnya tentang menggunakan Azurite dengan Azure SDK, lihat Azure SDK.

Menyambungkan aplikasi atau alat Anda ke Azurite

Untuk menghubungkan aplikasi atau alat Anda ke Azurite, Anda dapat menggunakan metode berikut:

Menggunakan akun penyimpanan dan kunci terkenal

Azurite menerima akun dan kunci terkenal yang sama yang digunakan oleh Emulator Azure Storage warisan.

  • Nama akun: devstoreaccount1
  • Kunci akun: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Menggunakan akun dan kunci penyimpanan kustom

Azurite mendukung nama dan kunci akun penyimpanan kustom dengan mengatur AZURITE_ACCOUNTS variabel lingkungan dalam format berikut: account1:key1[:key2];account2:key1[:key2];....

Misalnya, gunakan akun penyimpanan kustom yang memiliki satu kunci:

set AZURITE_ACCOUNTS="account1:key1"
export AZURITE_ACCOUNTS="account1:key1"

Nota

Kunci akun harus berupa string yang dikodekan base64.

Atau gunakan beberapa akun penyimpanan dengan dua kunci masing-masing:

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

Azurite me-refresh nama dan kunci akun kustom dari variabel lingkungan setiap menit secara default. Dengan fitur ini, Anda dapat memutar kunci akun secara dinamis, atau menambahkan akun penyimpanan baru tanpa memulai ulang Azurite.

Nota

Akun penyimpanan default devstoreaccount1 dinonaktifkan saat Anda mengatur akun penyimpanan kustom. Jika Anda ingin terus menggunakan devstoreaccount1 setelah mengaktifkan akun penyimpanan kustom, Anda perlu menambahkannya ke daftar akun dan kunci kustom dalam AZURITE_ACCOUNTS variabel lingkungan.

Kunci akun harus berupa string yang dikodekan base64.

Gunakan string koneksi

Cara term mudah untuk terhubung ke Azurite dari aplikasi Anda adalah dengan mengonfigurasi string koneksi dalam file konfigurasi aplikasi Anda yang mereferensikan pintasan UseDevelopmentStorage=true. Berikut adalah contoh string koneksi dalam file app.config :

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

Anda dapat meneruskan string koneksi berikut ke Azure SDK atau alat, seperti Azure CLI 2.0 atau Storage Explorer.

String koneksi lengkap adalah:

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;

Untuk menyambungkan ke layanan tertentu, Anda bisa menggunakan string koneksi berikut:

Untuk menyambungkan ke Blob Storage saja, string koneksinya adalah:

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

String koneksi HTTPS

String koneksi HTTPS lengkap adalah:

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;

Untuk menyambungkan ke layanan tertentu, Anda bisa menggunakan string koneksi berikut:

Untuk menggunakan layanan blob saja, string koneksi HTTPS adalah:

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

Jika Anda terbiasa dotnet dev-certs membuat sertifikat yang ditandatangani sendiri, gunakan string koneksi berikut.

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

Perbarui string koneksi saat menggunakan akun dan kunci penyimpanan kustom.

Untuk informasi selengkapnya, lihat Mengonfigurasi string koneksi Azure Storage.

Menyambungkan menggunakan Azure SDK

Untuk menyambungkan ke Azurite dengan Azure SDK, ikuti langkah-langkah berikut:

  • Aktifkan autentikasi OAuth untuk Azurite melalui sakelar --oauth . Untuk mempelajari selengkapnya, lihat Konfigurasi OAuth.
  • Aktifkan HTTPS dengan menggunakan sertifikat yang ditandatangani sendiri melalui --cert opsi dan/--key--pwd . Untuk mempelajari selengkapnya tentang membuat sertifikat, lihat Konfigurasi sertifikat (HTTPS) dan penyiapan HTTPS.

Setelah sertifikat di tempat, mulai Azurite dengan opsi baris perintah berikut:

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

Ganti cert-name.pem dan certname-key.pem dengan nama sertifikat dan file kunci Anda. Jika Anda menggunakan sertifikat PFX, gunakan --pwd opsi alih-alih --key opsi .

Untuk berinteraksi dengan sumber daya Blob Storage, Anda dapat membuat instans BlobContainerClient, , BlobServiceClientatau BlobClient.

Contoh berikut menunjukkan cara mengotorisasi BlobContainerClient objek menggunakan tiga mekanisme otorisasi yang berbeda: DefaultAzureCredential, string koneksi, dan kunci bersama. DefaultAzureCredential menyediakan mekanisme autentikasi berbasis token Pembawa, dan menggunakan rantai jenis kredensial yang digunakan untuk autentikasi. Setelah diautentikasi, kredensial ini menyediakan token OAuth sebagai bagian dari instansiasi klien. Untuk mempelajari selengkapnya, lihat referensi kelas 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==")
  );

Menyambungkan Azure Storage Explorer

Anda dapat menggunakan Storage Explorer untuk melihat data yang disimpan di Azurite menggunakan protokol HTTP atau HTTPS.

Menyambungkan ke Azurite menggunakan HTTP

Di Storage Explorer, sambungkan ke Azurite dengan mengikuti langkah-langkah berikut:

  1. Pilih ikon Kelola Akun
  2. Pilih Tambahkan akun
  3. Pilih Lampirkan ke emulator lokal
  4. Pilih Selanjutnya
  5. Edit bidang Nama tampilan menjadi nama pilihan Anda
  6. Pilih Berikutnya lagi
  7. Pilih Sambungkan

Menyambungkan ke Azurite menggunakan HTTPS

Secara default, Storage Explorer tidak membuka titik akhir HTTPS yang menggunakan sertifikat yang ditandatangani sendiri. Jika Anda menjalankan Azurite dengan HTTPS, Kemungkinan Anda menggunakan sertifikat yang ditandatangani sendiri. Di Penjelajah Penyimpanan, impor sertifikat SSL melalui dialog Edit Sertifikat ->SSL ->Impor Sertifikat .

Impor Sertifikat ke Penjelajah Penyimpanan

  1. Temukan sertifikat di komputer lokal Anda.
  2. Di Penjelajah Penyimpanan, buka Edit Sertifikat ->SSL ->Impor Sertifikat dan impor sertifikat Anda.

Jika Anda tidak mengimpor sertifikat, Anda mendapatkan kesalahan:

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

Menambahkan Azurite melalui string koneksi HTTPS

Ikuti langkah-langkah berikut untuk menambahkan HTTPS Azurite ke Storage Explorer:

  1. Pilih Alihkan Penjelajah
  2. Pilih Lokal & Terlampir
  3. Klik kanan pada Akun Penyimpanan dan pilih Sambungkan ke Azure Storage.
  4. Pilih Gunakan string koneksi
  5. Pilih Selanjutnya.
  6. Masukkan nilai di bidang Nama tampilan.
  7. Masukkan string koneksi HTTPS dari bagian sebelumnya dari dokumen ini
  8. Pilih Selanjutnya
  9. Pilih Sambungkan

Langkah selanjutnya