Lewati ke konten utama

Inisialisasi layanan di lingkungan yang tidak tepercaya

Ikuti petunjuk ini jika kamu bekerja dengan IBM Cloud atau IBM Qiskit Runtime REST API di lingkungan yang tidak tepercaya, seperti komputer umum.

Hindari menjalankan kode di mesin yang tidak tepercaya atau lingkungan Python cloud eksternal untuk meminimalkan risiko keamanan. Jika kamu harus menggunakan lingkungan yang tidak tepercaya (misalnya, di komputer bersama atau publik), ganti API key kamu setelah setiap penggunaan dengan menghapusnya di halaman API keys dan membuat yang baru.

perhatian

Lindungi API key kamu! Jangan pernah menyertakan kunci kamu di kode sumber, skrip Python, atau file notebook. Saat berbagi kode dengan orang lain, pastikan API key kamu tidak disematkan langsung di dalam skrip Python. Sebaliknya, bagikan skrip tanpa token dan berikan petunjuk untuk mengaturnya dengan aman.

Jika kamu secara tidak sengaja berbagi kunci dengan seseorang atau menyertakannya di version control seperti Git, segera cabut kunci kamu dengan mengikuti topik Menghapus API key di IBM Cloud.

Temukan kredensial akses kamu​

  1. Temukan API key kamu (juga disebut sebagai API token). Dari dashboard, buat API key kamu, lalu salin ke lokasi yang aman agar bisa digunakan untuk autentikasi. Token tidak akan terlihat lagi. Perlu diketahui bahwa kamu bisa menggunakan satu API key untuk terhubung ke region mana pun.
  2. Opsional: Temukan instance yang ingin kamu gunakan dari halaman Instances. Arahkan kursor ke CRN-nya, klik ikon untuk menyalinnya, lalu simpan di lokasi yang aman agar bisa digunakan untuk mengidentifikasi instance.

Autentikasi ke IBM Cloud di lingkungan yang tidak tepercaya​

Untuk menginisialisasi layanan dalam situasi ini, gunakan kode seperti berikut:

from qiskit_ibm_runtime import QiskitRuntimeService

# The credentials you enter will override any saved
# account credentials that might be available locally.
service = QiskitRuntimeService(
  # Use the 44-character API_KEY you created and saved from
  # the IBM Quantum Platform dashboard, and then delete
  # the key on the API keys page after entering this code:
  token="<your-API-key>",

  # Optionally specify an instance to use
  instance="<IBM Cloud CRN or instance name>"
  )

Autentikasi ke REST API di lingkungan yang tidak tepercaya​

Ikuti langkah-langkah ini untuk menggunakan API key kamu secara langsung guna autentikasi ke Qiskit Runtime REST API, di mana <your_API_KEY> adalah API_KEY 44 karakter yang kamu buat dan simpan dari dashboard Beranda IBM Quantum Platform.

  1. Gunakan API key kamu untuk menghasilkan bearer token. Bearer token adalah kredensial sementara yang kedaluwarsa setelah maksimal satu jam. Setelah token yang diperoleh kedaluwarsa, kamu harus membuat yang baru untuk terus memanggil IBM Cloud atau API layanan lainnya. :
curl -X POST 'https://iam.cloud.ibm.com/identity/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=your_API_KEY'

Salin dan simpan bearer token yang dikembalikan: "access_token": "<NEW_BEARER_TOKEN>"

  1. Autentikasi permintaan ke Qiskit Runtime REST API dengan menyertakan CRN dan bearer token di header permintaan.
curl -X 'GET' \
   'https://quantum.cloud.ibm.com/api/v1/usage' \
   '-H accept: application/json' \
   '-H authorization: Bearer <BEARER_TOKEN>' \
   '-H Service-CRN: <INSTANCE_CRN>'
  1. Ganti API key kamu setelah setiap penggunaan dengan membuat API key baru di halaman beranda IBM Quantum Platform, atau dengan mengikuti petunjuk Menghapus API key di IBM Cloud.

Langkah selanjutnya​

Rekomendasi
Source: IBM Quantum docs — updated 12 Mar 2026
English version on doQumentation — updated 7 Mei 2026
This translation based on the English version of 11 Mar 2026