기본적으로 라우터와 메시지 프로세서 간의 TLS는 사용 중지됩니다.
라우터와 메시지 프로세서 간에 TLS 암호화를 사용 설정하려면 다음 단계를 따르세요.
- 라우터에서 메시지 프로세서의 포트 8082에 액세스할 수 있는지 확인합니다.
- TLS 인증 및 비공개 키가 포함된 키 저장소 JKS 파일을 생성합니다. 자세한 내용은 Edge 온프레미스용 TLS/SSL 구성 을 참조하세요.
- 키 저장소 JKS 파일을 메시지 프로세서 서버의 디렉터리(예:
/opt/apigee/customer/application)에 복사합니다. - JKS 파일의 권한 및 소유권을 변경합니다.
chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jks여기서
keystore.jks는 키 저장소 파일의 이름입니다. /opt/apigee/customer/application/message-processor.properties파일을 수정합니다. 파일이 없으면 파일을 만듭니다.message-processor.properties파일에서 다음 속성을 설정합니다.conf_message-processor-communication_local.http.ssl=true conf/message-processor-communication.properties+local.http.port=8443 conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks conf/message-processor-communication.properties+local.http.ssl.keystore.path=/opt/apigee/customer/application/keystore.jks conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest # Enter the obfuscated keystore password below. conf/message-processor-communication.properties+local.http.ssl.keystore.password=OBF:obsPword
여기서
keystore.jks는 키 저장소 파일이고 obsPword는 난독화된 키 저장소 및 keyalias 비밀번호입니다.참고:
값은conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
-alias옵션으로 제공된 값과 동일해야 합니다.keytool명령어에, JKS 파일 만들기 섹션의 끝에 설명된 대로.난독화된 비밀번호 생성에 관한 자세한 내용은 Edge 온프레미스용 TLS/SSL 구성을(를) 참조하세요.
message-processor.properties파일이 'apigee' 사용자가 소유하고 있는지 확인합니다.chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- 메시지 프로세서와 라우터를 중지합니다.
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop - 라우터에서
/opt/nginx/conf.d디렉터리의 파일을 삭제합니다.rm -f /opt/nginx/conf.d/*
- 메시지 프로세서와 라우터를 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
/opt/apigee/apigee-service/bin/apigee-service edge-router start - 각 메시지 프로세서에 대해 이 프로세스를 반복합니다.
라우터와 메시지 프로세서 간에 TLS가 사용 설정되면 메시지 프로세서 로그 파일
에 다음 INFO 메시지가 포함됩니다.
MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks
이 INFO 문은 라우터와 메시지
프로세서 간에 TLS가 작동하고 있음을 확인합니다.
다음 표에는
message-processor.properties에서 사용할 수 있는 모든 속성이 나와 있습니다.
| 속성 | 설명 |
|---|---|
conf_message-processor-communication_local. http.host=localhost_or_IP_address |
선택사항입니다. 라우터 연결을 리슨할 호스트 이름입니다. 이렇게 하면 등록 시 구성된 호스트 이름이 재정의됩니다. |
conf/message-processor-communication. properties+local.http.port=8998 |
선택사항입니다. 라우터 연결을 리슨할 포트입니다. 기본값은 8998입니다. |
conf_message-processor-communication_local. http.ssl=[ false | true ] |
TLS/SSL을 사용 설정하려면 이 값을 true로 설정합니다. 기본값은 false입니다. TLS/SSL을 사용 설정하면 local.http.ssl.keystore.path 및 local.http.ssl.keyalias을 설정해야 합니다.
|
conf/message-processor-communication. properties+local.http.ssl.keystore.path= |
키 저장소 (JKS 또는 PKCS12)의 로컬 파일 시스템 경로입니다.
인 경우 필수입니다local.http.ssl=true. |
conf/message-processor-communication. properties+local.http.ssl.keyalias= |
TLS/SSL 연결에 사용할 키 저장소의 키 별칭입니다.
인 경우 필수입니다local.http.ssl=true. |
conf/message-processor-communication. properties+local.http.ssl.keyalias.password= |
키 저장소 내에서 키를 암호화하는 데 사용되는 비밀번호입니다. 다음 형식으로 난독화된 비밀번호를 사용합니다.
OBF:obsPword |
conf/message-processor-communication. properties+local.http.ssl.keystore.type=jks |
키 저장소 유형입니다. 현재는 JKS와 PKCS12만 지원됩니다. 기본값은 JKS입니다. |
conf/message-processor-communication. properties+local.http.ssl.keystore.password= |
선택사항입니다. 키 저장소의 난독화된 비밀번호입니다. 다음 형식으로 난독화된 비밀번호를 사용합니다:
OBF:obsPword |
conf_message-processor-communication_local. http.ssl.ciphers=cipher1,cipher2 |
선택사항입니다. 구성된 경우 나열된 암호만 허용됩니다. 생략하면 JDK에서 지원하는 모든 암호가 사용됩니다. |