Git へ署名キーを伝える

Git へ GPG キーを伝える

If you're using a GPG key that matches your committer identity and your verified email address associated with your account on your GitHub Enterprise Server instance, then you can begin signing commits and signing tags.

複数の GPG キーを持っている� �合、どれを使うかを Git に伝える必要があります。

1. ターミナルターミナルGit Bashを開いてく� さい。

2. 公開鍵と秘密鍵をどちらも持っているGPGキーの長い形式のリストを表示するには、 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を使うように設定する必要もあります。

3. GPGキーのリストから、使いたいGPGキーIDの長い形式をコピーしてく� さい。 この例では、GPG キー ID は 3AA5C34371567BD2 です。

   $ gpg --list-secret-keys --keyid-format=long
   /Users/hubot/.gnupg/secring.gpg
   ------------------------------------
   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
   uid                          Hubot 
   ssb   4096R/42B317FD4BA89E7A 2016-03-10

4. GitでGPG署名キーを設定するには、以下のテキストを使いたいGPGキーIDに置き換えて貼り付けてく� さい。 この例では、GPG キー ID は 3AA5C34371567BD2 です。

   $ git config --global user.signingkey 3AA5C34371567BD2

5. GPG スイートを使用していない� �合は、zsh シェルで次のコマンドを実行して、GPG キーがある� �合に .zshrc ファイル、または .zprofile ファイルに追� します。

   $ if [ -r ~/.zshrc ]; then echo 'export GPG_TTY=$(tty)' >> ~/.zshrc; \
     else echo 'export GPG_TTY=$(tty)' >> ~/.zprofile; fi

   または、bash シェルを使用する� �合は、次のコマンドを実行します。

   $ if [ -r ~/.bash_profile ]; then echo 'export GPG_TTY=$(tty)' >> ~/.bash_profile; \
     else echo 'export GPG_TTY=$(tty)' >> ~/.profile; fi

Git にX.509 キーについて知らせる

GPGではなくS/MIMEを使ってコミットやタグに署名するために、smimesignを使うことができます。

1. smimesignをインストールしてく� さい。
2. ターミナルターミナルGit Bashを開いてく� さい。
3. コミットやタグの署名にS/MIMEを使うようGitを設定してく� さい。 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

• 1つのリポジトリへの署名にS/MIMEを使うには以下のようにします。

  $ cd /path/to/my/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

• 1つのリポジトリへの署名にS/MIMEを使うには以下のようにします。

  $ cd /path/to/my/repository
  $ git config --local gpg.program smimesign

  自分のコミッタアイデンティティにマッチにするX.509キーを使っているなら、コミットやタグへの署名を始められます。

4. コミッタアイデンティティにマッチしているX.509キーを使っていないなら、smimesign --list-keysコマンドを使って証明書と秘密鍵の両方を持っているX.509キーのリストを取ってく� さい。

   $ smimesign --list-keys

5. 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: octocat@github.com

6. X.509署名キーをGitに設定するには、証明書IDをさきほどコピーしたものに置き換えて以下のテキストを貼り付けてく� さい。

• すべてのリポジトリへの署名にX.509キーを使うには以下のようにします。

  $ git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f

• 1つのリポジトリへの署名にX.509キーを使うには以下のようにします。

  $ cd /path/to/my/repository
  $ git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f