Edge for Private Cloud ב-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 כדי להעלות מפתחות פרטיים למאגרי מפתחות של Apigee, לשימוש בשרתי proxy ל-API או במארחים וירטואליים. הנחיות ליצירת הקובץ מפורטות במאמר המרת אישורים לפורמט נתמך.

פעולות TLS כלליות

כשמשתמשים ב-Edge for Private Cloud בגרסה 4.53.00 ואילך ב-RHEL 8.X עם תמיכה ב-FIPS, צריך לבצע את רוב ההגדרות של רכיבים שקשורים ל-TLS ב-Edge באמצעות מאגרי מפתחות בפורמט PKCS12 או BCFKS.

לפרטים נוספים, אפשר לעיין במסמכים הספציפיים ל-FIPS או בהערות במאמרים הרלוונטיים להגדרת TLS. בנספח מפורטות כמה פקודות שימושיות שאפשר להשתמש בהן כדי ליצור את מאגרי המפתחות האלה.

‫Java keystore/truststore שמוגדר כברירת מחדל

כשמשתמשים ב-Edge for Private Cloud בגרסה 4.53.00 ב-RHEL 8.X עם תמיכה ב-FIPS, מעבד הבקשות, שרת הניהול ורכיבי edge-* אחרים מפנים כברירת מחדל למאגר מפתחות ול-truststore מסוג BCFKS (/opt/apigee/edge-gateway/vault/bcfks-cacerts) שנשלחים עם המוצר.

כדי ליצור מאגר BCFKS cacerts משלכם ולהגדיר את רכיבי Edge כך שישתמשו בו, צריך לבצע את השלבים הבאים:

  1. יוצרים קובץ cacerts משלכם בפורמט BCFKS שמכיל את כל אישורי ה-CA שאתם רוצים לתת בהם אמון. מוודאים שהסיסמה של מאגר המפתחות והסיסמה של המפתח זהות (ובאורך של 14 תווים לפחות אם חלות בדיקות סיסמה מחמירות של BCFIPS).

    • אפשרות א': המרת מאגר ה-OS או ה-JDK cacerts של המארח לפורמט BCFKS (מומלץ אם רוצים לכלול את רשויות אישורי הבסיס המהימנות הרגילות של ה-OS שמנוהלות על ידי 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 עם זוג מפתחות ואישורים בחתימה עצמית:

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, עיינו במאמר המרת אישורים לפורמט נתמך.