Edge for Private Cloud на RHEL 8.X с поддержкой FIPS

В этом разделе приведены инструкции по включению режима 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 для его использования, выполните следующие действия:

  1. Создайте собственный файл 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"
  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 остаются такими же, как и обычно, но в них необходимо включить следующие параметры:

--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, ознакомьтесь с разделом Преобразование сертификатов в поддерживаемый формат.