mirror of
https://github.com/sobolevn/git-secret
synced 2024-10-31 21:20:29 +00:00
118 lines
4.8 KiB
Markdown
118 lines
4.8 KiB
Markdown
# git-secret
|
|
|
|
[](#backers) [](#sponsors) [](https://travis-ci.org/sobolevn/git-secret) [](https://formulae.brew.sh/formula/git-secret) [](https://bintray.com/sobolevn/deb/git-secret/view)
|
|
|
|
[](http://git-secret.io/)
|
|
|
|
|
|
## 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 secrets or keys when they had access, then
|
|
you should also change the secrets.
|
|
|
|
|
|
## Preview
|
|
|
|
[](https://asciinema.org/a/41811?autoplay=1)
|
|
|
|
|
|
## 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](http://git-secret.io/installation) 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](https://github.com/sobolevn/git-secret/issues)
|
|
and send a PR. It is more than welcomed! See [CONTRIBUTING.md](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](https://semver.org/). See [CHANGELOG.md](CHANGELOG.md).
|
|
|
|
|
|
## 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:
|
|
|
|
- https://formulae.brew.sh/formula/git-secret
|
|
- https://packages.ubuntu.com/bionic/git-secret
|
|
- https://apps.fedoraproject.org/packages/git-secret
|
|
- https://aur.archlinux.org/packages/git-secret/
|
|
- https://pkgs.alpinelinux.org/package/edge/testing/x86/git-secret
|
|
- https://packages.debian.org/sid/git-secret
|
|
- https://github.com/void-linux/void-packages/blob/master/srcpkgs/git-secret/template
|
|
|
|
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](CONTRIBUTING.md).
|
|
|
|
|
|
## Sponsors
|
|
|
|
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/git-secret#sponsor)]
|
|
|
|
[](https://opencollective.com/git-secret)
|
|
|
|
|
|
## Backers
|
|
|
|
Thanks to all our backers!
|
|
|
|
[](https://opencollective.com/git-secret)
|
|
|
|
|
|
## Contributors
|
|
|
|
This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
|
|
<a href="https://github.com/sobolevn/git-secret/graphs/contributors"><img src="https://opencollective.com/git-secret/contributors.svg?width=890" /></a>
|
|
|
|
|
|
## License
|
|
|
|
MIT. See [LICENSE.md](LICENSE.md) for details.
|
|
|
|
|
|
## Thanks
|
|
|
|
Special thanks to [Elio Qoshi](https://elioqoshi.me/sq/) from [ura](http://ura.design/) for the awesome logo.
|