웹 서비스에서 키 임포트

웹 서비스에서 키 임포트(예: 키 REST API)를 사용하여 외부 고객 키를 인스턴스에 안전하게 업로드합니다. 대칭 및 비대칭 공개 키는 모두 대상 KMF 암호화 모듈로 가져올 수 있습니다.

임포트할 키(대상 키)는 인스턴스의 대상 암호화 모듈에 업로드되기 전에 래핑 키로 암호화되어야 합니다. 이 래핑 키는 인스턴스에 있어야 하는 공개/개인 키 쌍의 공개 구성 요소입니다. 키는 웹 서비스에서 임포트를 통해 래핑된 대상 키를 업로드하기 위한 필수 조건입니다.

이 두 가지 개별 절차(래핑 키 페어 가져오기 및 웹 서비스에서 래핑된 대상 키 가져오기)는 다음 설명서에 자세히 설명되어 있습니다. 이 키 페어를 작성하고 업로드해야 인스턴스의 내부 키 임포트 암호화 모듈에서 사용할 수 있습니다.

주:

이 예제에서는 키 및 인증서 생성에 OpenSSL을 사용하고 Postman API 테스트 도구를 사용하여 REST API 사용을 보여줍니다. 회사 요구 사항에 따라 다른 유사한 도구를 대체하십시오.

키 쌍의 래핑/래핑 해제 임포트

키를 임포트하기 전에 임포트 설정을 구성합니다 핵심 관리 프레임워크 .

시작하기 전에

필요한 역할: sn_kmf.cryptographic_manager

이 태스크 정보

이 예에서는 키 및 인증서 생성에 OpenSSL을 사용합니다. 회사 요구 사항에 따라 다른 유사한 도구를 대체하십시오.

프로시저

1. 로컬 환경에서 터미널을 사용하여 인증서를 생성합니다.
   예: openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:4096 -keyout wrapping_private.key -out wrapping_public.crt

   이 인증서는 키를 포함하는 공용 구성 요소입니다. 인증서는 AES 대칭 키를 래핑하는 데 사용됩니다.

2. 로컬 환경에서 터미널을 사용하여 공용 인증서(래핑 키 포함) 및 개인 래핑 해제 키가 포함된 키 저장소를 생성합니다.
   예:openssl pkcs12 -export -in wrapping_public.crt -inkey wrapping_private.key -name "wrapping_key_alias" -out wrapping_keystore.p12
3. 인스턴스에서 다음으로 이동합니다. 모두 > 주요 운영 > 설정 임포트 > 주요 임포트 설정.
4. Algorithm Definition(알고리즘 정의) 섹션에서 Crypto Purpose (암호화 목적)가 Asymmetric Key Unwrapping(비대칭 키 래핑 해제)으로 설정되어 있는지 확인합니다.
5. 임포트한 키 스토어의 비대칭 키 자료에 맞는 적절한 알고리즘을 선택합니다.
   자세한 내용은 암호화 사양 개요 문서를 참조하십시오.
6. 다음을 선택합니다.
7. 수명 주기 정의 섹션에서 다음을 선택하여 계속합니다.
8. Key Origin(키 원본) 섹션의 Origin(원본) 필드에서 Import from PKCS12(PKCS12에서 가져오기) 또는 Import from BCFKS(BCFKS에서 가져오기)를 선택합니다.
   주:

   1단계의 예제 키 저장소를 사용하는 경우 PKCS12에서 가져오기를 선택합니다.
9. 키를 식별하기 위한 키 별칭 을 입력합니다.
   이 별칭은 업로드할 인증서 또는 키 저장소를 생성할 때 지정된 키 별칭(또는 "식별 이름")과 일치해야 합니다. 위의 예를 계속하면 wrapping_key_alias 됩니다.
10. 다음을 선택합니다.
    Key Creation 섹션에는 키 스토어를 업로드하는 대화 상자를 표시하는 Import Key 링크가 포함되어 있습니다. 예제를 계속하면 wrapping_keystore.p12가 됩니다.

웹 서비스에서 래핑된 키 임포트

웹 서비스 기능에서 키 임포트를 사용하여 래핑된 키를 암호화 모듈에 업로드합니다. 이 예제에서는 대칭 키를 사용합니다. 유사한 단계를 사용하여 비대칭 키를 가져올 수 있습니다.

시작하기 전에

필요한 역할: sn_kmf.cryptographic_manager(모듈 구성), sn_kmf.cryptographic_operator(REST 운영 기본 인증)

이 태스크 정보

KMF 키 임포트 프로세스를 완료하려면 키 엔드포인트 임포트 액세스가 필요합니다.

이 예제에서는 OpenSSL을 사용하여 키와 인증서를 생성합니다. 요구 사항에 따라 다른 유사한 도구를 대체할 수 있습니다.

프로시저

1. 로컬 장치의 터미널을 사용하여 키 임포트 모듈 공개 키 래핑 키를 사용하여 대칭 키를 래핑합니다.
   예: openssl pkeyutl -encrypt -pubin -inkey public_wrapping_key.pem -in symmetric_key.bin -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha256 -out wrapped_symmetric_key.txt
   이 예제에서는 wrapped_symmetric_key.txt라는 래핑된 키 파일을 생성합니다.
2. API에 연결할 암호화 모듈을 생성합니다.
   자세한 내용은 또는 문서를 참조하십시오.
3. 다음 선택 항목으로 암호화 사양을 추가합니다.
   • 암호화 목적: 대칭 데이터 암호화/암호 해독.
   • 키 원본: 웹 서비스에서 임포트

     자세한 내용은 또는 문서를 참조하십시오.

4. 웹 서비스 REST 엔드포인트에서 임포트하기 위해 HTTP POST 요청을 실행합니다.

   옵션	값/형식
   엔드포인트의 URL	https://<instance>/api/sn_kmf/key/import?cryptoSpecSysID=<sys_id_of_crypto_spec>.
   CryptoSpecSysID 매개변수	새로 만든 암호화 사양의 sys_id 입니다. 팁: 암호화 사양의 헤더를 마우스 오른쪽 버튼으로 클릭하여 sys_id 복사합니다.
   header-content-type	Application/octet-stream입니다.
   본문	첨부 파일 이진 파일 및 가져올 공개 키(wrapped_symmetric_key.txt)를 포함해야 합니다.
   웹 서비스 REST 엔드포인트에서 임포트	<사용자 이름/암호>의 기본 인증을 사용합니다. 주: 지정된 사용자에게 sn_kmf_cryptographic_operator 역할이 있는지 확인합니다.

   공개 키를 성공적으로 가져오면 상태가 200인 HTTP 응답 메시지가 표시됩니다.
5. 키를 대상 암호화 모듈로 성공적으로 임포트했는지 확인합니다.