jolheiser
/
git-age
mirror of https://git.jolheiser.com/git-age
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
9 Commits
1 Branch
0 Tags
63 KiB
Go 94.6%
Nix 5.4%
 
 
Go to file
jolheiser 72352f984f
docs: add man page to nix 
Signed-off-by: jolheiser <john.olheiser@gmail.com>
 		2023-11-13 21:32:57 -06:00
.woodpecker initial commit 2023-08-03 14:44:07 -05:00
cmd feat: git-age add 2023-11-13 16:17:21 -06:00
secrets chore: rekey 2023-08-23 23:08:20 -05:00
.git-age.yaml feat: git-age add 2023-11-13 16:17:21 -06:00
.gitattributes feat: globbing 2023-08-23 23:07:49 -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
flake.lock feat: nix flake 2023-11-13 19:22:57 -06:00
flake.nix docs: add man page to nix 2023-11-13 21:32:57 -06:00
go.mod feat: git-age add 2023-11-13 16:17:21 -06:00
go.sum feat: git-age add 2023-11-13 16:17:21 -06: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
man.go docs: add man page to nix 2023-11-13 21:32:57 -06: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)