SSL에 대한 키 저장소 구성

키 저장소 구성을 사용하여 WebSphere® Application Server의 런타임이 SSL(Secure Sockets Layer) 구성에 대한 키 저장소 유형을 로드 및 관리하는 방법을 정의하십시오.

기본적으로 java.security.Security.getAlgorithms("KeyStore") 속성은 관리 콘솔에 사전 정의된 키 저장소 유형 목록을 표시하지 않습니다. 그 대신에 WebSphere Application Server는 java.security.KeyStore 오브젝트가 참조할 수 있는 모든 KeyStore 유형을 검색하며, 여기에는 하드웨어 비밀번호, z/OS® 플랫폼, IBM® i 플랫폼, IBM Java™ Cryptography Extension(IBMJCE) 및 Java 기반 CMS(Certificate Management Services) 제공자 키 저장소가 포함됩니다. java.security 파일에 키 저장소 제공자를 지정하거나 이를 제공자 목록에 프로그래밍 방식으로 추가하는 경우, WebSphere Application Sever는 사용자 정의 키 저장소도 검색합니다. 검색 목록은 해당 프로세스 및 프로세스의 java.security 구성에 따라 다릅니다.

IBMJCE 파일 기반 키 저장소(JCEKS, JKS, PKCS12)

일반 IBMJCE 파일 기반 키 저장소 구성이 다음 샘플 코드에 표시됩니다.
<keyStores xmi:id="KeyStore_1" name="NodeDefaultKeyStore" 
password="{xor}349dkckdd=" provider="IBMJCE"
location="${USER_INSTALL_ROOT}/config/cells/myhostNode01Cell
/nodes/myhostNode01/key.p12" type="PKCS12" fileBased="true" 
hostList="" initializeAtStartup="true" readOnly="false" 
description="Default key store for myhostNode01" usage="SSLKeys" 
managementScope="ManagementScope_1"/>
기본 키 저장소 구성에 대한 자세한 정보는 SSL의 기본 체인 인증서 구성의 내용을 참조하십시오.
테이블 1은 샘플 코드에 사용되는 속성을 설명합니다.
표 1. 키 저장소 구성. 이 테이블은 키 저장소 구성을 설명합니다.
속성 이름 Default 설명
xmi:id 다름 구성의 다른 영역에서 키 저장소 참조를 위해 발생되는 값으로 예를 들어, SSL 구성입니다. 이 값이 security.xml 파일에서 고유해야 합니다.
이름 Java Secure Socket Extension(JSSE) 키 저장소: NodeDefaultKeyStore. JSSE 신뢰 저장소: NodeDefaultTrustStore. 보는 것으로 키 저장소를 식별하는 데 사용되는 이름. 이름은 키 저장소가 이름이 DefaultKeyStore 또는 DefaultTrustStore로 끝나는지 여부에 따라 기본 키 저장소인지를 판별할 수 있습니다.
비밀번호 기본 키 저장소 비밀번호는 WebAS입니다. 이는 가능한 빨리 변경되도록 권장합니다. 자세한 정보는 스크립트를 사용하여 기본 키 저장소 비밀번호 업데이트의 내용을 참조하십시오. 키 저장소 이름 액세스에 사용하는 비밀번호는 키 저장소 내에 키를 저장하는 데 사용하는 기본값입니다.
설명 기본값 없음 키 저장소의 설명입니다.
사용법 키 저장소가 사용되는 용도를 지정하는 속성. 유효한 값: SSLKeys, KeySetKeys, RootKeys, DeletedKeys, DefaultSigners, RSATokenKeys.
provider 기본 제공자는 IBMJCE입니다. 유형 속성을 구현하는 Java 제공자입니다(예: PKCS12 유형). 제공자는 지정 가능하며 지정된 키 저장소 유형을 구현하는 첫 번째 제공자가 사용됩니다.
location 기본값은 다르지만 일반적으로 구성 저장소의 노드 또는 셀 디렉토리에서 key.p12 파일이나 trust.p12 파일을 참조합니다. 이 파일은 PKCS12 유형의 키 저장소입니다. 키 저장소 위치 참조. 키 저장소가 파일 기반인 경우, 위치는 키 저장소가 있는 노드의 파일 시스템의 모든 경로를 참조할 수 있습니다. 그렇지만 위치가 구성 저장소 밖이고 관리 콘솔이나 wsadamin 유틸리티에서 키 저장소를 원격으로 관리하려는 경우, 상주하는 노드의 호스트 이름이 포함된 hostList 속성을 지정하십시오.
유형 기본 Java 비밀번호 사용 디바이스 키 저장소 유형은 PKCS12입니다. 이 유형은 키 저장소를 지정합니다. 유효한 유형은 java.security.Security.getAlgorithms("KeyStore") 속성으로 리턴되는 유형입니다. 이 유형에는 다음과 같은 키 저장소 유형이 포함되며 가용성은 프로세스 및 플랫폼 java.security 구성에 따라 다릅니다.
  • JKS
  • JCEKS
  • PKCS12
  • PKCS11 (Java 비밀번호 사용 디바이스)
  • CMSKS
  • IBMi5OSKeyStore
  • JCERACFKS
  • JCECCAKS 키 저장소(JCE4758KS 대체) - (z/OS 비밀번호 사용 디바이스)
