신뢰할 수 없는 환경에서 서비스 초기화
공용 컴퓨터와 같이 신뢰할 수 없 는 환경에서 IBM Cloud 또는 IBM Qiskit Runtime REST API를 사용하는 경우 이 지침을 따르세요.
보안 위험을 최소화하기 위해 신뢰할 수 없는 기기나 외부 클라우드 Python 환경에서 코드를 실행하지 마세요. 신뢰할 수 없는 환경(예: 공유 컴퓨터 또는 공용 컴퓨터)을 반드시 사용해야 한다면, API 키 페이지에서 API 키를 삭제하고 새로운 키를 생성하여 사용 후마다 API 키를 변경하세요.
주의
API 키를 보호하세요! 소스 코드, Python 스크립트 또는 노트북 파일에 키를 절대 포함하지 마세요. 다른 사람과 코드를 공유할 때는 API 키가 Python 스크립트에 직접 포함되지 않도록 하세요. 대신 토큰 없이 스크립트를 공유하고, 안전하게 설정하는 방법에 대한 안내를 별도로 제공하세요.
실수로 키를 다른 사람과 공유하거나 Git과 같은 버전 관리 시스템에 포함한 경우, IBM Cloud의 API 키 삭제 항목에 따라 즉시 키를 취소하세요.
액세스 자격 증명 찾기
- API 키(_API 토큰_이라고도 함)를 찾으세요. 대시보드에서 API 키를 생성한 후, 인증에 사용할 수 있도록 안전한 위치에 복사해 두세요. 토큰은 이후에 다시 확인할 수 없습니다. 단일 API 키로 모든 지역에 연결할 수 있다는 점을 참고하세요.
- 선택 사항: 인스턴스 페이지에서 사용할 인스턴스를 찾으세요. 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 인증
다음 단계에 따라 Qiskit Runtime REST API에 API 키로 직접 인증하세요. 여기서 <your_API_KEY>는 IBM Quantum Platform 홈 대시보드에서 생성하고 저장한 44자리 API_KEY입니다.
- API 키를 사용하여 bearer 토큰을 생성하세요. _bearer 토큰_은 최대 1시간 후에 만료되는 임시 자격 증명입니다. 취득한 토큰이 만료되면 IBM Cloud 또는 다른 서비스 API를 계속 호출하려면 새 토큰을 생성해야 합니다.
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 토큰을 복사하여 저장하세요: "access_token": "<NEW_BEARER_TOKEN>"
- 요청 헤더에 CRN과 bearer 토큰을 포함하여 Qiskit Runtime REST API 요청을 인증하세요.
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>'
- IBM Quantum Platform 홈 페이지에서 새 API 키를 생성하거나, IBM Cloud의 API 키 삭제 안내에 따라 사용 후마다 API 키를 변경하세요.
다음 단계
권장 사항
- 사용 가능한 플랜 개요.
- Qiskit SDK를 로컬에서 구성하세요.
- Hello world의 단계에 따라 양자 프로그램을 작성하고 실행하세요.
- 튜토리얼을 시도해 보세요.