Mengautentikasi di ruang kerja Anda menggunakan kunci akses

Kunci akses digunakan untuk mengautentikasi dan mengotorisasi akses ke ruang kerja Azure Quantum Anda. Anda dapat menggunakan kunci akses untuk menyambungkan dan memberikan akses ke ruang kerja Anda menggunakan string koneksi.

Dalam artikel ini, Anda mempelajari cara mengaktifkan atau menonaktifkan kunci akses untuk ruang kerja Azure Quantum Anda. Anda juga dapat meregenerasi kunci baru untuk memastikan keamanan ruang kerja Anda.

Peringatan

Menyimpan kunci akses akun Anda atau string koneksi dalam teks yang jelas memberikan risiko keamanan dan tidak disarankan. Simpan kunci akun Anda dalam format terenkripsi, atau migrasikan aplikasi Anda untuk menggunakan otorisasi Microsoft Entra untuk akses ke ruang kerja Azure Quantum Anda.

Prasyarat

• Akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun Azure, daftarkan secara gratis dan daftar untuk langganan prabayar.

• Ruang kerja Azure Quantum. Lihat Membuat ruang kerja Azure Quantum.

• Versi terbaru paket Azure Quantum azure-quantum .

  !pip install --upgrade azure-quantum
  

• Jika Anda menggunakan Azure CLI, Anda harus memiliki versi terbaru. Untuk petunjuk penginstalan, lihat:

  • Menginstal Azure CLI di Windows
  • Memasang CLI Azure di Linux
  • Menginstal Azure CLI di macOS

Menyambungkan ke ruang kerja Azure Quantum Anda dengan string koneksi

Paket ini azure-quantum menyediakan Workspace kelas yang mewakili ruang kerja Azure Quantum. Untuk menyambungkan ke ruang kerja Azure Quantum, Anda membuat Workspace objek menggunakan string koneksi sebagai pengautentikasi. Untuk informasi selengkapnya, lihat cara menyalin string koneksi.

Saat membuat Workspace objek, Anda memiliki dua opsi untuk mengidentifikasi ruang kerja Azure Quantum Anda.

• Anda dapat membuat Workspace objek dengan memanggil from_connection_string.

  # Creating a new Workspace object from a connection string 
  from azure.quantum import Workspace 
  
  connection_string = "[Copy connection string]" 
  workspace = Workspace.from_connection_string(connection_string) 
  
  print(workspace.get_targets()) 
  

• Jika Anda tidak ingin menyalin string koneksi dalam kode, Anda juga dapat menyimpan string koneksi Anda dalam variabel lingkungan dan menggunakan Workspace().

  # Using environment variable to connect with  connection string
  
  connection_string = "[Copy connection string]" 
  
  import os 
  
  os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
  
  from azure.quantum import Workspace 
  
  workspace = Workspace() 
  print(workspace.get_targets()) 
  

Mengelola kunci akses dan string koneksi Anda

Tip

Setiap ruang kerja Azure Quantum memiliki kunci primer dan sekunder, dan string koneksi yang sesuai. Jika Anda ingin mengizinkan akses ke ruang kerja Anda kepada orang lain, Anda dapat berbagi kunci sekunder dan Anda menggunakan primer untuk layanan Anda sendiri. Dengan cara ini, Anda dapat mengganti kunci sekunder sesuai kebutuhan tanpa memiliki waktu henti di layanan Anda sendiri. Untuk informasi selengkapnya tentang berbagi akses ruang kerja Anda, lihat Berbagi akses ruang kerja Anda.

Portal Azure

Anda dapat mengelola kunci akses dan string koneksi untuk ruang kerja Azure Quantum Anda di portal Azure.

Mengaktifkan dan menonaktifkan kunci akses

1. Masuk ke portal Microsoft Azure dan pilih ruang kerja Azure Quantum Anda.

2. Di panel kiri, navigasikan ke tombol Akses Operasi>.

3. Alihkan tombol di bawah Kunci Akses ke Diaktifkan atau Dinonaktifkan.

4. Klik Simpan untuk menyimpan perubahan.

   

Penting

Saat Kunci Akses dinonaktifkan, semua permintaan yang menggunakan string koneksi atau kunci akses tidak sah. Anda masih dapat menggunakan parameter ruang kerja untuk menyambungkan ke ruang kerja Anda.

Meregenerasi kunci akses baru

Jika Anda menduga bahwa Kunci Akses Anda telah disusupi, atau Anda ingin berhenti berbagi akses ruang kerja dengan orang lain, Anda dapat meregenerasi kunci akses utama atau sekunder, atau keduanya, untuk memastikan keamanan ruang kerja Anda.

1. Masuk ke portal Microsoft Azure dan pilih ruang kerja Azure Quantum Anda.

2. Di panel kiri, navigasikan ke tombol Akses Operasi>.

3. Kunci Akses harus diaktifkan untuk meregenerasi kunci baru. Jika Kunci Akses dinonaktifkan, Anda harus mengaktifkannya terlebih dahulu.

4. Klik ikon panah melingkar untuk meregenerasi kunci primer atau sekunder.

   

Azure CLI

Anda dapat menggunakan Azure Command-Line Interface (Azure CLI) untuk mengelola kunci akses. Untuk informasi selengkapnya, lihat Mengelola ruang kerja kuantum dengan Azure CLI.

1. Tampilkan kunci akses untuk ruang kerja.

   az quantum workspace keys list 
   

2. Jika Anda menduga bahwa kunci akses Anda telah disusupi, atau Anda ingin berhenti berbagi akses ruang kerja dengan orang lain, Anda dapat meregenerasi kunci akses utama atau sekunder, atau keduanya, untuk memastikan keamanan ruang kerja Anda.

   az quantum workspace keys regenerate --key-type Primary 
   az quantum workspace keys regenerate --key-type Secondary 
   az quantum workspace keys regenerate --key-type Primary,Secondary 
   

3. Anda dapat mengaktifkan dan menonaktifkan kunci akses untuk ruang kerja.

   az quantum workspace update --enable-api-key true 
   az quantum workspace update --enable-api-key false 
   

   Penting

   Saat Kunci Akses dinonaktifkan, semua permintaan yang menggunakan string koneksi atau kunci akses tidak sah. Anda masih dapat menggunakan parameter ruang kerja untuk menyambungkan ke ruang kerja Anda.