如何使用SSH簽名Git提交記錄

Git 支持使用 GPG 來簽名提交記錄。但 GPG 用起來很復雜，一直賴得搞。

Git 從 2.34 開始支持使用 SSH 簽名。SSH 密鑰大家肯定都有，所以開啟簽名也需要提上日程了。只不過這個功能發布后很長時間內 GitHub 都不支持顯示 SSH 簽名，我也就沒有繼續推進。昨天 GitHub 官宣正式支持 SSH 簽名。今天就把相關的內容整理一下分享給大家。

首先，為什么要對 Git 提交做簽名呢？那是因為在 Git 中很容易偽造提交身份。

我們知道，Git 要求在提交前指定作者名字和郵箱：

git?config?user.name?濤叔
git?config?user.email?hi@taoshu.in

但這兩個配置可以隨便填。任何人都可以聲稱自己是濤叔。為了保護自己的聲譽，我可以用非對稱加密技術對提交進行簽名，然后公布自己公鑰。這樣其他人就可以根據這個公鑰來驗證 Git 變更是不是由我本人提交的。只要我不泄漏自己的私鑰，別人就很難偽裝成我來做壞事。

實現簽名最常見的工具是 GPG。如果你玩過 Linux 肯定不陌生，很多發行版的包管理器都使用 GPG 對包做簽名，防止壞人偽造。

但 GPG 對小白用戶不友好，所以普通 Git 玩家很少會開啟簽名。一直到 OpenSSH 8.0 發布，局面才有所改觀。因為這個版本的 OpenSSH 支持給任意數據進行簽名。

簽名功能在 OpenSSH 8.7 出問題了，建議使用 8.8 以后的版本

SSH 簽名的工具是 ssh-keygen。估計很多人只在第一次生成 SSH 密鑰的時候用到過，后面就在沒碰過它了。雖然有點奇怪但簽名也驗簽功能也是由 ssh-keygen 提供的。

假設有一個文件/tmp/a.txt，我們想使用~/.ssh/id_ed25519給它做簽名，我們可以：

ssh-keygen?-Y?sign?-f?~/.ssh/id_ed25519?-n?file?/tmp/a.txt

各參數的功能如下：

-Y sign表示計算簽名

-f指定私鑰

-n file是給簽名指定類型

file是我們自己定的，不同類型的簽名不會產生沖突

執行之后就會得到一個簽名文件/tmp/a.txt.sig，內容長這個樣子：

-----BEGIN?SSH?SIGNATURE-----
U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgulKNunkcVxiDzY0wmqJo4rAG9L
ClGRq9mMfA/PqsKYkAAAADZ2l0AAAAAAAAAAZzaGE1MTIAAABTAAAAC3NzaC1lZDI1NTE5
AAAAQP1FljU1ZQ327DZE11wjHIDgz1s0ULi7QO5rhg+MyEn12nwkV0fk69qDqmcpAE562x
pIxa+yaGuMV6hK97Hq+gE=
-----END?SSH?SIGNATURE-----

有了簽名，我們就可以驗證是不是有壞人篡改了文件內容了。驗證簽名需要一個公鑰列表：

hi@taoshu.in?ssh-ed25519?AAAAC3NzaC1lZDI1NTE5AAAAILpSjbp5HFcYg82NMJqiaOKwBvSwpRkavZjHwPz6rCmJ?ts@tc
...

第一列是公鑰的標識，我們這里用的是郵箱。第二列是公鑰類型，后面的部分是公鑰內容，也就是~/.ssh/id_ed25519.pub的內容。每個公鑰占一行。

驗簽命令如下：

ssh-keygen?-Y?verify?-f?allowed_signers?-I?hi@taoshu.in?-n?file?-s?/tmp/a.txt.sig?

各參數的功能如下：

-Y verify表示要驗證簽名

-f 用來指定公鑰列表文件

-I 指定使用公鑰標識

-n file 需要跟簽名的時候保持一致

-s 指定簽名所在文件

最后通過重定向將文件內容傳給 ssh-keygen。如果驗證通過，則會得到如下結果：

Good?"file"?signature?for?hi@taoshu.in?with?ED25519?key?SHA256:19/J4WKT7flBNcfmqQUqyAZeH4TdhMf5f0u+a4fZj1c

如果有人修改了文件內容，則會得到如下結果：

Signature?verification?failed:?incorrect?signature
Could?not?verify?signature.

