GnuPG(简称 GPG),它是目前最流行、最好用的开源加密工具之一。
GPG 有许多用途,比如对文件,邮件的加密。而本文要说的是,如何使用 GPG 来加密 Github Commits,从而保证提交的commit在传输的过程中没有被篡改。。
在 Github 上查看一些项目的 Commits 时,偶尔会发现「This commit was signed with a verified signature.」字样。

安装git

git自带gpg命令,后续步骤直接在git bash里生成密匙。
Git官网 https://git-scm.com

生成密匙

打开git bash,直接输入:

1
gpg --gen-key

回车,提示信息如下:

1
2
3
4
5
6
7
8
9
10
gpg (GnuPG) 1.4.21; Copyright (C) 2015 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Please select what kind of key you want:
(1) RSA and RSA (default)
(2) DSA and Elgamal
(3) DSA (sign only)
(4) RSA (sign only)
Your selection?

选择加密算法,默认选择第一个选项即可,表示加密和签名都使用 RSA 算法。
选 1,回车。
选择密钥长度,默认为 2048,建议输入 4096。

1
2
RSA keys may be between 1024 and 4096 bits long.
What keysize do you want? (2048)

输入 4096,回车。

设定密钥的有效期。

1
2
3
4
5
6
7
Please specify how long the key should be valid.
0 = key does not expire
<n> = key expires in n days
<n>w = key expires in n weeks
<n>m = key expires in n months
<n>y = key expires in n years
Key is valid for? (0)

密钥只是个人使用的话,建议选择第一个选项,即永不过期。
输入 0,回车。

系统会问你上述设置是否正确。

1
Is this correct? (y/N)

输入 y,回车。

系统会要求你输入个人信息。

1
2
3
4
5
You need a user ID to identify your key; the software constructs the user ID
from the Real Name, Comment and Email Address in this form:
"Heinrich Heine (Der Dichter) <heinrichh@duesseldorf.de>"

Real name:

「Real name」填入你的名字,需是英文。回车。

1
Email address:

「Email address」填入你的邮箱地址。回车。

1
Comment:

「Comment」可以空着不填。回车。
系统会再次让你确认填入的信息。

1
2
3
4
You selected this USER-ID:
"Teddysun <i@teddysun.com>"

Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit?

输入 O,回车。
系统会让你设定一个私钥的密码。

1
2
3
You need a Passphrase to protect your secret key.
Enter passphrase:
Repeat passphrase:

注意这里要留空不填,直接回车即可。这是因为 TortoiseGit 不支持 1.4.x 含有私钥密码。直接使用git bash的话不影响,可选择设置密码。
系统这时开始生成密钥,,这时会要求你做一些随机的举动,以生成一个随机数。你拿起鼠标随便晃晃,直到完成密钥生成。

1
2
3
4
We need to generate a lot of random bytes. It is a good idea to perform
some other action (type on the keyboard, move the mouse, utilize the
disks) during the prime generation; this gives the random number
generator a better chance to gain enough entropy.

最后,提示生成完毕。

1
2
gpg: key 0F136FEA marked as ultimately trusted
public and secret key created and signed.

列出密钥

命令如下:

1
gpg --list--keys

输出结果如下:

1
2
3
4
5
/c/Users/Administrator/.gnupg/pubring.gpg
-----------------------------------------
pub 4096R/0F136FEA 2018-12-25
uid xmaihh (xmaihh@protonmail.com) <xmaihh@protonmail.com>
sub 4096R/13FA2C24 2018-12-25

第一行显示公钥文件名(pubring.gpg)
第二行显示公钥特征(4096 位,Hash 字符串和生成时间)
第三行显示用户信息
第四行显示私钥特征

输出密钥

公钥文件(.gnupg/pubring.gpg)以二进制形式储存,armor 参数可以将其转换为 ASCII 码显示。

1
gpg --armor --output public-key.txt --export [密钥ID]

[密钥ID]指定用户的公钥,如 0F136FEA,output 参数指定输出文件名,如 public-key.txt

同时,export-secret-keys 参数可以转换私钥。

1
gpg --armor --output private-key.txt --export-secret-keys

public-key.txt 和 private-key.txt 默认会导出至git bash 当前工作目录下。

上传公钥至Github

点击用户头像,打开 Settings,左侧菜单点击 SSH and GPG keys,在 GPG keys 那里,点击 New GPG key
在输入框里填入刚刚导出的 public-key.txt 内容。
点击 Add GPG key,完成上传。

设置git

回到 Git Bash 窗口,根据刚才 gpg –list-keys 显示的结果,此时已经知道密钥 ID 为 0F136FEA
设置 Git 使用该密钥 ID 加密:

1
git config --global user.signingkey 0F136FEA

设置 Git 全局使用该密钥加密:

1
git config --global commit.gpgsign true

最后,再输入以下命令查看 Git 配置情况:

1
git config -l

可以看到包含以下信息说明设置成功。

1
2
user.signingkey=0F136FEA
commit.gpgsign=true

至此,使用 GPG 加密 Github Commits 就正式完成了。
以后再 Git Commit,同步到 Github 上之后,就会发现该 Commit 已显示 Verified

参考链接:
https://teddysun.com/496.html