Go to file
Josh Rabinowitz 7a730e4a4f
do lint/shellcheck tests on travis mac builds (#415)
* perform lint/shellcheck tests on travis mac builds
* move osx builds first in travis
* install shellcheck on macos
* show if the lint test passed or failed
* don't have travis install ruby 2.6 on osx for now
2019-03-12 15:41:54 -04:00
.ci do lint/shellcheck tests on travis mac builds (#415) 2019-03-12 15:41:54 -04:00
.Dockerfiles Fixing issues with docker 17.07 ce and systemd 2017-11-27 10:55:31 -07:00
.github Documentation additions about code style and philosophy (#361) 2019-02-21 18:04:23 -05:00
man Add docs for SECRETS_VERBOSE, env vars (#398) 2019-03-07 20:25:06 -05:00
RFC Aspell fixes (#365) 2019-02-21 15:20:34 -05:00
src Add to changelog, rename function, add comment. (#408) 2019-03-09 20:12:45 -05:00
tests Fix for windows (#375) 2019-03-09 18:49:45 -05:00
utils Fix for windows (#375) 2019-03-09 18:49:45 -05:00
vendor Import bats core (#380) 2019-03-04 18:52:53 -05:00
.editorconfig fixes after makefile crash 2016-02-21 16:26:17 +03:00
.gitattributes fixes after makefile crash 2016-02-21 16:26:17 +03:00
.gitignore Doc changes 2019 02 for #351 (#353) 2019-03-05 07:09:27 -05:00
.kitchen.yml Disable gnupg-git test on debian strech, gpg >=2.2.12 requires libassuan 2019-01-04 15:50:59 -07:00
.travis.yml do lint/shellcheck tests on travis mac builds (#415) 2019-03-12 15:41:54 -04:00
CHANGELOG.md do lint/shellcheck tests on travis mac builds (#415) 2019-03-12 15:41:54 -04:00
CONTRIBUTING.md Doc changes 2019 02 for #351 (#353) 2019-03-05 07:09:27 -05:00
Gemfile Add local ci tests. 2017-09-24 08:03:05 -06:00
LICENSE.md CONTRIBUTING.md added 2016-07-02 16:18:53 +03:00
Makefile Fix for windows (#375) 2019-03-09 18:49:45 -05:00
README.md Doc changes 2019 02 for #351 (#353) 2019-03-05 07:09:27 -05:00

git-secret

Backers on Open Collective Sponsors on Open Collective Build Status Homebrew Bintray deb

git-secret

What is git-secret?

git-secret is a bash tool which stores private data inside a git repo. git-secret encrypts files with permitted users' public keys, allowing users you trust to access encrypted data using pgp and their secret keys.

With git-secret, changes to access rights are simplified, and private-public key issues are handled for you.

When someone's permission is revoked, secrets do not need to be changed with git-secret - just remove their key from the keychain using git secret killperson their@email.com, re-encrypt the files, and they won't be able to decrypt secrets anymore. If you think the user might have copied the contents of the keys when they had access, then you should also change the secrets.

Preview

git-secret terminal preview

Installation

git-secret supports brew, just type: brew install git-secret

It also supports apt and yum. You can also use make if you want to. See the installation section for the details.

Requirements

git-secret relies on several external packages:

  • bash since 3.2.57 (it is hard to tell the correct patch release)
  • gawk since 4.0.2
  • git since 1.8.3.1
  • gpg since gnupg 1.4 to gnupg 2.X
  • sha256sum since 8.21 (on freebsd and MacOS shasum is used instead)

Contributing

Do you want to help the project? Find an issue and send a PR. It is more than welcomed! See CONTRIBUTING.md on how to do that.

Security

In order to encrypt (git-secret hide -m) files only when modified, the path mappings file tracks sha256sum checksums of the files added (git-secret add) to git-secret's path mappings filesystem database. Although, the chances of encountering a sha collision are low, it is recommend that you pad files with random data for greater security. Or avoid using the -m option altogether. If your secret file holds more data than just a single password these precautions should not be necessary, but could be followed for greater security.

If you found any security related issues, please do not disclose it in public. Send an email to security@wemake.services

Changelog

git-secret uses semver. See CHANGELOG.md.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Packagers

Thanks also to all the people and groups who package git-secret to be easier to install on particular OSes or distributions!

Here are some packagings of git-secret that we're aware of:

Such packages are considered 'downstream' because the git-secret code 'flows' from the git-secret repository to the various rpm/deb/dpkg/etc packages that are created for specific OSes and distributions.

We have also added notes specifically for packagers in CONTRIBUTING.md.

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

License

MIT. See LICENSE.md for details.

Thanks

Special thanks to Elio Qoshi from ura for the awesome logo.