UI를 사용하여 키 링 작성

키 링을 작성하려면 서비스 "작성자" 또는 "관리자" 역할이 있어야 합니다.

키 링을 작성하려면 다음을 수행하십시오.

1. 왼쪽 탐색에서 키 링을 클릭하십시오.
2. 키 링 패널에서 작성 단추를 클릭하십시오.
3. 키 링 작성 탭에서 허용된 문자에 관한 지시사항에 따라 새 키 링의 이름으로 지정하십시오. 그런 다음 작성을 클릭하십시오.

새 키 링이 작성되면 키 링 목록에 표시되고 키 링에 키를 전송하거나 키를 작성할 수 있습니다.

여러 환경에서 일관되게 키링을 관리하는 경우 Key Protect 키링 모듈 또는 더 광범위한 Key Protect 올인클루시브 모듈을 사용하여 키링 및 키 레이아웃을 자동화할 수 있습니다. 자세한 내용은 테라폼 소개 IBM 모듈을 참조하세요.

API를 사용하여 키 링 작성

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

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

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

2. 다음 curl 명령을 실행하여 키 링을 작성하십시오.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

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

POST api/v2/key_rings 요청이 성공하면 HTTP 201 Created 이 응답은 키 링이 생성되었으며, 이제 표준 키와 루트 키를 저장할 수 있음을 나타냅니다.

키 링에 대한 액세스 권한 부여

IBM Cloud ( Key Protect ) 인스턴스 내의 키 링에 대한 액세스 권한은 콘솔( IAM API) 또는 CLI{ :external} 을 사용하여 부여할 수 있습니다.

역할 및 권한을 검토하여 IBM Cloud IAM 역할이 Key Protect 조치에 맵핑되는 방법을 알아보십시오.

콘솔을 사용하여 키 링에 대한 액세스 권한을 지정하려면 다음 작업을 수행하십시오.

1. 메뉴 표시줄에서 관리 > **액세스(IAM)**를 클릭하고 사용자를 선택하여 계정의 기존 사용자를 찾아보십시오.

2. 테이블 행을 선택하고 ⋯ 아이콘을 클릭하여 특정 사용자에 대한 옵션 목록을 여십시오.

3. 옵션 메뉴에서 액세스 권한 지정을 클릭하십시오.

4. 사용자 추가 액세스 지정을 클릭하십시오.

5. IAM 서비스 단추를 클릭하십시오.

6. 서비스 목록에서 다음을 선택하십시오. Key Protect.

7. 속성 기반 서비스를 선택하십시오.

8. 인스턴스 ID 속성을 선택하고 키 링이 있는 인스턴스를 선택하십시오.

9. 키 링 ID 속성을 선택한 후 키 링과 연관된 ID를 입력하십시오.

10. 사용자에 대한 액세스 권한을 지정하려면 플랫폼 및 서비스 액세스 역할의 조합을 선택하십시오.

11. 추가 를 클릭하십시오.

12. 필요에 따라 계속해서 플랫폼 및 서비스 액세스 역할을 추가하고 완료되면 지정을 클릭하십시오. 인스턴스 내에서 키 링을 나열하고, 작성 및 삭제하려면 전체 인스턴스에 대한 독자 이상의 액세스 권한이 사용자에게 지정되어야 합니다.

API를 사용하여 키 링 나열

상위 레벨 보기의 경우 다음 엔드포인트에 대한 GET 호출을 수행하여 Key Protect의 프로비저닝된 인스턴스에서 관리되는 키 링을 찾아볼 수 있습니다.

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

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

2. 다음 명령을 실행하여 키링의 일반적인 특성을 확인하세요 curl명령의 JSON 키 및 값에 대한 설명입니다.

   $ curl -X GET \ "https://<region>.kms.cloud.ibm.com/api/v2/key_rings?totalCount=<show_total>&offset=<offset_value>&limit=<offset_limit>" \
       -H "accept: application/vnd.ibm.kms.key_ring+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   물음표(?) 뒤에 오는 쿼리 매개변수는 선택적이지만, 이 매개변수의 사용을 문서화하기 위해 여기에 포함됩니다. (: :note).

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

GET api/v2/key_rings 요청에 성공하면 Key Protect 서비스 인스턴스로 가져오는 방법을 제한할 수 있습니다.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key_ring+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "default"
        },
        {
            "id": "Sample Key Ring 2",
            "creationDate": "2020-03-12T11:00:06Z",
            "createdBy": "..."
        }
    ]
}

API를 사용하여 키 링 삭제

다음 엔드포인트에 대한 DELETE 호출을 작성하여 키 링을 삭제할 수 있습니다.

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

이 조치는 키 링에 영구 삭제됨 상태가 아닌 상태의 키가 하나 이상 포함되어 있는 경우에는 실패합니다. 키 링의 유일한 키가 영구 삭제됨 상태인 경우, force=true 가 삭제 명령에 추가되면 키 링을 삭제할 수 있습니다. 해당 상태의 키는 자동으로 default 키 링으로 전송됩니다.

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

2. 삭제할 키 링의 ID를 검색하십시오.

   키 링에 대한 ID를 Key Protect 인스턴스에서 키 링의 목록을 검색하여 찾을 수 있습니다.

3. 다음 curl 명령을 실행하여 키 링을 삭제하십시오. 영구 삭제됨 상태의 키를 포함하는 경우 키 링을 강제로 삭제하는 force=true 의 존재에 유의하십시오.

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>?force=true" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "prefer: <return_preference>"
   

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

요청이 성공하면 키 링이 성공적으로 삭제되었음을 표시하는 HTTP 204 No Content 응답이 리턴됩니다.