어댑터 만들기

단일 인스턴스에서 최대 200개의 어댑터를 만들 수 있습니다. 각 어댑터에는 최대 200개의 인증서를 연결할 수 있습니다.

KMIP 어댑터는 Key Protect 루트 키를 사용하여 만들어집니다. 루트 키가 없는 경우, 생성 하세요.

시작하기 전에, 해당 인스턴스에서 ‘ Manager ’ 역할 또는 ‘ KmipAdapterManager ’ 역할을 보유하고 있는지 확인하십시오.

어댑터를 만들려면 다음과 같이 하세요:

1. 탐색 메뉴에서 ‘KMIP 어댑터’를 클릭합니다. 이 어댑터를 처음 사용하는 경우, 표는 비어 있습니다.

2. 작성을 클릭하십시오.

3. 측면 패널에 다음 정보를 기재하십시오:

   • 이름- 어댑터의 이름을 입력하세요(2~40자).
   • 설명 (선택 사항)- 어댑터에 대한 설명을 입력하세요(2~240자).
   • 근본 키- 이 어댑터에 사용할 근본 키를 선택합니다. 루트 키는 어댑터가 생성하는 KMIP 키를 암호화합니다. 어댑터가 정상적으로 작동하려면 루트 키가 ‘ active ’ 상태여야 합니다.

4. 선택 사항: 해당 개인 인증서 소유자가 KMIP 어댑터를 통해 Key Protect 과 통신할 수 있도록 공개 인증서( TLS )를 추가합니다. 승인된 인증서만이 해당 인스턴스에 대해 KMIP 프로토콜 요청을 보낼 수 있습니다.

   인증서를 추가하려면:

   1. 추가 를 클릭하십시오.
   2. 인증서 이름을 입력하십시오.
   3. 인증서 내용을 PEM 형식으로 입력하십시오. 이때 BEGIN CERTIFICATE 및 END CERTIFICATE 태그도 포함해야 합니다.
   4. '인증서 추가'를 클릭합니다.

   인증서 연결에는 몇 분 정도 걸릴 수 있습니다. Key Protect 리전 내에서는 하나의 인증서를 하나의 어댑터에만 연결할 수 있습니다.

KMIP 프로토콜을 통해 관리되는 리소스는 HTTP API를 통해 액세스할 수 없습니다.

업로드한 모든 인증서의 개인 키를 안전하게 보관하십시오. KMIP 어댑터에 업로드된 모든 인증서는 지원되는 모든 KMIP 작업을 수행할 수 있습니다.

어댑터 세부 정보 보기 및 업데이트

어댑터 세부 정보 패널에는 어댑터에 대한 정보가 표시되며, 여기서 인증서 추가와 같은 작업을 수행할 수 있습니다.

어댑터 세부 정보를 확인하려면:

1. 어댑터의 작업 메뉴(⋯)를 클릭하세요.
2. '상세 정보'를 선택하세요.

세부 정보 패널에는 어댑터의 이름, 설명, 관련 KMIP 대칭 키 및 업로드된 인증서가 표시됩니다. 이 패널에서 추가 인증서를 업로드할 수도 있습니다.

콘솔을 사용하여 KMIP 대칭 키를 삭제할 수 없습니다. 키를 삭제하려면 CLI 를 사용하십시오. Active 상태가 아닌 KMIP 대칭 키(상태 1)만 삭제할 수 있습니다. Active 상태의 키가 포함된 어댑터는 삭제할 수 없습니다.

각 어댑터의 리소스는 루트 키로 보호됩니다. 활성 상태이며 어댑터에 연결된 루트 키는 삭제할 수 없습니다.

생성된 각 KMIP 대칭 키는 단일 키 버전으로 간주되며, 키 버전 1개에 대한 요금이 부과됩니다. KMIP 대칭 키를 삭제하면 복구할 수 없습니다.

API에서 KMIP 어댑터 생성 및 사용

이 섹션에서는 프로필 native_1.0 의 KMIP 어댑터를 API와 함께 사용하는 방법, 즉 KMIP 클라이언트 인증서를 추가 및 제거하고 KMIP 개체를 조회 및 삭제하는 방법을 설명합니다.

다음 엔드포인트에 대해 POST 호출을 수행하여 KMIP 어댑터를 생성할 수 있습니다.

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

KMIP 클라이언트 인증서 및 KMIP 개체를 포함한 KMIP 어댑터 하위 리소스에 대한 작업은 다음 엔드포인트에서 이루어집니다:

https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/certificates
https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/kmip_objects

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

2. KMIP 어댑터를 만드는 데 사용할 루트 키의 ID를 복사합니다.

   다음 Key Protect 인스턴스의 키에 대한 ID를 키 목록을 검색하거나 Key Protect 대시보드.

3. 다음 curl 명령으로 KMIP 어댑터를 만듭니다:

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.kmip_adapter+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                   "name": "<adapter_name>",
                   "description": "<adapter_description>",
                   "profile": "native_1.0",
                   "profile_data": {
                       "crk_id": "<root_keyID_or_alias>"
                   }
                   }
               ]
           }'
   

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

4. 선택 사항: 다음 curl 명령을 사용하여 인스턴스에 존재하는 KMIP 어댑터를 나열할 수 있습니다:

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

   다음 curl 명령을 사용하여 특정 KMIP 어댑터를 가져올 수도 있습니다:

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   특정 어댑터를 가져오려면 어댑터의 UUID 또는 어댑터 이름을 사용할 수 있습니다.

5. 다음 curl 명령으로 KMIP 어댑터를 삭제할 수 있습니다:

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   어댑터 아래의 모든 KMIP 개체가 삭제된 경우에만 KMIP 어댑터를 삭제할 수 있습니다.