Go to file
jolheiser 26b581b5db
chore: update readme and renormalize on init
Signed-off-by: jolheiser <john.olheiser@gmail.com>
2023-08-03 15:15:28 -05:00
.woodpecker initial commit 2023-08-03 14:44:07 -05:00
cmd chore: update readme and renormalize on init 2023-08-03 15:15:28 -05:00
secrets initial commit 2023-08-03 14:44:07 -05:00
.git-age.yaml initial commit 2023-08-03 14:44:07 -05:00
.gitattributes initial commit 2023-08-03 14:44:07 -05:00
.gitignore initial commit 2023-08-03 14:44:07 -05:00
.goreleaser.yaml initial commit 2023-08-03 14:44:07 -05:00
LICENSE initial commit 2023-08-03 14:44:07 -05:00
README.md chore: update readme and renormalize on init 2023-08-03 15:15:28 -05:00
go.mod initial commit 2023-08-03 14:44:07 -05:00
go.sum initial commit 2023-08-03 14:44:07 -05:00
key.txt initial commit 2023-08-03 14:44:07 -05:00
main.go initial commit 2023-08-03 14:44:07 -05:00
ssh initial commit 2023-08-03 14:44:07 -05:00
ssh.pub initial commit 2023-08-03 14:44:07 -05:00

README.md

git-age

This is a Go port of git-agecrypt with some slight modifications.

Echoed from the original project:

Why should I use this?

Short answer: you probably shouldn't. Before considering this approach, take a look at SOPS and Hashicorp Vault if they are better suited for the problem at hand. They have a clear security advantage over git-age.

The one use-case where it makes sense to use git-age instead is when you want to keep some files secret on a (potentially public) git remote, but you need to have the plaintext in the local working tree because you cannot hook into the above tools for your workflow. Being lazy is not an excuse to use this software.

Adding git-age to a new repository

  1. Install git-age in your PATH
  2. git age init
  3. Add some identities
  • git age ident key.txt
  • git age ident ssh
  1. Set up your config (example)
  2. Add your secrets to .gitattributes secret.txt diff=git-age filter=git-age
  3. Use git like normal.

Decrypting an existing repository

Similar to initial install, adding identities prior to init so that any encrypted files are decrypted during initialization.

  1. Install git-age in your PATH
  2. Clone the repository
  3. Add some identities
  • git age ident key.txt
  • git age ident ssh
  1. git age init
  2. Use git like normal

License

This software was written based off of git-agecrypt.

MPL-2.0 (Original)