Managing Git credentials the easy way

Introduction

Credential management in Git should not be difficult to use or configure, but (unfortunately) looking at the existing tools, it is difficult to even think about it, let alone configure them without errors.

NOT. ANY. MORE!

Presenting git-credential-netconf, an easy yet powerful way to manage your Git credentials by harnessing the power of GnuPG!

Getting Started

The following guide assumes you have a GPG key.

0. Installing `git-credential-netconf`

pip install git-credential-netconf

1. Create a `.netconf` file in your home directory

touch ~/.netconf

2. Start by filling in your username and password

[conf]
login = yourname
password = very-secret-password

The .netconf file uses configuration file format.

3. Encrypt your `.netconf` file with `gpg`

gpg --recipient [email protected] --output ~/.netconf.gpg \
    --encrypt --sign ~/.netconf

And remove your original .netconf for security:

shred -u ~/.netconf

4. Tell Git to use it

⚠️ Make sure that ~/.local/bin is in $PATH

git config --global credential.helper 'netconf --debug'

5. Now use git without hassle!

git push

This will prompt git-credential-netconf to decrypt the ~/.netconf.gpg file using GPG and fetch the username and password, among other values.

You'll be asked for the password to GPG private key when decrypting.