日本語 ▾ トピック ▾ 最新バージョン ▾ gitformat-signature は 2.40.0 で最終更新されました

名前

gitformat-signature - Gitの暗号署名フォーマット

概要

<[tag|commit] object header(s)>
<over-the-wire protocol>

説明

Gitは、さまざまな箇所で暗号署名を使用します。現在、オブジェクト（タグ、コミット、マージタグ）およびトランザクション（プッシュ）で使用されています。いずれの場合も、オブジェクトまたはトランザクションを作成しようとしているコマンドは、そこからペイロードを決定し、外部プログラムを呼び出してそのペイロードの分離署名（PGP署名の場合はgpg -bsa）を取得し、その署名をオブジェクトまたはトランザクションに埋め込みます。

署名は「ASCII Armor」ヘッダー行で始まり、署名タイプ（gpg.formatで選択、git-config[1]を参照）に応じて異なる末尾行で終わります。これらは、gpg.formatの値に応じて以下のようになります。

gpg (PGP)

-----BEGIN PGP SIGNATURE----- と -----END PGP SIGNATURE-----。または、gpgにRFC1991署名を作成するように指示した場合、-----BEGIN PGP MESSAGE----- と -----END PGP MESSAGE-----

ssh (SSH)

-----BEGIN SSH SIGNATURE----- と -----END SSH SIGNATURE-----

x509 (X.509)

-----BEGIN SIGNED MESSAGE----- と -----END SIGNED MESSAGE-----

署名は、通常のペイロードの一部として現れることもあれば（例：署名されたタグには、署名が適用されるペイロードの後に署名ブロックが追加される）、オブジェクトヘッダーの値として現れることもあります（例：署名されたタグをマージしたマージコミットは、「mergetag」ヘッダーにタグの内容全体を持つことになります）。後者の場合、オブジェクトヘッダーの通常の複数行フォーマットルールが適用されます。つまり、2行目以降の行には、その行が前の行から続いていることを示すSPがプレフィックスとして付けられます。

これは、元々空の行でも同様です。以下の例では、空白文字で終わる行の末尾に$記号がハイライトされています。これらの例を手作業で再現しようとする場合は、コピー＆ペーストしないでください。これらは主に、一部の行の末尾にある余分な空白を強調するためにそこにあります。

署名されたペイロードと署名の埋め込み方法は、オブジェクトまたはトランザクションのタイプに依存します。

タグ署名

  • 作成者: git tag -s

  • ペイロード: 注釈付きタグオブジェクト

  • 埋め込み: 未署名のタグオブジェクトに署名を追加する

  • 例: サブジェクトがsigned tagのタグsignedtag

object 04b871796dc0420f8e7561a895b52484b701d51a
type commit
tag signedtag
tagger C O Mitter <committer@example.com> 1465981006 +0000

signed tag

signed tag message body
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQEcBAABAgAGBQJXYRhOAAoJEGEJLoW3InGJklkIAIcnhL7RwEb/+QeX9enkXhxn
rxfdqrvWd1K80sl2TOt8Bg/NYwrUBw/RWJ+sg/hhHp4WtvE1HDGHlkEz3y11Lkuh
8tSxS3qKTxXUGozyPGuE90sJfExhZlW4knIQ1wt/yWqM+33E9pN4hzPqLwyrdods
q8FWEqPPUbSJXoMbRPw04S5jrLtZSsUWbRYjmJCHzlhSfFWW4eFd37uquIaLUBS0
rkC3Jrx7420jkIpgFcTI2s60uhSQLzgcCwdA2ukSYIRnjg/zDkj8+3h/GaROJ72x
lZyI6HWixKJkWw8lE9aAOD9TmTW9sFJwcVAzmAuFX2kUreDUKMZduGcoRYGpD7E=
=jpXa
-----END PGP SIGNATURE-----

  • 検証方法: git verify-tag [-v] または git tag -v

gpg: Signature made Wed Jun 15 10:56:46 2016 CEST using RSA key ID B7227189
gpg: Good signature from "Eris Discordia <discord@example.net>"
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: D4BE 2231 1AD3 131E 5EDA  29A4 6109 2E85 B722 7189
object 04b871796dc0420f8e7561a895b52484b701d51a
type commit
tag signedtag
tagger C O Mitter <committer@example.com> 1465981006 +0000

signed tag

signed tag message body

コミット署名

  • 作成者: git commit -S

  • ペイロード: コミットオブジェクト

  • 埋め込み: ヘッダーエントリgpgsig (コンテンツの前にスペースが付く)

  • 例: サブジェクトがsigned commitのコミット

