Aller au contenu principal

Initialiser le service dans un environnement non fiable

Suis ces instructions si tu travailles avec IBM Cloud ou l'API REST IBM Qiskit Runtime dans un environnement non fiable, comme un ordinateur public.

Évite d'exécuter du code sur une machine non fiable ou dans un environnement cloud Python externe afin de minimiser les risques de sécurité. Si tu dois utiliser un environnement non fiable (par exemple, sur un ordinateur partagé ou public), change ta clé API après chaque utilisation en la supprimant sur la page des clés API et en en créant une nouvelle.

attention

Protège ta clé API ! N'inclus jamais ta clé dans du code source, un script Python ou un fichier notebook. Lorsque tu partages du code avec d'autres personnes, assure-toi que ta clé API n'est pas intégrée directement dans le script Python. À la place, partage le script sans le token et fournis des instructions pour le configurer de manière sécurisée.

Si tu partages accidentellement ta clé avec quelqu'un ou si tu l'inclus dans un système de contrôle de version comme Git, révoque immédiatement ta clé en suivant la rubrique Suppression d'une clé API sur IBM Cloud.

Trouver tes identifiants d'accès​

  1. Trouve ta clé API (également appelée token API). Depuis le tableau de bord, crée ta clé API, puis copie-la dans un endroit sécurisé afin de pouvoir l'utiliser pour l'authentification. Le token ne sera plus visible ensuite. Note que tu peux utiliser une seule clé API pour te connecter à n'importe quelle région.
  2. Facultatif : Trouve l'instance que tu souhaites utiliser depuis la page Instances. Passe la souris sur son CRN, clique sur l'icône pour le copier, puis enregistre-le dans un endroit sécurisé afin de pouvoir l'utiliser pour identifier l'instance.

S'authentifier auprès d'IBM Cloud dans un environnement non fiable​

Pour initialiser le service dans cette situation, utilise un code similaire à celui-ci :

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

S'authentifier auprès de l'API REST dans un environnement non fiable​

Suis ces étapes pour utiliser ta clé API directement afin de t'authentifier auprès de l'API REST Qiskit Runtime, où <your_API_KEY> est la clé API_KEY de 44 caractères que tu as créée et enregistrée depuis ton tableau de bord d'accueil IBM Quantum Platform.

  1. Utilise ta clé API pour générer un bearer token. Un bearer token est un identifiant temporaire qui expire après une heure au maximum. Une fois le token acquis expiré, tu dois en générer un nouveau pour continuer à appeler IBM Cloud ou d'autres API de service. :
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'

Copie et enregistre le bearer token retourné : "access_token": "<NEW_BEARER_TOKEN>"

  1. Authentifie les requêtes vers l'API REST Qiskit Runtime en incluant le CRN et le bearer token dans les en-têtes de la requête.
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. Change ta clé API après chaque utilisation en générant une nouvelle clé API sur la page d'accueil d'IBM Quantum Platform, ou en suivant les instructions Suppression d'une clé API sur IBM Cloud.

Prochaines étapes​

Recommandations