בקטע הזה מוסבר איך להפעיל את מצב 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 כך שישתמשו בו, צריך לבצע את השלבים הבאים:
-
יוצרים קובץ
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"
-
-
בכל צומת שבו פועל אחד מרכיבי 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 עם זוג מפתחות ואישורים בחתימה עצמית:
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, עיינו במאמר המרת אישורים לפורמט נתמך.