gitpin

README

gitpin - ssl certificate pinning for git

gitpin is a small tool that allows you to manage ssl pinnings for git. You can also use it manually by just writing some text files:

kmille@linbox:~ cat ~/.gitconfig
[includeIf "hasconfig:remote.*.url:https://github.com/**"]
path = /home/kmille/.gitconfig.d/github.com.inc

kmille@linbox:gitpin cat /home/kmille/.gitconfig.d/github.com.inc
[http]
pinnedPubkey = sha256//YH8+l6PDvIo1Q5o6varvw2edPgfyJFY5fHuSlsVdvdc=

Walkthrough

Features

kmille@linbox:gitpin ./gitpin --help         
usage: ./gitpin [-h|--help] [--system] [-s|--show-cert "<value>"] [-a|--add
                "<value>"] [-c|--check] [-u|--update] [-d|--delete "<value>"]
                [-v|--version]

                add ssl pinning to git

Arguments:

  -h  --help       Print help information
      --system     Use /etc/gitconfig instead of ~/.gitconfig
  -t  --tor        Connect via tor (socks5://localhost:9050)
  -s  --show-cert  Show certificate of <domain>
  -a  --add        Add fingerprint for <domain>
  -c  --check      Check if fingerprints match
  -u  --update     Update fingerprints
  -d  --delete     Delete fingerprint for <domain>
  -v  --version    Show version

Please don't forget that these days SSL certificates expire after 90 days and you have to update the pinning. There is also an AUR package for Arch Linux. If a certificate is invalid you can use --tor to check the connection via tor. If there is at least one certificate mismatch, return value is 1.

TODOs

• add support for socks5 proxy (to check if other systems get the same certificate, socks5 is nice because you can use it with Tor or ssh -D)