Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chr15m/gitnonymous
Make pseudonymous Git commits over Tor
https://github.com/chr15m/gitnonymous
bash git identity privacy privacy-enhancing-technologies privacy-protection shell-script ssh ssh-key timezone tor
Last synced: about 2 months ago
JSON representation
Make pseudonymous Git commits over Tor
- Host: GitHub
- URL: https://github.com/chr15m/gitnonymous
- Owner: chr15m
- Created: 2015-11-24T11:06:19.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-08-30T08:59:01.000Z (over 5 years ago)
- Last Synced: 2024-10-17T12:21:58.239Z (2 months ago)
- Topics: bash, git, identity, privacy, privacy-enhancing-technologies, privacy-protection, shell-script, ssh, ssh-key, timezone, tor
- Language: Shell
- Homepage:
- Size: 9.77 KB
- Stars: 180
- Watchers: 8
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Contribute ~~anonymously~~ pseudonymously to Git repositories over Tor.
## tl;dr ##
yourname@yourbox:~$ . gitnonymous somename
somename⚔ yourname@yourbox:~$ git commit_## What is this? ##
This is a tool for management of identities that you can use to obfuscate your true identity when making Git commits and pushing to public repositories.
[Non-GH mirror of gitnonymous here](https://gitea.mccormick.cx/chr15m/gitnonymous).
## Setup ##
Before you start, you'll probably want to:
* Set up an anonymous email account with some provider.
* Sign up to the Git hosting service you use with that anonymous email address.To configure a new ~~anonymous~~ pseudonymous identity on your machine:
$ ./gitnonymous-setup KEYNAME
Where `KEYNAME` is some memorable string that you will use to identify your pseudonymous ID like `baby-protector` or `elite-freedom-defender`. You can create multiple pseudonymous identities.
Be aware that `KEYNAME` is stored in the SSH public key's comment field so don't make it personally identifiable.
Then you should edit the new file in `~/.gitnonymous-KEYNAME/config` to set the email address and name of your pseudonymous identity:
export GIT_COMMITTER_NAME="Baby Protector"
export GIT_COMMITTER_EMAIL="[email protected]"
export GIT_AUTHOR_NAME="Baby Protector"
export GIT_AUTHOR_EMAIL="[email protected]"
export TZ=UTCYou can pass `ssh-keygen` options to the setup command as well. For example to create an ed25519 key instead of an RSA key:
$ ./gitnonymous-setup KEYNAME -t ed25519
## Use ##
You can symlink the `gitnonymous` and `gitnonymous-setup` commands into your `~/bin` folder or somewhere else on your `PATH` to execute them without typing the full path.
Each time you want make pseudonymous commits in the current shell:
$ . gitnonymous KEYNAME
After that when you commit and push you will do so with the pseudonymous identity you have created, over the tor network, using the new SSH key that was created.
This command:
* Spawns an `ssh-agent` that is limited to the current shell.
* Adds the pseudonymous SSH key to `ssh-agent`.
* Sets the `GIT_COMMITTER` and `GIT_AUTHOR` environment variables.
* Sets the `GIT_SSH` environment variable to point at a configured `git-ssh-wrap` script.
* Sets the `GIT_PROXY_COMMAND` environment variable to proxy network requests through tor.
* Sets the `TZ` environment variable to `UTC` in order to obscure your real timezone.Your prompt will be updated to reflect the configured environment:
KEYNAME⚔ yourname@yourbox:~$
To deactivate the gitnonymous environment run `gitnonymous-exit`:
KEYNAME⚔ yourname@yourbox:~$ gitnonymous-exit
yourname@yourbox:~$ _Or just exit the current shell.
## Information leaks ##
Whilst this will help you adopt a pseudonymous virtual identity, you should be aware of the following information leaks that may still be used to try to identify you, pointed out by @ryancdotorg on Hacker News:
* Commit times will be leaked (narrows down sleeping/working hours), although timezone is not exposed.
* SSH client version will be leaked to servers you connect to (shows Linux distro version and patch level).## Dependencies ##
* `git`
* `tor` (install `tor` package)
* `nc` (install `netcat-openbsd` package)
* `ssh`
* `bash`## Tested ##
* With `git` 1.9.1 on Xubuntu 14.04.
Patches welcome!