انتقل إلى المحتوى الرئيسي

تهيئة الخدمة في بيئة غير موثوقة

اتبع هذه التعليمات إذا كنت تعمل مع IBM Cloud أو IBM Qiskit Runtime REST API في بيئة غير موثوقة، مثل جهاز كمبيوتر عام.

تجنّب تنفيذ الكود على جهاز غير موثوق أو بيئة Python سحابية خارجية للحدّ من مخاطر الأمان. إذا كان لا بد من استخدام بيئة غير موثوقة (مثل جهاز مشترك أو عام)، فغيّر مفتاح API الخاص بك بعد كل استخدام عبر حذفه من صفحة مفاتيح API وإنشاء مفتاح جديد.

تنبيه

احمِ مفتاح API الخاص بك! لا تُدرج مفتاحك أبدًا في الكود المصدري أو سكريبت Python أو ملف Notebook. عند مشاركة الكود مع الآخرين، تأكد من أن مفتاح API الخاص بك غير مضمّن مباشرةً داخل سكريبت Python. بدلاً من ذلك، شارك السكريبت بدون الرمز المميز وأرفق تعليمات لإعداده بشكل آمن.

إذا شاركت مفتاحك بالخطأ مع شخص ما أو أدرجته في نظام التحكم بالإصدارات مثل Git، فأبطل مفتاحك فورًا باتباع موضوع حذف مفتاح API على IBM Cloud.

ابحث عن بيانات اعتمادك​

  1. ابحث عن مفتاح API الخاص بك (يُشار إليه أيضًا بـ API token). من لوحة التحكم، أنشئ مفتاح API الخاص بك، ثم انسخه إلى موقع آمن لتتمكن من استخدامه للمصادقة. لن يكون الرمز المميز مرئيًا مرة أخرى. لاحظ أنك تستطيع استخدام مفتاح API واحد للاتصال بأي منطقة.
  2. اختياري: ابحث عن النسخة التي تريد استخدامها من صفحة النسخ. مرّر الماوس فوق CRN الخاص بها، وانقر على الأيقونة لنسخه، ثم احفظه في موقع آمن لتتمكن من استخدامه للتعرف على النسخة.

المصادقة إلى IBM Cloud في بيئة غير موثوقة​

لتهيئة الخدمة في هذا الوضع، استخدم كودًا مثل التالي:

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>"
  )

المصادقة إلى REST API في بيئة غير موثوقة​

اتبع هذه الخطوات لاستخدام مفتاح API الخاص بك مباشرةً للمصادقة إلى Qiskit Runtime REST API، حيث <your_API_KEY> هو مفتاح API المكوّن من 44 حرفًا الذي أنشأته وحفظته من لوحة التحكم الرئيسية لـ IBM Quantum Platform.

  1. استخدم مفتاح API الخاص بك لإنشاء bearer token. bearer token هو بيانات اعتماد مؤقتة تنتهي صلاحيتها بعد ساعة على الأكثر. بعد انتهاء صلاحية الرمز المميز المكتسب، يجب إنشاء رمز جديد لمواصلة استدعاء IBM Cloud أو واجهات برمجة التطبيقات لخدمات أخرى.:
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'

انسخ واحفظ bearer token المُعاد: "access_token": "<NEW_BEARER_TOKEN>"

  1. صادق الطلبات إلى Qiskit Runtime REST API عن طريق تضمين CRN وbearer token في رؤوس الطلب.
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. غيّر مفتاح API الخاص بك بعد كل استخدام عبر إنشاء مفتاح API جديد من الصفحة الرئيسية لـ IBM Quantum Platform، أو باتباع تعليمات حذف مفتاح API على IBM Cloud.

الخطوات التالية​

توصيات