키 버전 보기

IBM® Key Protect for IBM Cloud®를 사용하여 루트 키와 연관된 버전을 보십시오.

루트 키를 순환할 때 Key Protect가 새 버전의 키를 작성합니다. 보안 관리자는 키 버전 히스토리를 확인하여 루트 키의 순환 히스토리를 감사할 수 있습니다.

키 버전은 루트 키에만 사용 가능합니다. Key Protect에서 키 순환이 작동하는 방식에 대해 자세히 알아보려면 키 순환 옵션 비교를 참조하십시오.

키 버전이 몇 가지입니까?

배치한 각 키의 버전 수를 확인하려면 다음을 수행하십시오.

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

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

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

  4. ‘키 ’ 패널에서 ⋯ 아이콘을 클릭한 다음 ‘세부 정보’를 선택합니다. 이렇게 하면 사이드 패널이 열리고 보유하고 있는 이 키의 버전 수가 표시됩니다.

  5. 인스턴스에 있는 키 버전의 수를 확인하려면 인스턴스의 모든 키에 대해 이 프로세스를 반복해야 합니다. 루트 키만 순환할 수 있으므로 모든 표준 키에는 하나의 버전만 있습니다.

API를 사용하여 키 버전 보기

상위 레벨 보기의 경우 다음 엔드포인트에 대한 GET 호출을 수행하여 루트 키와 연관된 버전을 나열할 수 있습니다.

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

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

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

    ID 값은 키에 대한 자세한 정보에 액세스하는 데 사용됩니다. 다음 Key Protect 인스턴스의 키에 대한 ID를 키 목록을 검색하거나 Key Protect 대시보드.

  3. 다음 curl 명령을 실행하여 루트 키와 연관된 버전 목록을 가져오십시오.

    그림과 같이 쿼리 매개변수 ?totalCount=true 를 추가할 수 있습니다. 이 매개변수는 페이지 매김에 사용할 수 있도록 응답 메타데이터에 totalCount 을 반환합니다.

    $ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/versions?totalCount=<show_total>&allKeyStates=<work_for_keys_in_any_state>" \
    -H "accept: application/vnd.ibm.kms.key.version+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "x-kms-key-ring: <key_ring_ID>" \
    -H "bluemix-instance: <instance_ID>"

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

표 1. Key Protect API로 주요 버전을 나열하는 데 필요한 변수
가변 설명
지역 필수. Key Protect 인스턴스가 상주하는 지리적 영역을 표시하는 지역 약어(예: us-south 또는 eu-gb)입니다. 자세한 정보는 지역 서비스 엔드포인트를 참조하십시오.
key_ID_or_alias 필수. 검사할 키의 고유 ID 또는 별명입니다.
IAM_token 필수. 사용자의 IBM Cloud 액세스 토큰입니다. curl 요청에 Bearer 값을 포함하여 IAM 토큰의 전체 컨텐츠를 포함하십시오. 자세한 정보는 액세스 토큰 검색을 참조하십시오.
instance_ID 필수. Key Protect 서비스 인스턴스에 지정된 고유 ID입니다. 자세한 정보는 인스턴스 ID 검색을 참조하십시오.
key_ring_ID 선택사항. 키가 속한 키 링의 고유 ID입니다. 지정되지 않은 경우 Key Protect은(는) 지정된 인스턴스와 연관된 모든 키 링에서 키를 검색합니다. 보다 최적화된 요청을 위해 키 링 ID를 지정하는 것이 좋습니다. x-kms-key-ring 헤더 없이 작성된 키의 키 링 ID는 default입니다. 자세한 정보는 키 그룹화를 참조하십시오.
show_total 선택사항. true 로 설정된 경우 allKeyStates 도 true 로 설정되지 않는 한 활성 상태의 모든 키에 대한 페이지 매김에 사용할 수 있도록 응답 메타데이터에 totalCount 을 반환합니다. 반환된 totalCount 값은 limit 및 offset을 고려하지 않고, 요청과 일치하는 키 버전의 총 개수를 나타냅니다. 기본값은 false 로 설정되어 있습니다.
allKeyStates 선택사항. true 로 설정하지 않으면 모든 비활성 키에 대해 HTTP 409가 반환됩니다.

GET api/v2/keys/<keyID_or_alias>/versions 응답에 성공하면 루트 키와 연관된 버전 목록이 리턴됩니다. 다음 JSON 오브젝트는 예제 리턴값을 표시합니다.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key.version+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "02fd6835-6001-4482-a892-13bd2085f75d",
            "creationDate": "2020-03-05T16:39:25Z"
        },
        {
            "id": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
            "creationDate": "2020-03-02T16:28:38Z"
        }
    ]
}

resources 오브젝트는 각 키 버전을 해당 ID 및 작성 날짜와 함께 역시간 순서로 나열합니다.