考慮到大多數 Git 用戶都有自己的 SSH 密鑰，不支持 SSH 簽名豈不是很浪費？于是 Git 2.34 集成了 SSH 簽名功能。

我們需要添加如下配置：

#?使用?SSH?簽名
git?config?gpg.format?ssh
#?指定?SSH?私鑰文件
git?config?user.signingKey?~/.ssh/id_ed25519.pub
#?指定可信公鑰列表文件
git?config?gpg.ssh.allowedSignersFile?"$HOME/.config/git/allowed_signers"
#?開啟自動簽名（可選）
git?config?commit.gpgsign?true
git?config?tag.gpgsign?true

一番操作之后就準備好了。接下來所有的 Git 提交都會使用 SSH 簽名。如果沒有開啟自動簽名，則可以在提交的時候通過-s參數來臨時開啟。

在默認配置下，我們看不出簽名后的提交跟普通提交有什么區別。如果想展示簽名信息，需要指定--show-signature參數：

git?show?--show-signature?|head
commit?6292a43f184e8a347b6c8b4fe08191920c0e22a5
Good?"git"?signature?for?hi@taoshu.in?with?ED25519?key?SHA256:19/J4WKT7flBNcfmqQUqyAZeH4TdhMf5f0u+a4fZj1c
Author:?濤叔?
Date:???Wed?Aug?24?0754?2022?+0800

????支持給?TS?的枚舉類型生成?toString/parser?函數

diff?--git?a/autoload/lv.vim?b/autoload/lv.vim
index?22a6b38..a08deb9?100644
---?a/autoload/lv.vim
...

這個時候我們就看到了Good "git" signatures ...驗證消息。

如果你使用 tig，也應該添加同樣的參數，或者在~/.tigrc中開啟如下配置：

set?log-options?=?--show-signature
set?diff-options?=?--show-signature

回想我們前面的例子，當-n的值為file的時候，驗簽信息是Good "file"...。現在的信息是Good "git"...，說明 Git 使用的參數是-n git。

但有個問題，Git 到底把簽名信息存到了什么地方呢？答案是 commit 或者 tag 對應的 object。如果你不了解 Git 的存儲模型，可以閱讀我的另一篇文章。

我們可以使用cat-file查看對象保存的內容：

$?git?cat-file?commit?6292a43f184e8a347b6c8b4fe08191920c0e22a5
tree?c17c1e92312dc7303018c3dc3cd25d26007305e2
parent?e71d24c876aa6e82a69e1566623083923edcab03
author?濤叔??1661298954?+0800
committer?濤叔??1661298954?+0800
gpgsig?-----BEGIN?SSH?SIGNATURE-----
?U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgulKNunkcVxiDzY0wmqJo4rAG9L
?ClGRq9mMfA/PqsKYkAAAADZ2l0AAAAAAAAAAZzaGE1MTIAAABTAAAAC3NzaC1lZDI1NTE5
?AAAAQP1FljU1ZQ327DZE11wjHIDgz1s0ULi7QO5rhg+MyEn12nwkV0fk69qDqmcpAE562x
?pIxa+yaGuMV6hK97Hq+gE=
?-----END?SSH?SIGNATURE-----

支持給?TS?的枚舉類型生成?toString/parser?函數

大家看 gpgsig 這一行，表示當前提交的簽名信息。后面的每一行前面都有一個空格，表示這些行跟 gpgsig 是一個整體。

那 Git 是怎樣簽名的呢？我沒有去看源碼。但我猜是去掉 gpgsig 簽名信息，然后對剩余的內容計算簽名，簽名類型為 git。于是我把對應的內容保存成文件簽了一下，跟 gpgsig 的值完全一致。

Git 簽名很好地解決了分裝身份的問題。但如果對應功能沒辦法在 GitHub 上顯示，那就不夠炫酷。所以 Git 2.34 剛發布就有用戶建議 GitHub 添加支持。昨天終于上線了

雖然 GitHub 支持展示 SSH 簽名信息，但是簽名和鑒權用的密鑰需要分別上傳。上傳的時候需要指定類型。哪怕是使用同一個密鑰也得額外再傳一次。

上傳公鑰之后，GitHub 就會展示對應的 SSH 簽名。

以上就是本文的全部內容，希望能給大家一些參考。歡迎留言討論。

　審核編輯：湯梓紅

阅读全文

閱讀全文