이 섹션에서는 RHEL 8에서 FIPS 모드를 사용 설정하여 프라이빗 클라우드용 Edge 버전 4.53.00 이상의 안전하고 규정을 준수하는 환경을 보장하는 방법을 안내합니다.
사전 설치
Edge 설치 개요 문서에 나열된 다른 표준 구성 기본 요건과 함께 노드에서 FIPS가 사용 설정되어 있는지 확인합니다.
fips-mode-setup --check FIPS mode is enabled. # Command output
FIPS 모드가 현재 사용 중지되어 있는 경우 공식 Red Hat 문서에서 사용 설정 방법에 대한 안내를 참조하세요. RHEL 8을 FIPS 모드로 전환
자바 요구사항
사용하는 Java는 Red Hat 저장소에서 다운로드해야 합니다. 그래야 보안 모듈이 FIPS를 준수하고 Java 보안을 통해 FIPS 관련 제한사항을 사용 설정할 수 있습니다.
설치
Edge 구성 파일 참조에서 각 노드에 FIPS_OS=true를 설정합니다. 평소와 같이 프라이빗 클라우드용 Edge의 일반 설치 단계를 따르면 됩니다.
비공개 키 형식
PKCS12/PFX 형식만 사용하여 API 프록시 또는 가상 호스트에서 사용할 비공개 키를 Apigee 키 저장소에 업로드할 수 있습니다. 파일을 만드는 방법에 관한 안내는 인증서를 지원되는 형식으로 변환을 참고하세요.
일반 TLS 작업
FIPS 지원 RHEL 8.X에서 프라이빗 클라우드용 Edge 4.53.00 이상을 사용하는 경우 Edge의 대부분의 TLS 관련 구성요소 구성은 PKCS12 또는 BCFKS 형식 키 저장소를 통해 수행해야 합니다.
자세한 내용은 TLS 구성 관련 도움말의 FIPS 관련 문서 또는 메모를 참고하세요. 부록에는 이러한 키 저장소를 생성하는 데 사용할 수 있는 몇 가지 유용한 명령어가 나와 있습니다.
기본 Java 키 저장소/트러스트 저장소
FIPS 지원 RHEL 8.X에서 프라이빗 클라우드용 Edge 4.53.00을 사용하는 경우 메시지 프로세서, 관리 서버, 기타 edge-* 구성요소는 기본적으로 제품과 함께 제공되는 자리표시자 BCFKS 키 저장소 및 트러스트 저장소(/opt/apigee/edge-gateway/vault/bcfks-cacerts)를 가리킵니다.
자체 BCFKS cacerts 저장소를 생성하고 이를 사용하도록 Edge 구성요소를 구성하려면 다음 단계를 따르세요.
-
신뢰하려는 모든 CA 인증서가 포함된 자체 BCFKS 형식
cacerts파일을 생성합니다. 키 저장소 비밀번호와 키 비밀번호가 동일한지 확인합니다(엄격한 BCFIPS 비밀번호 검사가 적용되는 경우 14자 이상).-
옵션 A: 호스트 OS 또는 JDK
cacerts저장소를 BCFKS 형식으로 변환합니다(update-ca-trust에서 관리하는 표준 OS 신뢰할 수 있는 루트 CA를 포함하려는 경우 권장).BC_FIPS_JAR=$(ls /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-*.jar \ | head -n 1)keytool -J-Dcom.redhat.fips=false -importkeystore \ -srckeystore /etc/pki/java/cacerts \ -srcstoretype JKS \ -srcstorepass changeit \ -destkeystore my-cacerts.bcfks \ -deststoretype BCFKS \ -deststorepass YOUR_STORE_PASSWORD \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider \ -providername BCFIPS \ -providerpath "$BC_FIPS_JAR" \ -noprompt -
옵션 B: 커스텀 CA 인증서(
.pem또는.crt)를 사용하여 새 BCFKS 저장소를 만들거나 기존 BCFKS 저장소(예: 옵션 A의my-cacerts.bcfks)에 추가 커스텀 CA 인증서를 가져옵니다.BC_FIPS_JAR=$(ls /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-*.jar \ | head -n 1)keytool -J-Dcom.redhat.fips=false -importcert \ -file PATH_TO_CA_CERT.pem \ -alias CA_ALIAS \ -keystore my-cacerts.bcfks \ -storetype BCFKS \ -storepass YOUR_STORE_PASSWORD \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider \ -providername BCFIPS \ -providerpath "$BC_FIPS_JAR" \ -noprompt -
선택사항: BCFKS 저장소의 콘텐츠를 확인합니다.
BC_FIPS_JAR=$(ls /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-*.jar \ | head -n 1)keytool -J-Dcom.redhat.fips=false -list \ -keystore my-cacerts.bcfks \ -storetype BCFKS \ -storepass YOUR_STORE_PASSWORD \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider \ -providername BCFIPS \ -providerpath "$BC_FIPS_JAR"
-
-
3단계에 나열된 Edge 구성요소를 실행하는 각 노드에서 BCFKS 파일을 적절한 경로에 복사하고
apigee사용자가 읽을 수 있는지 확인합니다.cp my-cacerts.bcfks /opt/apigee/customer/application/my-cacerts.bcfkschown apigee:apigee /opt/apigee/customer/application/my-cacerts.bcfkschmod 600 /opt/apigee/customer/application/my-cacerts.bcfks -
각 노드에서 다음 표에 있는 설치된 각 구성요소의 구성 파일을 만들거나 수정합니다(노드에 나열된 각 구성요소에 대해 3~6단계 반복).
구성요소 파일 edge-management-server/opt/apigee/customer/application/management-server.propertiesedge-message-processor/opt/apigee/customer/application/message-processor.propertiesedge-router/opt/apigee/customer/application/router.propertiesedge-postgres-server/opt/apigee/customer/application/postgres-server.propertiesedge-qpid-server/opt/apigee/customer/application/qpid-server.properties -
구성 파일에 다음 줄을 추가합니다.
conf_system_javax.net.ssl.trustStore=/opt/apigee/customer/application/my-cacerts.bcfks conf_system_javax.net.ssl.trustStorePassword=YOUR_STORE_PASSWORD conf_system_javax.net.ssl.keyStore=/opt/apigee/customer/application/my-cacerts.bcfks conf_system_javax.net.ssl.keyStoreType=BCFKS conf_system_javax.net.ssl.keyStorePassword=YOUR_STORE_PASSWORD
/opt/apigee/customer/application/my-cacerts.bcfks및YOUR_STORE_PASSWORD를 BCFKScacerts파일의 경로와 비밀번호로 바꿉니다. -
apigee사용자가 구성 파일을 소유하고 읽을 수 있는지 확인합니다.chown apigee:apigee /opt/apigee/customer/application/FILE.properties
-
구성요소를 다시 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service COMPONENT restart
부록
BCFKS 키 저장소 작업 샘플 명령어
아래 명령어는 자체 서명 키 및 인증서 쌍으로 BCFKS 키 저장소를 생성합니다.
keytool -genkeypair -keyalg RSA -alias node0 -validity 365 -keystore keystore.node0 \ -storepass keypass -keypass keypass -v \ -dname "EMAILADDRESS=youremail@domain.com, CN=yourcn, OU=yourou, O=youro, L=yourl, C=yourc" \ -storetype BCFKS -providerpath /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providername BCFIPS
Keytool 명령어는 일반적으로 사용되는 명령어와 일치하지만 Keytool 명령어에 다음 옵션이 포함되어야 합니다.
--storetype BCFKS -providerpath /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providername BCFIPS
Keytool 인수
| keytool 인수 | 설명 |
|---|---|
-storetype |
매장 유형을 BCFKS로 설정합니다. |
-providerpath |
bc-fips-XXXX.jar 경로를 지정합니다. 이 버전은 향후 OPDK 출시에서 변경될 수 있습니다. Apigee에서 제공하는 버전을 사용하거나 Bouncycastle 저장소에서 다운로드하세요. OPDK 4.53의 경우 경로는 /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar여야 합니다. |
-providerclass |
org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider로 설정합니다. |
-providername |
BCFIPS로 설정합니다. |
유사한 keytool 명령어를 사용하여 BCFKS 형식 키 저장소에서 인증서 또는 키를 가져오거나 내보낼 수 있습니다. BCFKS 사용 방법에 관한 자세한 내용은 BouncyCastle 문서를 참고하세요.
PKCS12 저장소
PKCS12 저장소를 생성하려면 openssl 명령어를 사용하면 됩니다.
# Generate a self-signed private key and certificate openssl req -x509 -newkey rsa:2048 -keyout private.key -out certificate.pem -sha256 -days 36500 -nodes -subj "/C=yourc/ST=yourst/L=yourl/O=youro/OU=yourou/CN=cn/emailAddress=email" # Package the above generated key and cert into a PKCS12 openssl pkcs12 -export -clcerts -in certificate.pem -inkey private.key -out keystore.pfx -name myalias
자체 비공개 키와 인증서가 있고 이를 PKCS12 형식으로 변환해야 하는 경우 인증서를 지원되는 형식으로 변환을 참조하세요.