fileBased 기본값은 true입니다. 이 옵션은 기본 키 저장소에 필요합니다. 이는 파일 시스템 키 저장소를 표시하기 때문에 키 저장소 로드 및 저장에 FileInputStream 또는 FileOutputStream을 사용할 수 있습니다.
hostList hostList 속성은 키 저장소의 원격 관리가 가능하도록 원격 호스트 이름을 지정하는 데 사용됩니다. 기본적으로 원격으로 관리되는 키 저장소는 없습니다. 모든 기본 키 저장소는 구성 저장소에서 로컬로 관리되고 각 노드에 동기화됩니다. 옵션은 키 저장소를 원격으로 관리합니다. 키 저장소에 대해 유효한 노드의 호스트 이름을 설정할 수 있습니다. 관리 콘솔 또는 wsadmin 유틸리티를 사용하여 이 키 저장소의 인증서를 관리하는 경우 MBean 호출이 승인된 조작에 대한 키 저장소가 있는 노드에 대해 작성됩니다. 키 저장소 동기화 조작이 보장되지는 않지만 여러 개의 호스트를 지정할 수는 있습니다. 예를 들어, 나열된 호스트 중 하나는 특정 조작 수행 시 중지되었을 수 있습니다. 따라서 이 목록의 다중 호스트를 사용하십시오.
initializeAtStartup 기본값은 true입니다. 이 옵션은 런타임에 시작 중 키 저장소 초기화를 지시합니다. 이 옵션은 하드웨어 비밀번호 사용 디바이스 가속화에 중요할 수 있습니다.
readOnly 기본값은 false입니다. 이 옵션은 이 키 저장소에 기록할 수 없는 구성을 통지합니다. 즉, 키 저장소의 특정 업데이트 조작은 시도할 수 없으며 허용되지 않습니다. 읽기 전용 키 저장소 유형의 예는 z/OS 플랫폼의 JCERACFKS입니다. 이 유형은 WebSphere 인증서 관리 관점에서 읽기 전용이지만 RACF®에 대한 키 저장소 관리 기능을 사용해서도 업데이트할 수 있습니다.
managementScope 기본 범위는 기본 애플리케이션 서버 환경의 노드 범위 및 네트워크 배치 환경의 셀 범위입니다. 이 옵션은 이 키 저장소를 볼 수 있는 특정 관리 범위를 참조합니다. 예를 들어, 하드웨어 비밀번호 사용 디바이스가 실제로 특정 노드에 있는 경우 보안 > 보안 통신 > SSL 구성에서 토폴로지 보기에 해당 노드에 대한 링크에서 키 저장소를 작성하십시오. 관리 범위를 사용하여 키 저장소 참조를 분리할 수도 있습니다. 어떤 경우에는 특정 애플리케이션 서버만 키 저장소를 참조하도록 허용해야 할 수도 있습니다. 관리 범위는 해당 특정 서버의 범위입니다.

