콘솔에서 표준 키 작성

서비스의 인스턴스를 작성한 후 다음 단계를 완료하여 IBM Cloud 콘솔에서 표준 키를 작성하십시오.

전용 Key Protect 오퍼링을 배포하는 경우 리소스를 생성하기 전에 먼저 인스턴스를 초기화해야 합니다.

Key Protect 인스턴스에 대한 이중 인증 설정 를 활성화하면, 해당 서비스에 추가된 모든 키를 삭제하려면 두 명의 사용자의 승인이 필요합니다.

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

2. 탐색 메뉴에서 ‘리소스 목록 ’으로 이동하여 보유한 리소스 목록을 확인하세요.

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

4. 새 키를 생성하려면 [ 추가 ]를 클릭하고 [키 생성 ] 옵션을 선택하십시오.

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

   키 생성 설정.

   설정	설명
   유형	Key Protect에서 관리할 키의 유형입니다. 루트 키는 기본적으로 선택됩니다. 표준 키를 작성하려면 표준 키 단추를 선택하십시오.
   키 이름	키를 쉽게 식별할 수 있도록 사람이 읽을 수 있는 표시 이름입니다. 길이는 2자에서 90자 사이여야 합니다(해당 숫자 포함). 개인정보를 보호하려면 키 이름에 사용자 이름 또는 위치와 같은 PII(Personally Identifiable Information)가 포함되지 않았는지 확인하십시오. 키 이름은 고유하지 않아도 됩니다.
   키 별명	선택사항. 키 별명은 표시 이름의 한계를 초과하여 식별하고 그룹화하는 데 사용할 수 있는 키를 설명하는 방법입니다. 키의 별명은 최대 5개일 수 있습니다.
   키 링	선택사항. 키 링은 필요한 대로 해당 그룹화를 개별적으로 관리하는 데 사용할 수 있는 키 그룹입니다. 모든 키는 키 링의 일부여야 합니다. 키 링이 선택되지 않으면 키가 default 키 링에 배치됩니다. 키 링에 작성 중인 키를 배치하려면 해당 키 링에 대한 관리자 역할이 있어야 합니다. 역할에 대한 자세한 정보는 사용자 액세스 관리를 참조하십시오.

   2. 키의 세부사항 채우기를 완료한 후 확인하려면 키 추가를 클릭하십시오.

사용할 키링을 이미 정해 두었고 해당 키링에 대한 ‘관리자’ 권한이 있다면, ‘키링’ 패널에서 바로 키를 생성할 수도 있습니다. 키링의 작업 메뉴(⋯)를 선택한 다음 ‘새 키 추가’를 클릭하세요. 이렇게 하면 ‘키’ 페이지에서 ‘추가’를 클릭했을 때와 동일한 패널이 열리며, ‘키링’ 필드에는 선택한 키링 이름이 미리 입력되어 있습니다.

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

API로 표준 키 작성

전용 Key Protect 오퍼링을 배포하는 경우 리소스를 생성하기 전에 먼저 인스턴스를 초기화해야 합니다.

다음 엔드포인트에 대한 POST 호출을 작성하여 표준 키를 작성하십시오.

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" \
       -H "x-kms-key-ring: <key_ring_ID" \
       -H "correlation-id: <correlation_ID>" \
       -H "prefer: <return_preference>" \
       -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>",
                       "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>"