Git signing + auth¶
Pico FIDO can participate in two different Git workflows:
- SSH commit/tag signing
- SSH authentication for push and pull
These workflows use separate credentials, even when both keys are stored on the same device.
SSH signing¶
Git 2.34+ can sign commits and tags with SSH keys, including -sk hardware-backed keys.
git config --global gpg.format ssh
git config --global user.signingkey ~/.ssh/id_ed25519_sk.pub
git config --global commit.gpgsign true
git config --global tag.gpgsign true
Then:
git commit -m "signed with Pico FIDO"
git log --show-signature -1
Git asks the authenticator to create a signature for each commit or tag.
Local verification¶
SSH signature verification needs an allowed signers file:
mkdir -p ~/.config/git
printf '%s namespaces="git" %s\n' \
"you@example.com" \
"$(cat ~/.ssh/id_ed25519_sk.pub)" \
>> ~/.config/git/allowed_signers
git config --global gpg.ssh.allowedSignersFile ~/.config/git/allowed_signers
git verify-commit HEAD
If Git signs successfully but cannot verify the result locally, check that the allowed signers file is configured.
GitHub and GitLab signing¶
Add the public key as a signing key in the forge account settings.
Signing and SSH login keys serve different purposes, and most forges store them as separate account records.
Push and pull over SSH¶
Use a hardware-backed SSH key as your transport key:
git remote set-url origin git@github.com:you/repo.git
git push
Each new SSH connection may require user presence, and it may also require a PIN.
For fewer repeated prompts during a burst of Git operations, use SSH connection reuse:
Host github.com
User git
IdentityFile ~/.ssh/id_ed25519_sk
IdentitiesOnly yes
ControlMaster auto
ControlPath ~/.ssh/cm-%r@%h:%p
ControlPersist 10m
Account 2FA¶
For browser-side account challenges, register Pico FIDO as:
- a passkey, if the forge supports it
- a security key / WebAuthn second factor otherwise
This account 2FA registration is independent of commit signing and SSH push/pull authentication.
OpenPGP alternative¶
If you use Pico OpenPGP for a GnuPG identity, Git can sign through the OpenPGP card instead. See OpenPGP card.
Troubleshooting¶
git verify-commitreports no trusted signature: configuregpg.ssh.allowedSignersFile.- commits are unverified on a forge: add the key as a signing key and check the commit email.
git pushsays public key denied: add the key as an authentication key and verify the remote uses SSH.- too many touch prompts: check
ssh-agent,IdentityFile, and connection reuse.