루트 키와 연관되어 있는 보호된 리소스 보기

1. UI에 로그인하십시오.

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

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

4. KMS 키 페이지에서 키 테이블을 사용하여 서비스에서 키를 찾아보십시오.

5. 보호된 특정 루트 키 자원을 확인하려면 조치 아이콘 을 클릭하여 키에 대한 옵션 목록을 열고 연관된 자원 보기를 선택하여 해당 키로 보호되는 모든 자원을 탐색하십시오.

   표 2. 연관된 자원을 보는 테이블을 설명합니다.

   컬럼	설명
   Resource name	키와 연관된 Cloud Object Storage 버킷과 같은 클라우드 리소스의 이름입니다.
   Service name	리소스가 상주하는 IBM Cloud 서비스 인스턴스의 이름입니다.
   Retention policy	클라우드 리소스에 보존 정책이 있는지 여부를 표시합니다. 값이 True이면 보존 정책은 클라우드 리소스에 사용으로 설정되고 클라우드 리소스와 연관된 키는 삭제할 수 없습니다. 값이 False이면 보존 정책은 사용으로 설정되지 않습니다.

6. 각 리소스의 세부사항을 보려면 Resource name 열의 아래의 캐럿(^) 아이콘을 클릭하여 리소스 세부사항을 펼치십시오.

   다음 표에서는 등록 세부사항에 대해 설명합니다.

   표 3. 자원과 연관된 특성에 대해 설명합니다.

   필드	설명
   Created	리소스가 처음 키와 연관된 날짜 및 시간입니다.
   Last updated	등록이 업데이트된 날짜 및 시간입니다.
   Description	등록에 대한 설명입니다.
   Key version ID	클라우드 리소스를 보호하는 루트 키의 버전입니다.
   Key version date	루트 키 버전이 업데이트된 날짜 및 시간입니다.
   Cloud resource name	CRN (Cloud Resource Name), version, cname, ctype 등을 포함하여 키와 연관된 클라우드 자원을 나타냅니다.

검색 필드를 사용하여 자원 이름 또는 키 버전 ID로 루트 키와 연관된 자원을 검색할 수 있습니다.

인스턴스에서 리소스 보기

1. UI에 로그인하십시오.

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

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

4. KMS 연관 리소스 페이지에서 키 관리 서비스 연관 리소스 테이블을 사용하여 서비스에서 등록을 탐색하십시오.

   표 4. 연관된 자원 테이블을 설명합니다.

   컬럼	설명
   Resource name	키와 연관된 Cloud Object Storage 버킷과 같은 클라우드 리소스의 이름입니다.
   Key name	지정된 클라우드 리소스와 연관된 루트 키를 식별하는 사용자가 읽을 수 있는 이름입니다.
   Key ID	지정된 클라우드 리소스와 연관된 루트 키를 식별하는 ID입니다.
   Service name	리소스가 상주하는 IBM Cloud 서비스 인스턴스의 이름입니다.
   Retention policy	클라우드 리소스를 지울 수 있는지 여부를 표시합니다. 값이 Enabled인 경우 클라우드 리소스를 지울 수 없으며 클라우드 리소스와 연관된 키도 삭제할 수 없습니다. 값이 Disabled인 경우 클라우드 리소스를 지울 수 있습니다. 필요에 따라 클라우드 리소스와 연관된 키를 삭제할 수 있습니다.

5. Resource name 열 아래의 캐럿(^) 아이콘을 클릭하여 특정 등록에 대한 세부사항의 목록을 보십시오.

   다음 표에서는 등록 세부사항에 대해 설명합니다.

   표 5. 자원과 연관된 특성에 대해 설명합니다.

   필드	설명
   Created	리소스가 처음 키와 연관된 날짜 및 시간입니다.
   Last updated	등록이 업데이트된 날짜 및 시간입니다.
   Description	등록에 대한 설명입니다.
   Key version ID	클라우드 리소스를 보호하는 루트 키의 버전입니다.
   Key version date	루트 키 버전이 업데이트된 날짜 및 시간입니다.
   Cloud resource name	CRN (Cloud Resource Name), version, cname, ctype 등을 포함하여 키와 연관된 클라우드 자원을 나타냅니다.

