Edge สำหรับระบบคลาวด์ส่วนตัวใน RHEL 8.X ที่เปิดใช้ FIPS

ส่วนนี้จะให้คำแนะนำเกี่ยวกับการเปิดใช้โหมด 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 เพื่อใช้งาน ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างไฟล์ 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"
  2. ในแต่ละโหนดที่เรียกใช้คอมโพเนนต์ Edge ใดๆ ที่ระบุไว้ในขั้นตอนที่ 3 ให้คัดลอกไฟล์ BCFKS ไปยังเส้นทางที่เหมาะสม และตรวจสอบว่าผู้ใช้ apigee สามารถอ่านไฟล์ได้

    cp my-cacerts.bcfks /opt/apigee/customer/application/my-cacerts.bcfks
    chown apigee:apigee /opt/apigee/customer/application/my-cacerts.bcfks
    chmod 600 /opt/apigee/customer/application/my-cacerts.bcfks
  3. ในแต่ละโหนด ให้สร้างหรือแก้ไขไฟล์การกำหนดค่าสำหรับคอมโพเนนต์ที่ติดตั้งแต่ละรายการจากตารางต่อไปนี้ (ทำซ้ำขั้นตอนที่ 3-6 สำหรับคอมโพเนนต์แต่ละรายการที่แสดงในโหนด)

    ส่วนประกอบ ไฟล์
    edge-management-server /opt/apigee/customer/application/management-server.properties
    edge-message-processor /opt/apigee/customer/application/message-processor.properties
    edge-router /opt/apigee/customer/application/router.properties
    edge-postgres-server /opt/apigee/customer/application/postgres-server.properties
    edge-qpid-server /opt/apigee/customer/application/qpid-server.properties
  4. เพิ่มบรรทัดต่อไปนี้ลงในไฟล์การกำหนดค่า

    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 ด้วยเส้นทางและรหัสผ่านสำหรับไฟล์ BCFKS cacerts

  5. ตรวจสอบว่าผู้ใช้ apigee เป็นเจ้าของและอ่านไฟล์การกำหนดค่าได้ โดยทำดังนี้

    chown apigee:apigee /opt/apigee/customer/application/FILE.properties
  6. รีสตาร์ทคอมโพเนนต์ โดยทำดังนี้

    /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 โปรดดูหัวข้อการแปลงใบรับรองเป็นรูปแบบที่รองรับ