Download the PHP package bentools/shh-bundle without Composer

Shh! 🤫

Shh! is a proof-of-concept aiming at dealing with secrets within your Symfony application.

Why?

I was just reading Storing secrets for Symfony applications from Matthias Pigulla which came with a solution using a Ruby-powered external program.

Then I came up with the following question: why isn't there a PHP implementation of this? 🤔

Here are the key principles:

• Storing secrets in environment variables will actually expose them through phpinfo(), reports, logs, and child processes.
• Thanks to Symfony's Env Var Processors, Shh will expose them encrypted. They will be decrypted at the very last moment.
• Private key + an optional passphrase are required to decrypt secrets. They SHOULD be .gitgnored.
• You can then commit encrypted secrets to VCS as long as the private key is stored and communicated safely.
• You can change your passphrase a at any time.

Installation

Configuration

• Add the bundle to your kernel (come on, you're not using Flex?).
• Generate your keys:
  • Create a shh directory into your config directory mkdir -p config/shh (or mkdir -p app/config/shh for Symfony 3)
  • Runphp bin/console shh:generate:keys
  • If you provided one, store the passphrase in the SHH_PASSPHRASE environment variable
  • Add config/shh/private.pem (or app/config/shh/private.pem for Symfony 3) to your .gitignore and upload it to your production server.

And you're ready to go!

If you want a different configuration, check out the configuration reference to discover the available options.

Usage

Check the environment is properly configured

Encrypt a value (public key needed)

Decrypt a value (public key + private key needed)

Decrypt secrets in environment variables

This library ships with an environment variable processor. You can use it like this:

Working with a secrets file

You can store your encrypted secrets in a .secrets.json file at the root of your project directory (you can set a different path in the SHH_SECRETS_FILE environment variable).

This file can safely be committed to VCS (as soon as the private key isn't).

To encrypt and register a secret in this file, run the following command:

You can then use your secrets in your configuration files in the following way:

Changing passphrase

You can change your passphrase if needed: this will result in a new private key being generated. The public key remains unchanged.

As a result, a new private key will be regenerated. You just have to update it everywhere it is used, and update the SHH_PASSPHRASE environment variable as well.

You may do this every time an employee leaves the company, for instance.

Configuration reference

Tests

Feedback

Don't hesitate to ping me on Symfony Slack: @bpolaszek.

License

MIT