선택사항: 키 순환 검증

목록 키 요청을 실행하여 키가 순환되었는지 확인할 수 있습니다.

$ 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>"

여기서 <instance_ID>은(는) 인스턴스의 이름이고 <IAM_token>은(는) IAM 토큰입니다.

응답 엔티티-본문에 있는 lastRotateDate 및 keyVersion 값을 검토하여 키가 마지막으로 순환된 날짜 및 시간을 검사하십시오.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key+json",
        "collectionTotal": 1
    },
    "resources": [
        {
            "type": "application/vnd.ibm.kms.key+json",
            "id": "02fd6835-6001-4482-a892-13bd2085f75d",
            "name": "test-root-key",
            "state": 1,
            "extractable": false,
            "crn": "crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:12e8c9c2-a162-472d-b7d6-8b9a86b815a6:key:02fd6835-6001-4482-a892-13bd2085f75d",
            "imported": false,
            "creationDate": "2020-03-12T03:50:12Z",
            "createdBy": "...",
            "algorithmType": "Deprecated",
            "algorithmMetadata": {
                "bitLength": "256",
                "mode": "Deprecated"
            },
            "algorithmBitSize": 256,
            "algorithmMode": "Deprecated",
            "lastUpdateDate": "2020-03-12T03:50:12Z",
            "lastRotateDate": "2020-03-12T03:49:01Z",
            "keyVersion": {
                "id": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
                "creationDate": "2020-03-12T03:50:12Z"
            },
            "dualAuthDelete": {
                "enabled": false
            },
            "deleted": false
        }
    ]
}

keyVersion 속성에는 최신 루트 키 버전에 대해 설명하는 식별 정보가 포함되어 있습니다.

다음 항목을 사용하여 키에 사용 가능한 버전을 나열할 수도 있습니다. Key Protect API. 자세히 알아보려면 키 버전 보기를 참조하십시오.

가져오기 토큰을 사용하여 키 순환

초기에 가져오기 토큰을 사용하여 루트 키를 가져온 경우 다음 엔드포인트에 대한 POST 호출을 수행하여 키를 순환할 수 있습니다.

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

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

   키를 순환시키려면 인스턴스 또는 키에 대한 작성자 또는 관리자 액세스 정책이 지정되어 있어야 합니다. IAM 역할을 Key Protect 서비스 조치에 맵핑하는 방법을 알아보려면, 서비스 액세스 역할을 확인하십시오.

2. 순환할 키의 ID를 검색하십시오.

   지정된 키에 대한 ID를 검색하기 위해 GET /v2/keys 요청을 통해, 또는 Key Protect 대시보드로 이동합니다.

3. 가져오기 토큰을 작성 및 검색하십시오.

4. 가져오기 토큰을 사용하여 기존 키를 순환하는 데 사용할 키 자료를 암호화하십시오.

   가져오기 토큰을 사용하는 방법에 대해 알아보려면 튜토리얼: 암호화 키 작성 및 가져오기를 확인하십시오.

5. 다음 명령을 실행하여 기존 키를 새로운 키 자료로 교체하십시오 curl명령의 JSON 키 및 값에 대한 설명입니다.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/actions/rotate" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -d '{
               "type": "application/vnd.ibm.kms.key+json",
               "name": "<key_alias>",
               "description": "<key_description>",
               "extractable": <key_type>,
               "payload": "<encrypted_key>",
               "encryptionAlgorithm": "RSAES_OAEP_SHA_256",
               "encryptedNonce": "<encrypted_nonce>",
               "iv": "<iv>"
           }'
   

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

성공한 순환 요청은 루트 키가 새 키 자료로 바뀌었음을 표시하는 HTTP 204 No Content 응답을 리턴합니다.

선택사항: 가져오기 토큰 키 순환 검증

키 메타데이터 가져오기 요청을 실행하여 가져오기 토큰을 통해 가져온 키가 순환되었는지 확인할 수 있습니다.

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

여기서 <keyID_or_alias>은(는) 키의 ID 또는 별명이고, <instance_ID>은(는) 인스턴스의 이름이며, <IAM_token>은(는) IAM 토큰입니다.

응답 엔티티-본문에 있는 lastRotateDate 및 keyVersion 값을 검토하여 키가 마지막으로 순환된 날짜 및 시간을 검사하십시오.

다음 항목을 사용하여 키에 사용 가능한 버전을 나열할 수도 있습니다. Key Protect API. 자세히 알아보려면 키 버전 보기를 참조하십시오.