Pular para o conteúdo principal

Inicializar o serviço em um ambiente não confiável

Siga estas instruções se você estiver trabalhando com o IBM Cloud ou a API REST do IBM Qiskit Runtime em um ambiente não confiável, como um computador público.

Evite executar código em uma máquina não confiável ou em um ambiente Python externo na nuvem para minimizar riscos de segurança. Se você precisar usar um ambiente não confiável (por exemplo, em um computador compartilhado ou público), altere sua chave de API após cada uso excluindo-a na página de chaves de API e criando uma nova.

cuidado

Proteja sua chave de API! Nunca inclua sua chave no código-fonte, em scripts Python ou em arquivos de notebook. Ao compartilhar código com outras pessoas, certifique-se de que sua chave de API não esteja incorporada diretamente no script Python. Em vez disso, compartilhe o script sem o token e forneça instruções para configurá-lo de forma segura.

Se você acidentalmente compartilhar sua chave com alguém ou incluí-la em um sistema de controle de versão como o Git, revogue sua chave imediatamente seguindo o tópico Excluir uma chave de API no IBM Cloud.

Encontre suas credenciais de acesso​

  1. Encontre sua chave de API (também chamada de token de API). No painel, crie sua chave de API e copie-a para um local seguro para usá-la na autenticação. O token não ficará visível novamente. Observe que você pode usar uma única chave de API para se conectar a qualquer região.
  2. Opcional: Encontre a instância que deseja usar na página Instâncias. Passe o mouse sobre o CRN dela, clique no ícone para copiá-lo e salve-o em um local seguro para usar na identificação da instância.

Autenticar no IBM Cloud em um ambiente não confiável​

Para inicializar o serviço nessa situação, use um código como o seguinte:

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

Autenticar na API REST em um ambiente não confiável​

Siga estas etapas para usar sua chave de API diretamente para autenticar na API REST do Qiskit Runtime, onde <your_API_KEY> é a API_KEY de 44 caracteres que você criou e salvou no painel inicial do IBM Quantum Platform.

  1. Use sua chave de API para gerar um bearer token. Um bearer token é uma credencial temporária que expira em no máximo uma hora. Após a expiração do token adquirido, você deve gerar um novo para continuar chamando o IBM Cloud ou outras APIs de serviço. :
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 e salve o bearer token retornado: "access_token": "<NEW_BEARER_TOKEN>"

  1. Autentique as requisições na API REST do Qiskit Runtime incluindo o CRN e o bearer token nos cabeçalhos da requisição.
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. Altere sua chave de API após cada uso gerando uma nova chave de API na página inicial do IBM Quantum Platform ou seguindo as instruções de Excluir uma chave de API no IBM Cloud.

Próximas etapas​

Recomendações