키의 복원 가능 여부를 어떻게 알 수 있습니까?

폐기된 키를 복원할 수 있는지 확인하려면 다음 작업을 수행하십시오.

1. Key Protect 콘솔에서 IBM Cloud 인스턴스를 탐색하십시오.
2. 왼쪽 탐색에서 키 화면에 있는지 확인하십시오.
3. 복원할 키를 찾으십시오. 참고: ‘삭제됨’ 상태인 키만 복원할 수 있습니다.
4. Last updated 열에서 날짜를 기록하십시오. 그런 다음 위에 있는 표 1을 참조하십시오. 지난 30일 이내에 키가 삭제된 경우 복원할 수 있습니다. 30일 이상이면 키를 복원할 수 없습니다. 더 이상 복원할 수 없는 키를 복원하려고 시도하면 키를 복원하려고 할 때 오류가 발생합니다.

콘솔로 삭제된 키 복원

그래픽 인터페이스를 사용하여 키를 복원하려는 경우 IBM Cloud 콘솔을 사용할 수 있습니다.

기존 키를 서비스로 가져온 후와 키를 삭제한 후 키를 복원하려면 다음 단계를 완료하십시오.

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

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

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

4. 키를 클릭하여 키 패널을 열고 복원할 삭제된 상태의 키를 찾으십시오. 이를 수행하는 한 가지 방법은 필터 패널을 열고 ‘키 상태’ 드롭다운 목록에서 ‘삭제됨’ 상태를 선택하는 것입니다. 그러면 결과적으로 삭제된 키만 표시됩니다.

5. ⋯ 아이콘을 클릭하여 복원하려는 키의 옵션 목록을 엽니다. 키가 삭제되어 ‘파기됨’ 상태로 전환된 경우, 키를 복원하려면 30초를 기다려야 한다는 점에 유의하십시오.

6. ‘복원’ 버튼을 클릭하면 복원 사이드 패널이 열립니다.

7. ‘복원’ 버튼을 클릭하세요.

8. 업데이트된 키 테이블에서 키가 복원되었는지 확인하십시오.

API로 삭제된 키 복원

다음 엔드포인트에 대해 POST 호출을 수행하여 이전에 가져온 키를 복원하십시오.

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

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

   키를 복원하려면 인스턴스 또는 키에 대해 관리자 역할이 있어야 합니다. IAM 역할이 Key Protect 서비스 조치에 맵핑되는 방법을 알아보려면 서비스 액세스 역할을 확인하십시오.

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

   'keys' 목록 요청을 보내거나, Key Protect 대시보드에서 키를 확인하여 지정된 키의 ID를 조회할 수 있습니다. 자세한 정보는 키 목록 보기를 확인하십시오.

3. 다음 curl 명령을 실행하여 키를 복원하고 연관된 데이터에 대한 액세스 권한을 다시 얻으십시오. 키를 복원하려면 키를 삭제한 후 30초 동안 대기해야 합니다.

   현재 또는 과거로 만료 날짜가 설정된 키를 복원할 수 없습니다.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/restore" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "x-kms-key-ring: <key_ring_ID>"
   

   표 2에 따라 예제 요청의 변수를 바꾸십시오.

A successful restore request returns an HTTP `201 Created` response, which indicates that the key was restored to the _Active_ key state and is now available for encrypt and decrypt operations. All attributes and policies that were previously associated with the key are also restored.

You will have access to data associated with the key as soon as the key is restored.
{: note}

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

{
    "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": "...",
            "description": "...",
            "tags": [
                "..."
            ],
            "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": true,
            "creationDate": "2020-03-10T20:41:27Z",
            "createdBy": "...",
            "algorithmType": "Deprecated",
            "algorithmMetadata": {
                "bitLength": "128",
                "mode": "Deprecated"
            },
            "algorithmBitSize": 128,
            "algorithmMode": "Deprecated",
            "lastUpdateDate": "2020-03-16T20:41:27Z",
            "keyVersion": {
                "id": "30372f20-d9f1-40b3-b486-a709e1932c9c",
                "creationDate": "2020-03-12T03:37:32Z"
            },
            "dualAuthDelete": {
                "enabled": false
            },
            "deleted": false
        }
    ]
}