It's purpose is to retrieve username/password credentials for GIT from KeePass password store using plugin KeePassCommander.
For Windows (.NET framework 4), the latest version can be found here.
Download the zip and unpack it in the KeePassCommander directory where KeePassCommandDll.dll is located.
The minimum .NET framework required is 4.0.
For unattended automatic installation scripts, read the section "Automatic installation scripts" lower down the page.
Execute git-credential-keepasscommand.exe without parameters to view the help.
git-credential-keepasscommand 1.3
https://github.com/MircoBabin/GitCredentialsViaKeePassCommander - MIT license
git-credential-keepasscommand.exe is a credential helper for GIT.
It's purpose is to retrieve username/password credentials for GIT from KeePass using plugin KeePassCommander.
INSTALLATION:
*** Place executable and config in same directory as KeePassCommandDll.dll
*** See KeePassCommander at https://github.com/MircoBabin/KeePassCommander
git config --global credential.helper "D:/KeePass/git-credential-keepasscommand.exe"
git config --system --list --show-origin
if there still is a credential.helper=manager listed, remove that
e.g. from C:/Program Files/Git/mingw64/etc/gitconfig remove [credential] helper=manager
UNINSTALL:
git config --global credential.helper manager
KeePass ENTRY:
In KeePass an entry containing username and password should be present with the following case-sensitive title (without quotes): "git [...lowercase last part of directoryname...][...lowercase computername...]".
If this entry is not found, the following case-sensitive title (without quotes) should be present: "git [...lowercase last part of directoryname...]".
e.g. The rootdirectory of the GIT project is
d:\projects\GitCredentialsViaKeePassCommander
And the computername is MIRCONB.
Then the KeePass title must be exactly (without quotes):
"git [gitcredentialsviakeepasscommander][mirconb]", or
"git [gitcredentialsviakeepasscommander]".
- Open a dosprompt
- Execute git-credential-keepasscommand.exe without parameters and follow the installation instructions. (This will show the correct path for configuring GIT.)
- Remove "git:..." credentials from the Windows Credential Manager, found in the Windows Control Panel. (In Dutch "Windows Referentiebeheer te vinden in het Configuratiescherm".)
Each project (GIT rootdirectory) must have an entry in KeePass. The title of the entry should be git [...lowercase last part of directoryname...][...lowercase computername...] or git [...lowercase last part of directoryname...]. And the entry should contain the username and password to login.
E.g. the root of the GIT project is d:\projects\webpage\myportals (containing the subdirectory .git) and the computername is mirconb then the title of the entry is git [myportals][mirconb] or git [myportals].
- 2-factor authentication is not supported.
- HTTPS transport works. SSH transport is not tested.
- It works with Bitbucket and Github. Other providers are not tested.
The default git credential "manager" stores passwords in the Windows Credential Manager. I don't want passwords to be stored in Windows, I want all my passwords stored in KeePass.
So I build git-credential-keepasscommand.exe which uses KeePassCommander to retrieve credentials from KeePass.
For unattended installation scripts the following flow can be used for the latest version:
- Download https://github.com/MircoBabin/GitCredentialsViaKeePassCommander/releases/latest/download/release.download.zip.url-location
- Read the text of this file into latest-download-url. The file only contains an url, so the encoding is ASCII. The encoding UTF-8 may also be used to read the file, because ASCII is UTF-8 encoding.
- Download the zip from the latest-download-url to local file GitCredentialsViaKeePassCommander.zip. Each release carries the version number in the filename. To prevent not knowing the downloaded filename, download to a fixed local filename.
- Unpack the downloaded GitCredentialsViaKeePassCommander.zip in the KeePassCommander directory where KeePassCommandDll.dll is located.
Contributions are welcome. Please read CONTRIBUTING.md before making any contribution!