tree eebfed94e75e7760540d1485c740902590a00332
parent 04b871796dc0420f8e7561a895b52484b701d51a
author A U Thor <author@example.com> 1465981137 +0000
committer C O Mitter <committer@example.com> 1465981137 +0000
gpgsig -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1
 $
 iQEcBAABAgAGBQJXYRjRAAoJEGEJLoW3InGJ3IwIAIY4SA6GxY3BjL60YyvsJPh/
 HRCJwH+w7wt3Yc/9/bW2F+gF72kdHOOs2jfv+OZhq0q4OAN6fvVSczISY/82LpS7
 DVdMQj2/YcHDT4xrDNBnXnviDO9G7am/9OE77kEbXrp7QPxvhjkicHNwy2rEflAA
 zn075rtEERDHr8nRYiDh8eVrefSO7D+bdQ7gv+7GsYMsd2auJWi1dHOSfTr9HIF4
 HJhWXT9d2f8W+diRYXGh4X0wYiGg6na/soXc+vdtDYBzIxanRqjg8jCAeo1eOTk1
 EdTwhcTZlI0x5pvJ3H0+4hA2jtldVtmPM4OTB0cTrEWBad7XV6YgiyuII73Ve3I=
 =jKHM
 -----END PGP SIGNATURE-----

signed commit

signed commit message body

  • 検証方法: git verify-commit [-v] (または git show --show-signature)

gpg: Signature made Wed Jun 15 10:58:57 2016 CEST using RSA key ID B7227189
gpg: Good signature from "Eris Discordia <discord@example.net>"
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: D4BE 2231 1AD3 131E 5EDA  29A4 6109 2E85 B722 7189
tree eebfed94e75e7760540d1485c740902590a00332
parent 04b871796dc0420f8e7561a895b52484b701d51a
author A U Thor <author@example.com> 1465981137 +0000
committer C O Mitter <committer@example.com> 1465981137 +0000

signed commit

signed commit message body

マージタグ署名

  • 作成者: 署名済みタグに対するgit merge

  • ペイロード/埋め込み: 署名済みのタグオブジェクト全体が、ヘッダーエントリmergetagとして(マージ)コミットオブジェクトに埋め込まれる

  • 例: 上記の署名済みタグsignedtagのマージ

tree c7b1cff039a93f3600a1d18b82d26688668c7dea
parent c33429be94b5f2d3ee9b0adad223f877f174b05d
parent 04b871796dc0420f8e7561a895b52484b701d51a
author A U Thor <author@example.com> 1465982009 +0000
committer C O Mitter <committer@example.com> 1465982009 +0000
mergetag object 04b871796dc0420f8e7561a895b52484b701d51a
 type commit
 tag signedtag
 tagger C O Mitter <committer@example.com> 1465981006 +0000
 $
 signed tag
 $
 signed tag message body
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1
 $
 iQEcBAABAgAGBQJXYRhOAAoJEGEJLoW3InGJklkIAIcnhL7RwEb/+QeX9enkXhxn
 rxfdqrvWd1K80sl2TOt8Bg/NYwrUBw/RWJ+sg/hhHp4WtvE1HDGHlkEz3y11Lkuh
 8tSxS3qKTxXUGozyPGuE90sJfExhZlW4knIQ1wt/yWqM+33E9pN4hzPqLwyrdods
 q8FWEqPPUbSJXoMbRPw04S5jrLtZSsUWbRYjmJCHzlhSfFWW4eFd37uquIaLUBS0
 rkC3Jrx7420jkIpgFcTI2s60uhSQLzgcCwdA2ukSYIRnjg/zDkj8+3h/GaROJ72x
 lZyI6HWixKJkWw8lE9aAOD9TmTW9sFJwcVAzmAuFX2kUreDUKMZduGcoRYGpD7E=
 =jpXa
 -----END PGP SIGNATURE-----

Merge tag 'signedtag' into downstream

signed tag

signed tag message body

# gpg: Signature made Wed Jun 15 08:56:46 2016 UTC using RSA key ID B7227189
# gpg: Good signature from "Eris Discordia <discord@example.net>"
# gpg: WARNING: This key is not certified with a trusted signature!
# gpg:          There is no indication that the signature belongs to the owner.
# Primary key fingerprint: D4BE 2231 1AD3 131E 5EDA  29A4 6109 2E85 B722 7189

  • 検証方法: 検証はデフォルトでマージコミットメッセージに埋め込まれています。別の方法としてgit show --show-signatureを使用することもできます

commit 9863f0c76ff78712b6800e199a46aa56afbcbd49
merged tag 'signedtag'
gpg: Signature made Wed Jun 15 10:56:46 2016 CEST using RSA key ID B7227189
gpg: Good signature from "Eris Discordia <discord@example.net>"
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: D4BE 2231 1AD3 131E 5EDA  29A4 6109 2E85 B722 7189
Merge: c33429b 04b8717
Author: A U Thor <author@example.com>
Date:   Wed Jun 15 09:13:29 2016 +0000

    Merge tag 'signedtag' into downstream

    signed tag

    signed tag message body

    # gpg: Signature made Wed Jun 15 08:56:46 2016 UTC using RSA key ID B7227189
    # gpg: Good signature from "Eris Discordia <discord@example.net>"
    # gpg: WARNING: This key is not certified with a trusted signature!
    # gpg:          There is no indication that the signature belongs to the owner.
    # Primary key fingerprint: D4BE 2231 1AD3 131E 5EDA  29A4 6109 2E85 B722 7189

GIT

git[1] スイートの一部

scroll-to-top