Configuración para utilizar IBM Quantum Platform con REST API

Puede acceder a los procesadores cuánticos con las API REST, lo que le permite trabajar con las QPU utilizando cualquier lenguaje o marco de programación.

1. Obtener acceso

1. Si aún no tiene una cuenta de usuario, solicite una en la página de inicio de sesión de IBM Quantum.
2. Crea una clave API (también llamada token) en el panel de control. Tenga en cuenta que se puede utilizar la misma clave API para ambas regiones.
3. Generar un token de portador IBM Cloud Identity and Access Management (IAM). Se trata de un token de corta duración que se utiliza para autenticar las solicitudes a la API REST. Para generar una, llame a la API de servicios de identidad de IAM como se muestra en la siguiente solicitud de ejemplo:

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=MY_APIKEY'

{
   "access_token": "eyJhbGciOiJIUz......sgrKIi8hdFs",
   "refresh_token": "SPrXw5tBE3......KBQ+luWQVY=",
   "token_type": "Bearer",
   "expires_in": 3600,
   "expiration": 1473188353
}

# Use 'service' to invoke operations.
import requests
import json

url = 'https://iam.cloud.ibm.com/identity/token'
api_key = 'MY_APIKEY'
headers = {
 'Content-Type': 'application/x-www-form-urlendcoded',
}
data = f'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey={api_key}'
response = requests.post(url, headers=headers, data=data)

# Bearer token to authorize requests to the REST API
bearer_token = response.json()['access_token']

2. Elija un método de autenticación

Elija el método de autenticación adecuado en función de su entorno de trabajo:

• Cree una variable de entorno para su clave API (entornos de confianza Python )
• Utilice directamente su clave API (entorno no fiable)

Crear una variable de entorno (entorno de confianza)

1. Para establecer la variable de entorno IQP_API_TOKEN en su sistema, puede añadir la siguiente línea a su perfil de shell (por ejemplo,.bashrc o.zshrc) o estableciéndola directamente en su terminal:

   export IQP_API_TOKEN=<your-API_KEY> 
   # Use the 44-character API_KEY you created and saved 
   # from the IBM Quantum Platform Home dashboard

   Cuando invoque la variable de entorno en su código, incluya import os, como en este ejemplo:

   import os
   api_token = os.environ['IQP_API_TOKEN']

   Tenga en cuenta que al crear una variable de entorno, su clave de API se sigue almacenando localmente en texto sin formato, y debe protegerse.

2. Autentique las solicitudes a la API REST Qiskit Runtime incluyendo el CRN y el token de portador en las cabeceras de la solicitud.

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>'

3. Opcional: Configure su firewall

Si es necesario, utilice esta información para habilitar el acceso a los puntos finales de la API IBM Quantum.

Próximos pasos