{"meta":{"title":"将您的签名密钥告知 Git","intro":"要在本地对提交进行签名，需要向 Git 通知要使用的 GPG、SSH 或 X.509 密钥。","product":"身份验证","breadcrumbs":[{"href":"/zh/authentication","title":"身份验证"},{"href":"/zh/authentication/managing-commit-signature-verification","title":"验证提交签名"},{"href":"/zh/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key","title":"将你的签名密钥告诉 Git"}],"documentType":"article"},"body":"# 将您的签名密钥告知 Git\n\n要在本地对提交进行签名，需要向 Git 通知要使用的 GPG、SSH 或 X.509 密钥。\n\n## 将您的 GPG 密钥告知 Git\n\n<div class=\"ghd-tool mac\">\n\n如果使用与你的提交者身份以及 GitHub.com 上帐户关联的已验证电子邮件地址相匹配的 GPG 密钥，则可以开始对提交和标签进行签名。\n\n> \\[!NOTE]\n> 如果您没有与提交者身份匹配的 GPG 密钥，则需要将电子邮件与现有密钥关联。 有关详细信息，请参阅“[将电子邮件与 GPG 密钥关联](/zh/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key)”。\n\n如果您有多个 GPG 密钥，则需要告知 Git 要使用哪一个。\n\n1. 打开<span class=\"platform-mac\">终端</span><span class=\"platform-linux\">终端</span><span class=\"platform-windows\">Git Bash</span>。\n\n2. 如果之前已将 Git 配置为在使用 `--gpg-sign` 签名时使用不同的密钥格式，请取消设置此配置，以便使用默认 `openpgp` 格式。\n\n   ```shell\n   git config --global --unset gpg.format\n   ```\n\n3. 使用 `gpg --list-secret-keys --keyid-format=long` 命令列出你拥有其公钥和私钥的长形式 GPG 密钥。 签名提交或标记需要私钥。\n\n   ```shell copy\n   gpg --list-secret-keys --keyid-format=long\n   ```\n\n   > \\[!NOTE]\n   > Linux 上的某些 GPG 安装可能需要改用 `gpg2 --list-keys --keyid-format LONG` 查看现有密钥的列表。 在这种情况下，还需要通过运行 `git config --global gpg.program gpg2` 来配置 Git 以使用 `gpg2`。\n\n4. 从 GPG 密钥列表中复制您想要使用的 GPG 密钥 ID 的长形式。 在本例中，GPG 密钥 ID 为 `3AA5C34371567BD2`：\n\n   ```shell copy\n   $ gpg --list-secret-keys --keyid-format=long\n   /Users/hubot/.gnupg/secring.gpg\n   ------------------------------------\n   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]\n   uid                          Hubot <hubot@example.com>\n   ssb   4096R/4BB6D45482678BE3 2016-03-10\n   ```\n\n5. 若要在 Git 中设置 GPG 签名主键，请粘贴下面的文本，替换要使用的 GPG 主键 ID。 在本例中，GPG 密钥 ID 为 `3AA5C34371567BD2`：\n\n   ```shell\n   git config --global user.signingkey 3AA5C34371567BD2\n   ```\n\n   或者，你可能想要使用子键。 在本例中，GPG 子键 ID 为 `4BB6D45482678BE3`：\n\n   ```shell\n   git config --global user.signingkey 4BB6D45482678BE3\n   ```\n\n   如果使用多个键和子键，则应向键追加感叹号 `!`，告知 git 这是首选键。 有时，可能需要用反斜杠来转义感叹号：`\\!`。\n\n6. （可选）若要将 Git 配置为默认对所有提交和标记进行签名，请输入以下命令：\n\n   ```shell\n   git config --global commit.gpgsign true\n   git config --global tag.gpgSign true\n   ```\n\n   有关详细信息，请参阅“[对提交签名](/zh/authentication/managing-commit-signature-verification/signing-commits)”。\n\n7. 如果没有使用 GPG 套件，请在 `zsh` shell 中运行以下命令，将 GPG 密钥添加到 `.zshrc` 文件（如果存在）或 `.zprofile` 文件：\n\n   ```shell\n   $ if [ -r ~/.zshrc ]; then echo -e '\\nexport GPG_TTY=$(tty)' >> ~/.zshrc; \\\n     else echo -e '\\nexport GPG_TTY=$(tty)' >> ~/.zprofile; fi\n   ```\n\n   或者，如果使用 `bash` shell，请运行以下命令：\n\n   ```shell\n   $ if [ -r ~/.bash_profile ]; then echo -e '\\nexport GPG_TTY=$(tty)' >> ~/.bash_profile; \\\n     else echo -e '\\nexport GPG_TTY=$(tty)' >> ~/.profile; fi\n   ```\n\n8. （可选）若要在需要时提示你输入 PIN 或密码，请安装 `pinentry-mac`。 例如，使用 [Homebrew](https://brew.sh/)：\n\n   ```shell\n   brew install pinentry-mac\n   echo \"pinentry-program $(which pinentry-mac)\" >> ~/.gnupg/gpg-agent.conf\n   killall gpg-agent\n   ```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\n如果使用与你的提交者身份以及 GitHub.com 上帐户关联的已验证电子邮件地址相匹配的 GPG 密钥，则可以开始对提交和标签进行签名。\n\n> \\[!NOTE]\n> 如果您没有与提交者身份匹配的 GPG 密钥，则需要将电子邮件与现有密钥关联。 有关详细信息，请参阅“[将电子邮件与 GPG 密钥关联](/zh/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key)”。\n\n如果您有多个 GPG 密钥，则需要告知 Git 要使用哪一个。\n\n1. 打开<span class=\"platform-mac\">终端</span><span class=\"platform-linux\">终端</span><span class=\"platform-windows\">Git Bash</span>。\n2. 如果之前已将 Git 配置为在使用 `--gpg-sign` 签名时使用不同的密钥格式，请取消设置此配置，以便使用默认 `openpgp` 格式。\n\n   ```shell\n   git config --global --unset gpg.format\n   ```\n3. 使用 `gpg --list-secret-keys --keyid-format=long` 命令列出你拥有其公钥和私钥的长形式 GPG 密钥。 签名提交或标记需要私钥。\n\n   ```shell copy\n   gpg --list-secret-keys --keyid-format=long\n   ```\n\n   > \\[!NOTE]\n   > Linux 上的某些 GPG 安装可能需要改用 `gpg2 --list-keys --keyid-format LONG` 查看现有密钥的列表。 在这种情况下，还需要通过运行 `git config --global gpg.program gpg2` 来配置 Git 以使用 `gpg2`。\n4. 从 GPG 密钥列表中复制您想要使用的 GPG 密钥 ID 的长形式。 在本例中，GPG 密钥 ID 为 `3AA5C34371567BD2`：\n\n   ```shell copy\n   $ gpg --list-secret-keys --keyid-format=long\n   /Users/hubot/.gnupg/secring.gpg\n   ------------------------------------\n   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]\n   uid                          Hubot <hubot@example.com>\n   ssb   4096R/4BB6D45482678BE3 2016-03-10\n   ```\n5. 若要在 Git 中设置 GPG 签名主键，请粘贴下面的文本，替换要使用的 GPG 主键 ID。 在本例中，GPG 密钥 ID 为 `3AA5C34371567BD2`：\n\n   ```shell\n   git config --global user.signingkey 3AA5C34371567BD2\n   ```\n\n   或者，你可能想要使用子键。 在本例中，GPG 子键 ID 为 `4BB6D45482678BE3`：\n\n   ```shell\n   git config --global user.signingkey 4BB6D45482678BE3\n   ```\n\n   如果使用多个键和子键，则应向键追加感叹号 `!`，告知 git 这是首选键。 有时，可能需要用反斜杠来转义感叹号：`\\!`。\n6. （可选）若要将 Git 配置为默认对所有提交和标记进行签名，请输入以下命令：\n\n   ```shell\n   git config --global commit.gpgsign true\n   git config --global tag.gpgSign true\n   ```\n\n   有关详细信息，请参阅“[对提交签名](/zh/authentication/managing-commit-signature-verification/signing-commits)”。\n\n</div>\n\n<div class=\"ghd-tool linux\">\n\n如果使用与你的提交者身份以及 GitHub.com 上帐户关联的已验证电子邮件地址相匹配的 GPG 密钥，则可以开始对提交和标签进行签名。\n\n> \\[!NOTE]\n> 如果您没有与提交者身份匹配的 GPG 密钥，则需要将电子邮件与现有密钥关联。 有关详细信息，请参阅“[将电子邮件与 GPG 密钥关联](/zh/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key)”。\n\n如果您有多个 GPG 密钥，则需要告知 Git 要使用哪一个。\n\n1. 打开<span class=\"platform-mac\">终端</span><span class=\"platform-linux\">终端</span><span class=\"platform-windows\">Git Bash</span>。\n2. 如果之前已将 Git 配置为在使用 `--gpg-sign` 签名时使用不同的密钥格式，请取消设置此配置，以便使用默认 `openpgp` 格式。\n\n   ```shell\n   git config --global --unset gpg.format\n   ```\n3. 使用 `gpg --list-secret-keys --keyid-format=long` 命令列出你拥有其公钥和私钥的长形式 GPG 密钥。 签名提交或标记需要私钥。\n\n   ```shell copy\n   gpg --list-secret-keys --keyid-format=long\n   ```\n\n   > \\[!NOTE]\n   > Linux 上的某些 GPG 安装可能需要改用 `gpg2 --list-keys --keyid-format LONG` 查看现有密钥的列表。 在这种情况下，还需要通过运行 `git config --global gpg.program gpg2` 来配置 Git 以使用 `gpg2`。\n4. 从 GPG 密钥列表中复制您想要使用的 GPG 密钥 ID 的长形式。 在本例中，GPG 密钥 ID 为 `3AA5C34371567BD2`：\n\n   ```shell copy\n   $ gpg --list-secret-keys --keyid-format=long\n   /Users/hubot/.gnupg/secring.gpg\n   ------------------------------------\n   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]\n   uid                          Hubot <hubot@example.com>\n   ssb   4096R/4BB6D45482678BE3 2016-03-10\n   ```\n5. 若要在 Git 中设置 GPG 签名主键，请粘贴下面的文本，替换要使用的 GPG 主键 ID。 在本例中，GPG 密钥 ID 为 `3AA5C34371567BD2`：\n\n   ```shell\n   git config --global user.signingkey 3AA5C34371567BD2\n   ```\n\n   或者，你可能想要使用子键。 在本例中，GPG 子键 ID 为 `4BB6D45482678BE3`：\n\n   ```shell\n   git config --global user.signingkey 4BB6D45482678BE3\n   ```\n\n   如果使用多个键和子键，则应向键追加感叹号 `!`，告知 git 这是首选键。 有时，可能需要用反斜杠来转义感叹号：`\\!`。\n6. （可选）若要将 Git 配置为默认对所有提交和标记进行签名，请输入以下命令：\n\n   ```shell\n   git config --global commit.gpgsign true\n   git config --global tag.gpgSign true\n   ```\n\n   有关详细信息，请参阅“[对提交签名](/zh/authentication/managing-commit-signature-verification/signing-commits)”。\n7. 若要将 GPG 密钥添加到 `.bashrc` 启动文件，请运行以下命令：\n\n   ```bash\n   [ -f ~/.bashrc ] && echo -e '\\nexport GPG_TTY=$(tty)' >> ~/.bashrc\n   ```\n\n</div>\n\n## 将 SSH 密钥告知 Git\n\n可以使用现有 SSH 密钥对提交和标记进行签名，或生成专用于签名的新密钥。 有关详细信息，请参阅“[生成新的 SSH 密钥并将其添加到 ssh-agent](/zh/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)”。\n\n> \\[!NOTE]\n> SSH 签名验证可用于 Git 2.34 或更高版本。 若要更新 Git 版本，请参阅 [Git](https://git-scm.com/downloads) 网站。\n\n1. 打开<span class=\"platform-mac\">终端</span><span class=\"platform-linux\">终端</span><span class=\"platform-windows\">Git Bash</span>。\n2. 配置 Git 使用 SSH 对提交和标记签名：\n\n   ```bash\n   git config --global gpg.format ssh\n   ```\n3. 若要在 Git 中设置 SSH 签名密钥，请粘贴下面的文本，将 **/PATH/TO/.SSH/KEY.PUB** 替换为要使用的公钥路径。\n\n   ```bash\n   git config --global user.signingkey /PATH/TO/.SSH/KEY.PUB\n   ```\n\n<div class=\"ghd-tool windows\">\n\n## 将您的 X.509 密钥告知 Git\n\n可通过 S/MIME 使用 [smimesign](https://github.com/github/smimesign) 对提交和标记进行签名。\n\n> \\[!NOTE]\n> S/MIME 签名验证可用于 Git 2.19 或更高版本。 若要更新 Git 版本，请参阅 [Git](https://git-scm.com/downloads) 网站。\n\n1. 安装 [smimesign](https://github.com/github/smimesign#installation)。\n\n2. 打开<span class=\"platform-mac\">终端</span><span class=\"platform-linux\">终端</span><span class=\"platform-windows\">Git Bash</span>。\n\n3. 配置 Git 使用 S/MIME 对提交和标记签名。 在 Git 2.19 或更高版本中，使用 `git config gpg.x509.program` 和 `git config gpg.format` 命令：\n   * 要使用 S/MIME 对所有仓库签名：\n\n     ```shell\n     git config --global gpg.x509.program smimesign\n     git config --global gpg.format x509\n     ```\n\n   * 要使用 S/MIME 对单一仓库签名：\n\n     ```shell\n     cd PATH-TO-REPOSITORY\n     git config --local gpg.x509.program smimesign\n     git config --local gpg.format x509\n     ```\n\n     在 Git 2.18 或更低版本中，使用 `git config gpg.program` 命令：\n\n   * 要使用 S/MIME 对所有仓库签名：\n\n     ```shell\n     git config --global gpg.program smimesign\n     ```\n\n   * 要使用 S/MIME 对单一仓库签名：\n\n     ```shell\n     cd  PATH-TO-REPOSITORY\n     git config --local gpg.program smimesign\n     ```\n\n     如果您使用的是与提交者身份匹配的 X.509 密钥，您可以开始对提交和标记签名。\n\n4. 如果你使用的不是与提交者标识匹配的 X.509 密钥，则使用 `smimesign --list-keys` 命令列出你有其证书和私钥的 X.509 密钥。\n\n   ```shell\n   smimesign --list-keys\n   ```\n\n5. 从 X.509 密钥列表中复制您想要使用的 X.509 密钥的证书 ID。 在本示例中，客户端 ID 为 `0ff455a2708394633e4bb2f88002e3cd80cbd76f`：\n\n   ```shell\n   $ smimesign --list-keys\n                ID: 0ff455a2708394633e4bb2f88002e3cd80cbd76f\n               S/N: a2dfa7e8c9c4d1616f1009c988bb70f\n         Algorithm: SHA256-RSA\n          Validity: 2017-11-22 00:00:00 +0000 UTC - 2020-11-22 12:00:00 +0000 UTC\n            Issuer: CN=DigiCert SHA2 Assured ID CA,OU=www.digicert.com,O=DigiCert Inc,C=US\n           Subject: CN=Octocat,O=GitHub\\, Inc.,L=San Francisco,ST=California,C=US\n            Emails: octocat@github.com\n   ```\n\n6. 要在 Git 中设置您的 X.509 签名密钥，请粘贴下面的文本，替换之前复制的证书 ID 。\n   * 要使用 X.509 密钥注册所有仓库：\n\n     ```shell\n     git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f\n     ```\n\n   * 要使用 X.509 密钥注册单一仓库：\n\n     ```shell\n     cd  PATH-TO-REPOSITORY\n     git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f\n     ```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\n## 将您的 X.509 密钥告知 Git\n\n可通过 S/MIME 使用 [smimesign](https://github.com/github/smimesign) 对提交和标记进行签名。\n\n> \\[!NOTE]\n> S/MIME 签名验证可用于 Git 2.19 或更高版本。 若要更新 Git 版本，请参阅 [Git](https://git-scm.com/downloads) 网站。\n\n1. 安装 [smimesign](https://github.com/github/smimesign#installation)。\n\n2. 打开<span class=\"platform-mac\">终端</span><span class=\"platform-linux\">终端</span><span class=\"platform-windows\">Git Bash</span>。\n\n3. 配置 Git 使用 S/MIME 对提交和标记签名。 在 Git 2.19 或更高版本中，使用 `git config gpg.x509.program` 和 `git config gpg.format` 命令：\n   * 要使用 S/MIME 对所有仓库签名：\n\n     ```shell\n     git config --global gpg.x509.program smimesign\n     git config --global gpg.format x509\n     ```\n\n   * 要使用 S/MIME 对单一仓库签名：\n\n     ```shell\n     cd PATH-TO-REPOSITORY\n     git config --local gpg.x509.program smimesign\n     git config --local gpg.format x509\n     ```\n\n     在 Git 2.18 或更低版本中，使用 `git config gpg.program` 命令：\n\n   * 要使用 S/MIME 对所有仓库签名：\n\n     ```shell\n     git config --global gpg.program smimesign\n     ```\n\n   * 要使用 S/MIME 对单一仓库签名：\n\n     ```shell\n     cd  PATH-TO-REPOSITORY\n     git config --local gpg.program smimesign\n     ```\n\n     如果您使用的是与提交者身份匹配的 X.509 密钥，您可以开始对提交和标记签名。\n\n4. 如果你使用的不是与提交者标识匹配的 X.509 密钥，则使用 `smimesign --list-keys` 命令列出你有其证书和私钥的 X.509 密钥。\n\n   ```shell\n   smimesign --list-keys\n   ```\n\n5. 从 X.509 密钥列表中复制您想要使用的 X.509 密钥的证书 ID。 在本示例中，客户端 ID 为 `0ff455a2708394633e4bb2f88002e3cd80cbd76f`：\n\n   ```shell\n   $ smimesign --list-keys\n                ID: 0ff455a2708394633e4bb2f88002e3cd80cbd76f\n               S/N: a2dfa7e8c9c4d1616f1009c988bb70f\n         Algorithm: SHA256-RSA\n          Validity: 2017-11-22 00:00:00 +0000 UTC - 2020-11-22 12:00:00 +0000 UTC\n            Issuer: CN=DigiCert SHA2 Assured ID CA,OU=www.digicert.com,O=DigiCert Inc,C=US\n           Subject: CN=Octocat,O=GitHub\\, Inc.,L=San Francisco,ST=California,C=US\n            Emails: octocat@github.com\n   ```\n\n6. 要在 Git 中设置您的 X.509 签名密钥，请粘贴下面的文本，替换之前复制的证书 ID 。\n   * 要使用 X.509 密钥注册所有仓库：\n\n     ```shell\n     git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f\n     ```\n\n   * 要使用 X.509 密钥注册单一仓库：\n\n     ```shell\n     cd  PATH-TO-REPOSITORY\n     git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f\n     ```\n\n</div>\n\n## 其他阅读材料\n\n* [将新的 SSH 密钥添加到GitHub帐户](/zh/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)。\n* [对提交签名](/zh/authentication/managing-commit-signature-verification/signing-commits)\n* [对标记签名](/zh/authentication/managing-commit-signature-verification/signing-tags)"}