Langkau ke kandungan utama

Mulakan perkhidmatan dalam persekitaran yang tidak dipercayai

Ikuti arahan ini jika anda bekerja dengan IBM Cloud atau IBM Qiskit Runtime REST API dalam persekitaran yang tidak dipercayai, seperti komputer awam.

Elakkan melaksanakan kod pada mesin yang tidak dipercayai atau persekitaran Python awan luaran untuk meminimumkan risiko keselamatan. Jika anda terpaksa menggunakan persekitaran yang tidak dipercayai (pada, contohnya, komputer yang dikongsi atau awam), tukar kunci API anda selepas setiap penggunaan dengan memadamnya di halaman kunci API dan mencipta yang baharu.

awas

Lindungi kunci API anda! Jangan sekali-kali menyertakan kunci anda dalam kod sumber, skrip Python, atau fail notebook. Apabila berkongsi kod dengan orang lain, pastikan kunci API anda tidak terbenam terus dalam skrip Python. Sebaliknya, kongsikan skrip tanpa token dan berikan arahan untuk menyediakannnya dengan selamat.

Jika anda secara tidak sengaja berkongsi kunci anda dengan seseorang atau menyertakannya dalam kawalan versi seperti Git, segera batalkan kunci anda dengan mengikuti topik Memadamkan kunci API di IBM Cloud.

Cari kelayakan akses anda​

  1. Cari kunci API anda (juga dirujuk sebagai token API). Dari papan pemuka, cipta kunci API anda, kemudian salinnya ke lokasi selamat supaya anda boleh menggunakannya untuk pengesahan. Token tidak akan kelihatan lagi. Perlu diambil perhatian bahawa anda boleh menggunakan satu kunci API untuk menyambung ke mana-mana rantau.
  2. Pilihan: Cari instans yang ingin anda gunakan dari halaman Instans. Arahkan kursor ke CRN-nya, klik ikon untuk menyalinnya, kemudian simpannya di lokasi selamat supaya anda boleh menggunakannya untuk mengenal pasti instans.

Sahkan ke IBM Cloud dalam persekitaran yang tidak dipercayai​

Untuk memulakan perkhidmatan dalam situasi ini, gunakan kod 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>"
  )

Sahkan ke REST API dalam persekitaran yang tidak dipercayai​

Ikuti langkah-langkah ini untuk menggunakan kunci API anda secara langsung untuk mengesahkan ke Qiskit Runtime REST API, di mana <your_API_KEY> ialah API_KEY 44 aksara yang anda cipta dan simpan dari papan pemuka IBM Quantum Platform Home anda.

  1. Guna kunci API anda untuk menjana token pembawa. Token pembawa ialah kelayakan sementara yang luput selepas tidak lebih dari satu jam. Selepas token yang diperoleh luput, anda mesti menjana yang baharu untuk terus memanggil IBM Cloud atau API perkhidmatan lain.:
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 token pembawa yang dikembalikan: "access_token": "<NEW_BEARER_TOKEN>"

  1. Sahkan permintaan ke Qiskit Runtime REST API dengan menyertakan CRN dan token pembawa dalam pengepala 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. Tukar kunci API anda selepas setiap penggunaan dengan menjana kunci API baharu di halaman utama IBM Quantum Platform, atau dengan mengikuti arahan Memadamkan kunci API di IBM Cloud.

Langkah seterusnya​

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