ส่วนนี้จะให้คำแนะนำเกี่ยวกับการเปิดใช้โหมด FIPS ใน RHEL 8 เพื่อให้มั่นใจว่าสภาพแวดล้อมที่ปลอดภัยและเป็นไปตามข้อกำหนดสำหรับ Edge for Private Cloud เวอร์ชัน 4.53.00 ขึ้นไป
ติดตั้งไว้ล่วงหน้า
ตรวจสอบว่าได้เปิดใช้ FIPS ในโหนดของคุณพร้อมกับข้อกำหนดเบื้องต้นสำหรับการกำหนดค่ามาตรฐานอื่นๆ ที่ระบุไว้ในเอกสารประกอบภาพรวมการติดตั้ง Edge
fips-mode-setup --check FIPS mode is enabled. # Command output
หากโหมด FIPS ปิดใช้อยู่ โปรดดูวิธีการเปิดใช้ในเอกสารประกอบอย่างเป็นทางการของ Red Hat: การเปลี่ยน RHEL 8 เป็นโหมด FIPS
ข้อกำหนดของ Java
คุณควรดาวน์โหลด Java ที่ใช้จากที่เก็บของ Red Hat เพื่อให้มั่นใจว่าโมดูลความปลอดภัยเป็นไปตามข้อกำหนด FIPS ซึ่งจะเปิดใช้ข้อจำกัดเฉพาะของ FIPS ผ่านการรักษาความปลอดภัยของ Java
การติดตั้ง
ในข้อมูลอ้างอิงไฟล์การกำหนดค่า Edge ให้ตั้งค่า FIPS_OS=true ในแต่ละโหนด คุณสามารถทำตามขั้นตอนการติดตั้งทั่วไปสำหรับ Edge for Private Cloud ได้ตามปกติ
รูปแบบคีย์ส่วนตัว
คุณใช้ได้เฉพาะรูปแบบ PKCS12/PFX เพื่ออัปโหลดคีย์ส่วนตัวไปยัง Keystore ของ Apigee เพื่อใช้ในพร็อกซี API หรือโฮสต์เสมือน โปรดดูคำแนะนำในการสร้างไฟล์ที่หัวข้อการแปลงใบรับรองเป็นรูปแบบที่รองรับ
การดำเนินการ TLS ทั่วไป
เมื่อใช้ Edge for Private Cloud 4.53.00 ขึ้นไปใน RHEL 8.X ที่เปิดใช้ FIPS การกำหนดค่าคอมโพเนนต์ที่เกี่ยวข้องกับ TLS ส่วนใหญ่ของ Edge จะต้องดำเนินการผ่านคีย์สโตร์รูปแบบ PKCS12 หรือ BCFKS
โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบหรือหมายเหตุเฉพาะของ FIPS ในบทความที่เกี่ยวข้องสำหรับการกำหนดค่า TLS ภาคผนวกแสดงรายการคำสั่งที่เป็นประโยชน์ซึ่งสามารถใช้เพื่อสร้างคีย์สโตร์เหล่านี้ได้
Keystore/Truststore เริ่มต้นของ Java
เมื่อใช้ Edge for Private Cloud 4.53.00 ใน RHEL 8.X ที่เปิดใช้ FIPS คอมโพเนนต์ Message Processor, Management Server และ edge-* อื่นๆ จะชี้ไปยังคีย์สโตร์และ Truststore BCFKS ตัวยึดตำแหน่ง (/opt/apigee/edge-gateway/vault/bcfks-cacerts) ที่มาพร้อมกับผลิตภัณฑ์โดยค่าเริ่มต้น
หากต้องการสร้างที่เก็บ BCFKS cacerts ของคุณเองและกำหนดค่าคอมโพเนนต์ Edge เพื่อใช้งาน ให้ทำตามขั้นตอนต่อไปนี้
-
สร้างไฟล์
cacertsรูปแบบ BCFKS ของคุณเองซึ่งมีใบรับรอง CA ทั้งหมดที่คุณต้องการเชื่อถือ ตรวจสอบว่ารหัสผ่าน Keystore และรหัสผ่านคีย์เหมือนกัน (และมีอักขระอย่างน้อย 14 ตัวหากใช้การตรวจสอบรหัสผ่าน BCFIPS ที่เข้มงวด)-
ตัวเลือก ก: แปลงที่เก็บระบบปฏิบัติการโฮสต์หรือ JDK
cacertsเป็นรูปแบบ BCFKS (แนะนำหากคุณต้องการรวม CA รูทที่เชื่อถือได้ของระบบปฏิบัติการมาตรฐานที่จัดการโดยupdate-ca-trust) โดยทำดังนี้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 -
ตัวเลือก ข: สร้างที่เก็บ BCFKS ใหม่ที่มีใบรับรอง CA ที่กำหนดเอง (
.pemหรือ.crt) หรือนำเข้าใบรับรอง CA ที่กำหนดเองเพิ่มเติมไปยังที่เก็บ BCFKS ที่มีอยู่ (เช่นmy-cacerts.bcfksจากตัวเลือก ก) โดยทำดังนี้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"
-
-
ในแต่ละโหนดที่เรียกใช้คอมโพเนนต์ Edge ใดๆ ที่ระบุไว้ในขั้นตอนที่ 3 ให้คัดลอกไฟล์ 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 ที่มีคู่คีย์และใบรับรองแบบ Self-signed
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 Store
หากต้องการสร้างที่เก็บ 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 โปรดดูหัวข้อการแปลงใบรับรองเป็นรูปแบบที่รองรับ