Skip to content
Pseudonymous Git commits over Tor
Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
config
git-proxy-command
git-ssh-wrap
gitnonymous
gitnonymous-setup

README.md

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.

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="protect-all-babies@anonymous-mail-provider.com"
export GIT_AUTHOR_NAME="Baby Protector"
export GIT_AUTHOR_EMAIL="protect-all-babies@anonymous-mail-provider.com"
export TZ=UTC

You 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!

You can’t perform that action at this time.