告知 Git 您的 GPG 密钥
如果您使用与您的提交者身份和与您在 GitHub.com 上的帐户关联的已验证电子邮件地址匹配的 GPG 密钥,则可以开始签名提交和签名标签。
如果您没有与您的提交者身份匹配的 GPG 密钥,则需要将电子邮件与现有密钥关联。有关更多信息,请参阅“将电子邮件与您的 GPG 密钥关联”。
如果您有多个 GPG 密钥,则需要告诉 Git 使用哪个密钥。
-
打开终端终端Git Bash。
-
如果您之前已将 Git 配置为在使用
--gpg-sign
签名时使用其他密钥格式,请取消设置此配置,以便使用openpgp
的默认格式。git config --global --unset gpg.format
-
使用
gpg --list-secret-keys --keyid-format=long
命令列出您同时拥有公钥和私钥的 GPG 密钥的长格式。签名提交或标签需要私钥。Shell gpg --list-secret-keys --keyid-format=long
gpg --list-secret-keys --keyid-format=long
注意
Linux 上的一些 GPG 安装可能需要您使用
gpg2 --list-keys --keyid-format LONG
来查看现有密钥列表。在这种情况下,您还需要通过运行git config --global gpg.program gpg2
将 Git 配置为使用gpg2
。 -
从 GPG 密钥列表中,复制您想要使用的 GPG 密钥 ID 的长格式。在此示例中,GPG 密钥 ID 为
3AA5C34371567BD2
Shell $ gpg --list-secret-keys --keyid-format=long /Users/hubot/.gnupg/secring.gpg ------------------------------------ sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] uid Hubot <[email protected]> ssb 4096R/4BB6D45482678BE3 2016-03-10
$ gpg --list-secret-keys --keyid-format=long /Users/hubot/.gnupg/secring.gpg ------------------------------------ sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] uid Hubot <[email protected]> ssb 4096R/4BB6D45482678BE3 2016-03-10
-
要在 Git 中设置您的主要 GPG 签名密钥,请粘贴以下文本,并替换您想要使用的 GPG 主密钥 ID。在此示例中,GPG 密钥 ID 为
3AA5C34371567BD2
git config --global user.signingkey 3AA5C34371567BD2
或者,您可能希望使用子密钥。在此示例中,GPG 子密钥 ID 为
4BB6D45482678BE3
git config --global user.signingkey 4BB6D45482678BE3
如果您使用多个密钥和子密钥,则应在密钥后面附加一个感叹号
!
以告诉 git 这是您的首选密钥。有时您可能需要使用反斜杠转义感叹号:\!
。 -
可选地,要将 Git 配置为默认签名所有提交,请输入以下命令
git config --global commit.gpgsign true
有关更多信息,请参阅“签名提交”。
-
如果您未使用 GPG 套件,请在
zsh
shell 中运行以下命令以将 GPG 密钥添加到您的.zshrc
文件(如果存在)或您的.zprofile
文件中$ if [ -r ~/.zshrc ]; then echo -e '\nexport GPG_TTY=$(tty)' >> ~/.zshrc; \ else echo -e '\nexport GPG_TTY=$(tty)' >> ~/.zprofile; fi
或者,如果您使用
bash
shell,请运行此命令$ if [ -r ~/.bash_profile ]; then echo -e '\nexport GPG_TTY=$(tty)' >> ~/.bash_profile; \ else echo -e '\nexport GPG_TTY=$(tty)' >> ~/.profile; fi
-
可选地,要提示您在需要时输入 PIN 或密码短语,请安装
pinentry-mac
。例如,使用Homebrewbrew install pinentry-mac echo "pinentry-program $(which pinentry-mac)" >> ~/.gnupg/gpg-agent.conf killall gpg-agent
如果您使用与您的提交者身份和与您在 GitHub.com 上的帐户关联的已验证电子邮件地址匹配的 GPG 密钥,则可以开始签名提交和签名标签。
如果您没有与您的提交者身份匹配的 GPG 密钥,则需要将电子邮件与现有密钥关联。有关更多信息,请参阅“将电子邮件与您的 GPG 密钥关联”。
如果您有多个 GPG 密钥,则需要告诉 Git 使用哪个密钥。
-
打开终端终端Git Bash。
-
如果您之前已将 Git 配置为在使用
--gpg-sign
签名时使用其他密钥格式,请取消设置此配置,以便使用openpgp
的默认格式。git config --global --unset gpg.format
-
使用
gpg --list-secret-keys --keyid-format=long
命令列出您同时拥有公钥和私钥的 GPG 密钥的长格式。签名提交或标签需要私钥。Shell gpg --list-secret-keys --keyid-format=long
gpg --list-secret-keys --keyid-format=long
注意
Linux 上的一些 GPG 安装可能需要您使用
gpg2 --list-keys --keyid-format LONG
来查看现有密钥列表。在这种情况下,您还需要通过运行git config --global gpg.program gpg2
将 Git 配置为使用gpg2
。 -
从 GPG 密钥列表中,复制您想要使用的 GPG 密钥 ID 的长格式。在此示例中,GPG 密钥 ID 为
3AA5C34371567BD2
Shell $ gpg --list-secret-keys --keyid-format=long /Users/hubot/.gnupg/secring.gpg ------------------------------------ sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] uid Hubot <[email protected]> ssb 4096R/4BB6D45482678BE3 2016-03-10
$ gpg --list-secret-keys --keyid-format=long /Users/hubot/.gnupg/secring.gpg ------------------------------------ sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] uid Hubot <[email protected]> ssb 4096R/4BB6D45482678BE3 2016-03-10
-
要在 Git 中设置您的主要 GPG 签名密钥,请粘贴以下文本,并替换您想要使用的 GPG 主密钥 ID。在此示例中,GPG 密钥 ID 为
3AA5C34371567BD2
git config --global user.signingkey 3AA5C34371567BD2
或者,您可能希望使用子密钥。在此示例中,GPG 子密钥 ID 为
4BB6D45482678BE3
git config --global user.signingkey 4BB6D45482678BE3
如果您使用多个密钥和子密钥,则应在密钥后面附加一个感叹号
!
以告诉 git 这是您的首选密钥。有时您可能需要使用反斜杠转义感叹号:\!
。 -
可选地,要将 Git 配置为默认签名所有提交,请输入以下命令
git config --global commit.gpgsign true
有关更多信息,请参阅“签名提交”。
如果您使用与您的提交者身份和与您在 GitHub.com 上的帐户关联的已验证电子邮件地址匹配的 GPG 密钥,则可以开始签名提交和签名标签。
如果您没有与您的提交者身份匹配的 GPG 密钥,则需要将电子邮件与现有密钥关联。有关更多信息,请参阅“将电子邮件与您的 GPG 密钥关联”。
如果您有多个 GPG 密钥,则需要告诉 Git 使用哪个密钥。
-
打开终端终端Git Bash。
-
如果您之前已将 Git 配置为在使用
--gpg-sign
签名时使用其他密钥格式,请取消设置此配置,以便使用openpgp
的默认格式。git config --global --unset gpg.format
-
使用
gpg --list-secret-keys --keyid-format=long
命令列出您同时拥有公钥和私钥的 GPG 密钥的长格式。签名提交或标签需要私钥。Shell gpg --list-secret-keys --keyid-format=long
gpg --list-secret-keys --keyid-format=long
注意
Linux 上的一些 GPG 安装可能需要您使用
gpg2 --list-keys --keyid-format LONG
来查看现有密钥列表。在这种情况下,您还需要通过运行git config --global gpg.program gpg2
将 Git 配置为使用gpg2
。 -
从 GPG 密钥列表中,复制您想要使用的 GPG 密钥 ID 的长格式。在此示例中,GPG 密钥 ID 为
3AA5C34371567BD2
Shell $ gpg --list-secret-keys --keyid-format=long /Users/hubot/.gnupg/secring.gpg ------------------------------------ sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] uid Hubot <[email protected]> ssb 4096R/4BB6D45482678BE3 2016-03-10
$ gpg --list-secret-keys --keyid-format=long /Users/hubot/.gnupg/secring.gpg ------------------------------------ sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] uid Hubot <[email protected]> ssb 4096R/4BB6D45482678BE3 2016-03-10
-
要在 Git 中设置您的主要 GPG 签名密钥,请粘贴以下文本,并替换您想要使用的 GPG 主密钥 ID。在此示例中,GPG 密钥 ID 为
3AA5C34371567BD2
git config --global user.signingkey 3AA5C34371567BD2
或者,您可能希望使用子密钥。在此示例中,GPG 子密钥 ID 为
4BB6D45482678BE3
git config --global user.signingkey 4BB6D45482678BE3
如果您使用多个密钥和子密钥,则应在密钥后面附加一个感叹号
!
以告诉 git 这是您的首选密钥。有时您可能需要使用反斜杠转义感叹号:\!
。 -
可选地,要将 Git 配置为默认签名所有提交,请输入以下命令
git config --global commit.gpgsign true
有关更多信息,请参阅“签名提交”。
-
要将您的 GPG 密钥添加到您的
.bashrc
启动文件,请运行以下命令[ -f ~/.bashrc ] && echo -e '\nexport GPG_TTY=$(tty)' >> ~/.bashrc
告知 Git 您的 SSH 密钥
您可以使用现有的 SSH 密钥来签名提交和标签,或者专门为签名生成一个新的密钥。有关更多信息,请参阅“生成新的 SSH 密钥并将其添加到 ssh 代理”。
注意
SSH 签名验证功能在 Git 2.34 或更高版本中可用。要更新您的 Git 版本,请访问 Git 网站。
-
打开终端终端Git Bash。
-
配置 Git 使用 SSH 对提交和标签进行签名
git config --global gpg.format ssh
-
要设置 Git 中的 SSH 签名密钥,请粘贴以下文本,并将 /PATH/TO/.SSH/KEY.PUB 替换为您想要使用的公钥的路径。
git config --global user.signingkey /PATH/TO/.SSH/KEY.PUB
告知 Git 您的 X.509 密钥
您可以使用 smimesign 使用 S/MIME 对提交和标签进行签名。
注意
S/MIME 签名验证功能在 Git 2.19 或更高版本中可用。要更新您的 Git 版本,请访问 Git 网站。
-
安装 smimesign。
-
打开终端终端Git Bash。
-
配置 Git 使用 S/MIME 对提交和标签进行签名。在 Git 2.19 或更高版本中,使用
git config gpg.x509.program
和git config gpg.format
命令-
要使用 S/MIME 对所有仓库进行签名
git config --global gpg.x509.program smimesign git config --global gpg.format x509
-
要使用 S/MIME 对单个仓库进行签名
cd PATH-TO-REPOSITORY git config --local gpg.x509.program smimesign git config --local gpg.format x509
在 Git 2.18 或更早版本中,使用
git config gpg.program
命令 -
要使用 S/MIME 对所有仓库进行签名
git config --global gpg.program smimesign
-
要使用 S/MIME 对单个仓库进行签名
cd PATH-TO-REPOSITORY git config --local gpg.program smimesign
如果您使用与您的提交者身份匹配的 X.509 密钥,则可以开始对提交和标签进行签名。
-
-
如果您未使用与您的提交者身份匹配的 X.509 密钥,请使用
smimesign --list-keys
命令列出您同时拥有证书和私钥的 X.509 密钥。smimesign --list-keys
-
从 X.509 密钥列表中,复制您要使用的 X.509 密钥的证书 ID。在此示例中,证书 ID 为
0ff455a2708394633e4bb2f88002e3cd80cbd76f
$ smimesign --list-keys ID: 0ff455a2708394633e4bb2f88002e3cd80cbd76f S/N: a2dfa7e8c9c4d1616f1009c988bb70f Algorithm: SHA256-RSA Validity: 2017-11-22 00:00:00 +0000 UTC - 2020-11-22 12:00:00 +0000 UTC Issuer: CN=DigiCert SHA2 Assured ID CA,OU=www.digicert.com,O=DigiCert Inc,C=US Subject: CN=Octocat,O=GitHub\, Inc.,L=San Francisco,ST=California,C=US Emails: [email protected]
-
要设置 Git 中的 X.509 签名密钥,请粘贴以下文本,并替换为之前复制的证书 ID。
-
要使用您的 X.509 密钥对所有仓库进行签名
git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
-
要使用您的 X.509 密钥对单个仓库进行签名
cd PATH-TO-REPOSITORY git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
-
告知 Git 您的 X.509 密钥
您可以使用 smimesign 使用 S/MIME 对提交和标签进行签名。
注意
S/MIME 签名验证功能在 Git 2.19 或更高版本中可用。要更新您的 Git 版本,请访问 Git 网站。
-
安装 smimesign。
-
打开终端终端Git Bash。
-
配置 Git 使用 S/MIME 对提交和标签进行签名。在 Git 2.19 或更高版本中,使用
git config gpg.x509.program
和git config gpg.format
命令-
要使用 S/MIME 对所有仓库进行签名
git config --global gpg.x509.program smimesign git config --global gpg.format x509
-
要使用 S/MIME 对单个仓库进行签名
cd PATH-TO-REPOSITORY git config --local gpg.x509.program smimesign git config --local gpg.format x509
在 Git 2.18 或更早版本中,使用
git config gpg.program
命令 -
要使用 S/MIME 对所有仓库进行签名
git config --global gpg.program smimesign
-
要使用 S/MIME 对单个仓库进行签名
cd PATH-TO-REPOSITORY git config --local gpg.program smimesign
如果您使用与您的提交者身份匹配的 X.509 密钥,则可以开始对提交和标签进行签名。
-
-
如果您未使用与您的提交者身份匹配的 X.509 密钥,请使用
smimesign --list-keys
命令列出您同时拥有证书和私钥的 X.509 密钥。smimesign --list-keys
-
从 X.509 密钥列表中,复制您要使用的 X.509 密钥的证书 ID。在此示例中,证书 ID 为
0ff455a2708394633e4bb2f88002e3cd80cbd76f
$ smimesign --list-keys ID: 0ff455a2708394633e4bb2f88002e3cd80cbd76f S/N: a2dfa7e8c9c4d1616f1009c988bb70f Algorithm: SHA256-RSA Validity: 2017-11-22 00:00:00 +0000 UTC - 2020-11-22 12:00:00 +0000 UTC Issuer: CN=DigiCert SHA2 Assured ID CA,OU=www.digicert.com,O=DigiCert Inc,C=US Subject: CN=Octocat,O=GitHub\, Inc.,L=San Francisco,ST=California,C=US Emails: [email protected]
-
要设置 Git 中的 X.509 签名密钥,请粘贴以下文本,并替换为之前复制的证书 ID。
-
要使用您的 X.509 密钥对所有仓库进行签名
git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
-
要使用您的 X.509 密钥对单个仓库进行签名
cd PATH-TO-REPOSITORY git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
-
进一步阅读
- "将新的 SSH 密钥添加到您的 GitHub 帐户."
- "签名提交"
- "签名标签"