Puppet Enterprise (PE) complies with Federal Information Processing Standard (FIPS) 140-2 standards and is fully operable on select FIPS-compliant platforms.
To install FIPS-compliant PE, simply install your master and agents on a supported platform with FIPS mode enabled. Master and compiler nodes must be configured with sufficient available entropy or the installation process fails.
Changes in FIPS-compliant installations
- All components are built and packaged against system OpenSSL for the master, or against OpenSSL built in FIPS mode for agents.
- All use of MD5 hashes for security has been eliminated and replaced.
- Forge and module tooling use SHA-256 hashes to verify the identity of modules.
- Proper random number generation devices are used on all platforms.
- All Java and Clojure components use FIPS Bouncy Castle encryption providers on FIPS platforms.
Limitations and cautions for FIPS-compliant installations
- Upgrading from non-FIPS-compliant versions of PE to FIPS-compliant PE is not supported.
- Disaster recovery configurations are not supported for FIPS-compliant PE.
- FIPS-compliant installations don't support extensions that use the standard Ruby Open SSL library, such as heira-eyaml.
- Due to a known issue with the
puppet dbcommands fail with SSL handshake errors when run on FIPS-enabled hardware. To use
puppet dbcommands on a FIPS-enabled machine, install the puppetdb_cli Ruby gem. To use
puppet codecommands on a FIPS-enabled machine, use the Code Manager API.