README-v2.md

BlackBox v2

WARNING: v2 is still experimental. It is in the same git repo as v1 because the filenames do not overlap. Please do not mix the two. v1 is in bin. v2 is in cmd/blackbox and binv2.

Blackbox is an open source tool that enables you to safe store sensitive information in Git (or other) repos by encrypting them with GPG. Only the encrypted version of the file is available. You can be free to provide access to the repo, as but only people with the right GPG keys can access the encrypted data.

Things you should never store in a repo without encryption:

• TLS (SSL) certificates
• Passwords
• API keys
• And more!

Project Info:

• Overview
• Why is this important?
• Support/Community
• How BB encrypts
• OS Compatibility
• Installation Instructions
• Alternatives

User Info:

• Enabling Blackbox on a Repo
• Enroll a file
• Full Command List
• Add/Remove users
• Add/Remove files
• Advanced techiques
• Use with Role Accounts
• Backwards Compatibility
• Replacing expired keys
• Git Tips
• SubVersion Tips
• GnuPG tips
• Use with Ansible
• Use with Puppet

For contributors:

• Developer Info
• Code overview
• HOWTO: Add new OS support
• HOWTO: Add new VCS support

A slide presentation about an older release is on SlideShare.

Join our mailing list: https://groups.google.com/d/forum/blackbox-project

License

This content is released under the MIT License. See the LICENSE.txt file.