리소스 검색 외에도, 리소스 이름, 키 ID 및 보존 정책별로 리소스를 찾아볼 수 있습니다. 이를 수행하려면 Filter 단추를 클릭하고, 목록에서 필터 옵션을 선택하고, 적용을 클릭하십시오.

API로 특정 루트 키에 대한 등록 나열

다음 엔드포인트에 대한 GET 호출을 수행하여 특정 루트 키와 연관된 등록 세부사항을 검색할 수 있습니다.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations

1. 인증용 인증 정보를 검색하여 API에 대한 작업을 수행하십시오.

2. 다음 cURL 명령을 실행하여 루트 키와 연관된 등록을 보십시오.

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

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

   표 7. 루트 키와 연관된 모든 등록을 나열하는 데 필요한 변수를 설명합니다.

   가변	설명
   region	필수입니다. Hyper Protect Crypto Services 인스턴스가 상주하는 지리적 영역을 나타내는 지역 약어 (예: us-south 또는 eu-de) 입니다. 자세한 정보는 지역 서비스 엔드포인트를 참조하십시오.
   port	필수입니다. API 엔드포인트의 포트 번호입니다.
   IAM_token	필수입니다. 사용자의 IBM Cloud 액세스 토큰입니다. cURL 요청에 Bearer 값 등 IAM 토큰의 전체 컨텐츠를 포함하십시오. 자세한 정보는 액세스 토큰 검색을 참조하십시오.
   instance_ID	필수입니다. Hyper Protect Crypto Services 서비스 인스턴스에 지정된 고유 ID입니다. 자세한 정보는 인스턴스 ID 검색을 참조하십시오.

   성공적인 GET api/v2/keys/<key_ID>/registrations 요청에서는 지정된 키 ID에 맵핑된 등록 콜렉션이 리턴됩니다.

   {
     "metadata": {
         "collectionType": "application/vnd.ibm.kms.registration+json",
         "collectionTotal": 2
     },
     "resources": [
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       },
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       }
     ]
   }
   

   resourceCrn 값은 keyId로 암호화되는 클라우드 리소스의 고유 ID를 표시합니다. 등록과 연관된 메타데이터(예: 작성 날짜)도 응답 본문에서 리턴됩니다.

   기본적으로 GET api/v2/keys/registrations는 처음 200개의 등록을 리턴하지만 조회 시 limit 매개변수를 사용하여 이 한계를 조정할 수 있습니다.

API로 루트 키에 대한 등록 나열

다음 엔드포인트에 대한 GET 호출을 수행하여 클라우드 리소스와 연관된 등록 목록을 검색할 수도 있습니다.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query>

1. 인증용 인증 정보를 검색하여 API에 대한 작업을 수행하십시오.

2. 다음 cURL 명령을 실행하여 지정된 CRN 조회와 일치하는 등록을 확인하십시오.

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query> \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

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

   표 8. CRN 조회별로 등록을 나열하는 데 필요한 변수를 설명합니다.

   가변	설명
   region	필수입니다. Hyper Protect Crypto Services 인스턴스가 상주하는 지리적 영역을 나타내는 지역 약어 (예: us-south 또는 eu-de) 입니다. 자세한 정보는 지역 서비스 엔드포인트를 참조하십시오.
   port	필수입니다. API 엔드포인트의 포트 번호입니다.
   url_encoded_CRN_query	URL 인코딩 와일드카드 문자 (*) 를 사용하여 지정된 클라우드 자원 이름(CRN) 과 연관된 자원을 필터링합니다. 매개변수는 모든 CRN 세그먼트를 포함해야 하며 URL 인코딩되어야 합니다. 예를 보려면 CRN 조회 예제를 참조하십시오.
   IAM_token	필수입니다. 사용자의 IBM Cloud 액세스 토큰입니다. cURL 요청에 Bearer 값 등 IAM 토큰의 전체 컨텐츠를 포함하십시오. 자세한 정보는 액세스 토큰 검색을 참조하십시오.
   instance_ID	필수입니다. Hyper Protect Crypto Services 서비스 인스턴스에 지정된 고유 ID입니다. 자세한 정보는 인스턴스 ID 검색을 참조하십시오.