인스턴스의 보호된 리소스 보기

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

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

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

4. 왼쪽 사이드 메뉴에서 Associated resources 링크를 선택하십시오.

5. 연관된 리소스 페이지에서 연관된 리소스 테이블을 사용하여 서비스의 등록을 찾아보십시오.

6. ^ 열 아래의 Details 아이콘을 클릭하여 특정 등록에 대한 세부사항 목록을 보십시오.

7. 키 ID, CRN(Cloud Resource Name) 및 보존 정책별로 리소스를 필터링하려면 Filter 단추를 클릭하십시오.

키와 연관된 보호된 리소스 보기

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

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

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

4. 애플리케이션 세부사항 페이지에서 키 테이블을 사용하여 서비스에서 키를 찾아보십시오.

5. ⋯ 아이콘을 클릭하여 키에 대한 옵션 목록을 여십시오.

6. 옵션 메뉴에서 키 연관 리소스를 클릭하여 키의 연관된 등록을 보십시오.

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

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

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

1. API를 사용하여 인증 정보를 검색하십시오.

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

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>"
   

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

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

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.registration+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "keyId": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        },
        {
            "keyId": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        }
    ]
}

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

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

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

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

임의의 루트 키에 대한 등록 나열

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

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

1. API를 사용하여 인증 정보를 검색하십시오.

2. 다음 curl 명령을 실행하여 지정한 CRN 조회와 일치하는 등록을 보십시오.

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

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

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

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

CRN 조회 예제

URL 인코딩된 CRN 조회를 사용하여 Key Protect 인스턴스, 리소스 유형 또는 리소스 이름별로 등록을 필터링하십시오. CRN 세그먼트 및 형식에 대해 자세히 알아보려면 ‘클라우드 리소스 이름’을 참조하십시오.

Key Protect를 사용하여 사용자 대신에 리소스와 키를 연결하는 클라우드 서비스는 해당 서비스 CRN의 처음 8개 세그먼트와 일치하는 CRN의 조회만 보거나 조회할 수 있습니다.

• 특정 CRN 세그먼트까지 등록이 존재하는지 검색하려면 콜론 다음에 별표(*)를 사용하십시오.

  crn:v1:bluemix:public:databases-for-redis:us-south:a/
  274074dce64e9c423ffc238516c755e1:29caf0e7-120f-4da8-9551-3abf57ebcfc7:*:*
  

  이 조회는 배치 ID가 _29caf0e7-120f-4da8-9551-3abf57ebcfc7_인 모든 자원 유형 및 이름과 연관된 Redis용 데이터베이스 등록을 리턴합니다.

• <string>이(가) 접두부로 사용되는 특정 CRN 세그먼트까지 등록의 존재를 검색하려면, CRN 조회의 마지막 세그먼트에서 <string>* 뒤에 콜론을 사용하십시오.

  crn:v1:bluemix:public:cloud-object-storage:global:a/e1bb63d6a20dc57c87501ac4c4c99dcb:*:bucket:prod*
  

  이 조회는 접두부가 prod인 계정 e1bb63d6a20dc57c87501ac4c4c99dcb 내의 모든 Cloud Object Storage 버킷 등록을 리턴합니다.

어떤 루트 키와도 연관된 등록 정보를 나열할 때, CRN 쿼리의 첫 8개 세그먼트에는 별표(*)가 포함되어서는 안 됩니다.

다음 표에서는 URL 인코딩 전후의 조회 목록 예를 제공합니다. URL 인코딩 값을 보려면 URL 인코딩 탭을 클릭하십시오.