CMS 키 저장소

일부 제공자 특정 속성을 CMS 키 저장소에 설정할 수 있습니다.

[AIX Solaris HP-UX Linux Windows]CMSKS 제공자가 createStashFileForCMS 속성을 지원하고 속성을 CMSKS 키 저장소에 대해 true로 설정하는 경우 WebSphere Application Server는 .sth 파일을 속성에 참조하는 키 저장소 위치에 작성합니다. .sth 확장자가 키 저장소 이름에 추가됩니다. 예를 들어, CMSKS 키 저장소가 플러그인 구성에서 사용 가능하고 createStashFileForCMS를 true로 설정하는 경우, 다음 샘플 코드에서 표시되는 숨김 파일은 ${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01/nodes/myhostNode01/servers/webserver1/plugin-key.sth 경로에 작성됩니다.
<keyStores xmi:id="KeyStore_1132071489571" name="CMSKeyStore" 
password="{xor}HRYNFAtrbxEwOzpvbhw6MzM=" provider="IBMCMSProvider" 
location="${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01
/nodes/myhostNode01/servers/webserver1/plugin-key.kdb" type="CMSKS"
fileBased="true" createStashFileForCMS="true"
managementScope="ManagementScope_1132071489569"/>
다음 샘플 코드에 표시되는 것처럼 CMS 키 저장소를 작성하는 경우 CMS 제공자는 IBMi5OSJSSEProvider이고 CMS 유형은 IBMi5OSKeyStore입니다.
<keyStores xmi:id="KeyStore_1132071489571" name="CMSKeyStore" 
password="{xor}HRYNFAtrbxEwOzpvbhw6MzM=" provider="IBMi5OSJSSEProvider" 
location="${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01
/nodes/myhostNode01/servers/webserver1/plugin-key.kdb" type="IBMi5OSKeyStore"
fileBased="true" createStashFileForCMS="true" 
managementScope="ManagementScope_1132071489569"/>
[IBM i]참고: IBM i 키 저장소 유형 IBMi5OSKeyStore는 .sth 비밀번호 숨김 파일을 인식 또는 생성하지 않습니다. 대신, 작성된 .kdb 키 저장소의 비밀번호 내부 레코드를 보존합니다. .kdb 파일이 이동되는 경우 비밀번호는 더 이상 키 저장소와 연관되지 않습니다. 이 경우, 디지털 서명 관리자(DCM)는 .kdb 키 저장소 파일에 대한 비밀번호의 내부 레코드를 다시 작성하는 데 사용되어야 합니다. 자세한 정보는 .kdb 키 저장소 내부 비밀번호 레코드 재작성의 내용을 참조하십시오.
[IBM i]주의: 체인된 개인 인증서를 작성하거나 IBMi5OSKeyStore로 requestCACertificate 태스크를 사용하는 경우, IBMi5OSJSSEProvider에서 체인의 각 파트에 대한 서명자가 새 인증서 작성 전에 키 저장소에 있도록 요청합니다. 따라서, 인증서를 작성하기 전에 서명자를 IBMi5OSKeyStore 키 저장소에 가져와야 합니다.

하드웨어 비밀번호 키 저장소

비밀번호를 사용하는 디바이스 구성인 경우 암호화 사용을 위한 키 관리의 내용을 참조하십시오.

사용자 정의 특성 com.ibm.ssl.keyStoreSlot 또는 구성 속성 slot="0"으로 슬롯을 추가해야 합니다. 사용자 정의 특성은 역호환성을 위해 속성 전에 읽습니다.


주제 유형을 표시하는 아이콘 개념 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=csec_sslkeystoreconfs
파일 이름:csec_sslkeystoreconfs.html