서명 키에 대해 Git에 알리기

GitHub Enterprise Server 인스턴스에서 커밋 주체 ID 및 계정과 연결된 확인된 이메일 주소와 일치하는 GPG 키를 사용하는 경우 커밋 서명 및 태그 서명을 시작할 수 있습니다.

여러 GPG 키가 있는 경우 사용할 GPG 키를 Git에 알려야 합니다.

1. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

2. 이전에 --gpg-sign(으)로 서명할 때 다른 키 형식을 사용하도록 Git을 구성한 경우, 이 구성을 설정 해제하면 기본 형식인 openpgp이(가) 사용됩니다.

   git config --global --unset gpg.format
   

3. gpg --list-secret-keys --keyid-format=long 명령을 사용하여 퍼블릭 키와 프라이빗 키가 모두 있는 긴 형식의 GPG 키를 나열합니다. 커밋 또는 태그에 서명하려면 프라이빗 키가 필요합니다.

   Shell

   gpg --list-secret-keys --keyid-format=long
   

   Note

   Linux에서 일부 GPG를 설치하려면 기존 키 목록을 대신 보는 데 gpg2 --list-keys --keyid-format LONG을 사용해야 할 수 있습니다. 이 경우 git config --global gpg.program gpg2를 실행하여 gpg2를 사용할 Git도 구성해야 합니다.

4. 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 <hubot@example.com>
   ssb   4096R/4BB6D45482678BE3 2016-03-10
   

5. Git에서 기본 GPG 서명 키를 설정하려면 아래 텍스트를 붙여넣고 사용하려는 GPG 기본 키 ID로 대체합니다. 이 예제에서 GPG 키 ID는 3AA5C34371567BD2입니다.

   git config --global user.signingkey 3AA5C34371567BD2
   

   또는 하위 키를 사용할 수 있습니다. 이 예제에서 GPG 하위 키 ID는 4BB6D45482678BE3입니다.

   git config --global user.signingkey 4BB6D45482678BE3
   

   여러 키와 하위 키를 사용하는 경우 키에 느낌표 !를 추가하여 Git에게 이것이 선호하는 키임을 알려야 합니다. 경우에 따라 백슬래시 \!로 느낌표를 이스케이프해야 할 수 있습니다.

6. 필요에 따라 기본적으로 모든 커밋과 태그에 서명하도록 Git을 구성하려면 다음 명령을 입력합니다.

   git config --global commit.gpgsign true
   git config --global tag.gpgSign true
   

   자세한 내용은 "커밋 서명"을(를) 참조하세요.

7. GPG 도구 모음을 사용하지 않는 경우 zsh 셸에서 다음 명령을 실행하여 .zshrc파일(있는 경우)에 또는 .zprofile 파일에 GPG 키를 추가합니다.

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

   또는 bash 셸을 사용하는 경우 다음 명령을 실행합니다.

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

8. 필요에 따라 필요한 경우 PIN 또는 암호를 입력하라는 메시지를 표시하려면 pinentry-mac을 설치합니다. 예를 들어 Homebrew 사용하여 다음을 수행합니다.

   brew install pinentry-mac
   echo "pinentry-program $(which pinentry-mac)" >> ~/.gnupg/gpg-agent.conf
   killall gpg-agent
   

Git에 X.509 키에 대해 알리기

smimesign을 사용하여 S/MIME를 통해 커밋 및 태그에 서명할 수 있습니다.

1. smimesign을 설치합니다.

2. Terminal(터미널)Terminal(터미널)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
     

   • 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
     

     커밋한 사람 ID와 일치하는 X.509 키를 사용하는 경우 커밋 및 태그에 서명을 시작할 수 있습니다.

4. 커밋한 사람 ID와 일치하는 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. Git에서 X.509 서명 키를 설정하려면 아래 텍스트를 붙여넣고 이전에 복사한 인증서 ID를 대체합니다.

   • X.509 키를 사용하여 모든 리포지토리에 서명하려면 다음을 수행합니다.

     git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
     

   • X.509 키를 사용하여 단일 리포지토리에 서명하려면 다음을 수행합니다.

     cd  PATH-TO-REPOSITORY
     git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f