Skip to content

Commit daa0c87

Browse files
authored
Merge pull request #161 from vicenter-gitkraken/HC-101
HC-101 Expand on SSH commit signing section
2 parents 7fadc30 + 0f14031 commit daa0c87

File tree

2 files changed

+29
-9
lines changed

2 files changed

+29
-9
lines changed

_images/gkc-gpg-ssh-preferences.png

266 KB
Loading

gitkraken-client/commit-signing-with-gpg.md

Lines changed: 29 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,10 @@ There will be several prompts to make sure that you *really* want to delete your
144144

145145
###Commit Signing with SSH
146146

147-
SSH signature verification is available in Gitkraken 9.6.0 as Experimental feature
147+
Commit Signing with SSH is available in Gitkraken Client through Git Executable feature.
148+
149+
<img src="/wp-content/uploads/gkc-gpg-ssh-preferences.png" class="img-bordered img-responsive center">
150+
148151

149152
####Requirements
150153

@@ -161,25 +164,42 @@ Open a Terminal and run this command:
161164

162165
<img src="/wp-content/uploads/gkc-ssh-keygen.png" srcset="/wp-content/uploads/[email protected] 2x" class="img-bordered img-responsive center">
163166

164-
####Configure git to sign commits with SSH
165167

166-
Run this command to use SSH for signing commits and pointing to the key previously created:
167-
`git config --global gpg.format sshgit config --global user.signingkey /PATH/TO/.SSH/KEY.PUB`
168+
####Enable Git Executable feature
169+
170+
Go to <kbd>Preferences > Experimental > Git Executable</kbd> and enable it.
171+
172+
<img src="/wp-content/uploads/gkc-git-executable.png" srcset="/wp-content/uploads/[email protected] 2x" class="img-bordered img-responsive center">
173+
174+
####Select SSH as your GPG format for signing
175+
176+
[See this documentation to select the program used for the signing format](https://git-scm.com/docs/git-config#Documentation/git-config.txt-gpgltformatgtprogram)
177+
178+
At <kbd>Preferences > GPG > GPG Format</kbd>, select <kbd>SSH</kbd>.
179+
180+
Automatically Gitkraken client will change your preferences in `.gitconfig` and populate GPG SSH Program with ssh-keygen.
181+
182+
####Select the signing key
183+
184+
[See this documentation to select the signing key](https://git-scm.com/docs/git-config#Documentation/git-config.txt-usersigningKey)
185+
186+
On <kbd>Signing key</kbd>, click on <kbd>Browse</kbd> and select the `.pub` key file previously generated.
168187

169188
####Create allowed_signers file
189+
This file is needed to verify the key used to sign the commits is valid and known by git.
190+
[See this documentation to create the allowed_signers file](https://git-scm.com/docs/git-config#Documentation/git-config.txt-gpgsshallowedSignersFile)
170191

171-
This file is needed to verify the key used to sign the commits is valid and known by git
192+
On your terminal, run:
172193
```
173194
touch ~/.ssh/allowed_signers
174-
git config gpg.ssh.allowedSignersFile ~/.ssh/allowed_signers
175195
echo "$(git config --get user.email) namespaces=\"git\" $(cat ~/.ssh/<MY_KEY>.pub)" >> ~/.ssh/allowed_signers
196+
176197
```
198+
And select the file in Gitkraken client.
177199

178200
####Enable Commit Signing by Default in Gitkraken:
179201

180-
Preferences > GPG > Sign Commits/Tags By defaultPreferences > Experimental > Use Git Executable and select a git executable 2.34 or later
181-
182-
<img src="/wp-content/uploads/gkc-git-executable.png" srcset="/wp-content/uploads/[email protected] 2x" class="img-bordered img-responsive center">
202+
Preferences > GPG > Sign Commits/Tags By default
183203

184204
####Add the SSH key to your remote hosting
185205

0 commit comments

Comments
 (0)