В этом разделе приведены инструкции по включению режима FIPS в RHEL 8, обеспечивающего безопасную и соответствующую требованиям среду для Edge для частного облака версии 4.53.00 или выше.
Предустановка
Убедитесь, что на узлах включен стандарт FIPS, а также выполнены другие стандартные требования к конфигурации, перечисленные в документации Обзор установки Edge.
fips-mode-setup --check FIPS mode is enabled. # Command output
Если режим FIPS отключен, следуйте инструкциям в официальной документации Red Hat, чтобы включить его: Switching RHEL 8 to FIPS mode.
Требования к Java
Используемую версию Java следует скачать из хранилища Red Hat, чтобы обеспечить соответствие модулей безопасности стандарту FIPS и включить ограничения FIPS в системе безопасности Java.
Установка
В справочнике по файлу конфигурации Edge задайте FIPS_OS=true на каждом узле. Вы можете выполнить общие шаги по установке Edge для частного облака, как обычно.
Формат закрытого ключа
Для загрузки закрытых ключей в хранилища ключей Apigee, чтобы использовать их в прокси-серверах API или виртуальных хостах, можно использовать только формат PKCS12/PFX. Инструкции по созданию файла приведены в разделе Преобразование сертификатов в поддерживаемый формат.
Общие операции TLS
При использовании Edge для Private Cloud 4.53.00 или более поздней версии на RHEL 8.X с поддержкой FIPS большинство конфигураций компонентов Edge, связанных с TLS, необходимо будет выполнить через хранилища ключей формата PKCS12 или BCFKS.
Дополнительную информацию можно найти в документации по FIPS или в примечаниях к статьям о настройке TLS. В приложении приведены некоторые полезные команды, которые можно использовать для создания этих хранилищ ключей.
Хранилище ключей/доверенных сертификатов Java по умолчанию
Когда вы используете Edge for Private Cloud 4.53.00 на RHEL 8.X с поддержкой FIPS, ваши Message Processor, Management Server и другие компоненты edge-* по умолчанию указывают на плейсхолдер хранилища ключей и хранилища доверенных сертификатов BCFKS (/opt/apigee/edge-gateway/vault/bcfks-cacerts), поставляемый с продуктом.
Чтобы создать собственное хранилище BCFKS cacerts и настроить компоненты Edge для его использования, выполните следующие действия:
-
Создайте собственный файл
cacertsв формате BCFKS, содержащий все сертификаты ЦС, которым вы хотите доверять. Убедитесь, что пароль хранилища ключей и пароль ключа совпадают (и содержат не менее 14 символов, если применяются строгие проверки паролей BCFIPS).-
Вариант А. Преобразуйте хранилище ОС хоста или JDK
cacertsв формат BCFKS (рекомендуется, если вы хотите включить стандартные доверенные корневые ЦС ОС, управляемые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 с собственными сертификатами ЦС (
.pemили.crt) или импортируйте дополнительные собственные сертификаты ЦС в существующее хранилище 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 остаются такими же, как и обычно, но в них необходимо включить следующие параметры:
--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, ознакомьтесь с разделом Преобразование сертификатов в поддерживаемый формат.