콘솔을 사용하여 루트 키 가져오기

서비스 인스턴스를 작성한 후 IBM Cloud 콘솔을 사용하여 키를 가져오려면 다음 단계를 완료하십시오.

Key Protect 인스턴스에 대한 이중 권한 부여 설정을 사용으로 설정하는 경우 서비스에 추가한 키를 삭제하려면 두 사용자의 권한이 필요함에 유의하십시오.

1. IBM Cloud 콘솔에 로그인하세요.

2. 메뉴 > 리소스 목록으로 이동하여 리소스 목록을 보십시오.

3. IBM Cloud 리소스 목록에서 Key Protect의 프로비저닝된 인스턴스를 선택하십시오.

4. 키를 가져오려면 ‘추가’를 클릭하고 ‘키 가져오기 ’ 창을 선택하십시오.

   키의 세부사항을 지정하십시오.

키의 세부 정보를 모두 입력한 후 ‘추가’를 클릭하여 확인하십시오.

특정 키 링의 관리자 라면, ‘키 링 ’ 패널에서 직접 키를 추가할 수 있습니다. 키링의 동작 메뉴(⋯)에서 ‘새 키 추가’를 클릭하세요. ‘키’ 페이지에서 ‘추가’를 클릭했을 때와 동일한 패널이 열리지만, ‘키링’ 필드에는 선택한 키링 이름이 미리 입력되어 있습니다.

여러 계정이나 환경에서 일관되게 루트 키를 가져오고 관리해야 하는 경우 Key Protect 키 모듈을 사용하여 이 작업을 자동화할 수 있습니다. Key Protect 인스턴스와 키 링을 프로비저닝하는 전체 설정은 모든 것이 포함된 Key Protect 모듈을 참조하세요. 개요는 Terraform IBM 모듈을 참조하세요.

API를 사용하여 루트 키 가져오기

다음 엔드포인트에 대한 POST 호출을 작성하여 대칭 키를 Key Protect로 가져오십시오.

https://<region>.kms.cloud.ibm.com/api/v2/keys

1. 서비스 및 인증용 인증 정보를 검색하여 서비스에서 키에 대한 작업을 수행하십시오.

2. 다음 curl 명령을 사용하여 Key Protect API 를 호출하십시오.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.key+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                       "type": "application/vnd.ibm.kms.key+json",
                       "name": "<key_name>",
                       "aliases": [alias_list],
                       "description": "<key_description>",
                       "expirationDate": "<expiration_date>",
                       "payload": "<key_material>",
                       "extractable": <key_type>
                   }
               ]
           }'
   

   다음 표에 따라 예제 요청의 변수를 대체하십시오.

개인 데이터의 기밀성을 보호하려면 서비스에 키를 추가할 때 사용자 이름 또는 위치와 같은 PII(Personally Identifiable Information)를 입력하지 않도록 하십시오.

성공한 POST api/v2/keys 응답은 기타 메타데이터와 함께 키의 ID 값을 리턴합니다. ID는 키에 지정되어 있으며 Key Protect API에 대한 후속 호출에 사용되는 고유 ID입니다.

선택사항: Key Protect 인스턴스에서 키를 찾아보기 위해 다음 호출을 실행하여 키가 추가되었는지 확인하십시오.

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"