Gitの「オプション終了」フラグ --end-of-options
git's –end-of-options Flag (nesbitt.io)
要約
Gitのあまり知られていない「--end-of-options」フラグは、コマンドライン引数におけるセキュリティ上の脆弱性、特に引数インジェクションを防ぐために導入されました。このフラグは、オプション解析とリビジョンやパス指定を明確に区別するために使用され、パッケージマネージャーなどが外部からの信頼できない入力を安全に処理する上で重要です。
全文翻訳
--end-of-options
先週、あるパッケージマネージャーの CVE の修正を読んでいた際に、これまで気づかなかった git のフラグ --end-of-options に遭遇しました。最初は LLM が生成した幻覚かと思いましたが、gitcli(7) に文書化されており、2019年11月の git 2.24.0 で追加されたもので、git が既に -- を別の目的で使用していたために存在します。
ほとんどの Unix ツールでは、-- はオプション解析の終端を示します。例えば rm -- -f は、force フラグを渡すのではなく、-f という名前のファイルを削除します。git は早期に -- をリビジョンとパススペシファイアの区切りに再利用しました。これは、git log foo がブランチ名 foo とファイル名 foo のどちらを指すのか曖昧だったため、どちらか一方を区別するためのマーカーが必要だったからです。例えば git log main -- README.md は、そのファイルに触れた main のコミットを意味します。これにより、リビジョン位置の終端マーカーがなくなったため、スクリプトが git log "$rev" を実行し、$rev がダッシュで始まる場合、git はそれをオプションとして解析してしまいます。
--end-of-options を導入したコミットによると、
しかし、リビジョンパーサーにとってはそれは機能しません。なぜなら
--は既にそこで意味を持っているからです。それはリビジョンとパススペシファイアを区切ります。したがって、オプションとリビジョンを区切るには別のマーカーが必要です。
-- と --end-of-options は git において異なるものであり、それらを互換性があるものとして扱うのは、私が既にいくつかの場所で見かけた間違いです。git clone -- "$url" のように URL の前に -- を置くことは、clone が POSIX 規約に従っているため機能します。git checkout "$ref" -- のようにリファレンスの後に -- を付けると、$ref はファイル名ではなくリビジョンとしてマークされますが、それでも最初にオプションとして読み取られる可能性があります。信頼できないリビジョンを安全に渡すには、git log --end-of-options "$rev" -- "$path" と記述する必要があります。この場合、両方のマーカーが別々の役割を果たします。
新しいフラグのサポートは、一度にすべてではなく、サブコマンドごとに到着しました。git rev-parse は、2.30.0 でのみサポートされました。これは、独自の引数パーサーを持っているため、最初のリリースから1年後でした。また、git checkout と git reset は、2.43.1 までこれを拒否していました(2024年2月)。これは、それらが -- を自身で解析し、最初の実装では --end-of-options がそれらのパーサーによって拒否される引数リストに残っていたためです。
引数インジェクション
Git、hg、ssh はすべて、呼び出し元が指定したコマンドを実行するという文書化された目的を持つオプションを提供しています。git clone は、サーバー側のバイナリを指定するために --upload-pack=<cmd> を受け入れ、任意の git 呼び出しは、接続方法をオーバーライドするために -c core.sshCommand=<cmd> を受け入れます。Mercurial は、任意のサブコマンドで --config=alias.<subcmd>=!<shell> を受け入れ、実行しているサブコマンドを任意のシェルスクリプトとして再定義します。ssh は -oProxyCommand=<cmd> を受け入れます。これらは文書化された機能ですが、ラッパープログラムが信頼できない文字列を引数リストに渡すと、攻撃プリミティブになります。
この失敗モードには独自の CWE、CWE-88 引数インジェクションがありますが、これはコマンドインジェクションとは異なります。なぜなら、シェルが関与しないからです。ラッパープログラムは argv 配列を構築し、exec を直接呼び出します。これは、「system() を使用しない」というすべてのガイドが推奨する方法であり、配列はそのまま git に到達し、git はその引数の1つがダッシュで始まるため、それをオプションとして解析します。docker build におけるCVE-2019-13139 は、クリーンな例です。Go の os/exec パッケージ、argv 配列、シェルなし、そして #ref:dir フラグメントを持つ git コンテキスト URL が、--upload-pack=<cmd> として git fetch origin <ref> に到達しました。
このパターンは、2017年8月に4つのバージョン管理システムで同時に実証されました。その日、CVE-2017-1000117 (git)、CVE-2017-1000116 (Mercurial)、CVE-2017-9800 (Subversion)、およびCVE-2017-12836 (CVS) が開示されました。それぞれが URL のホスト名を ssh に引数として渡し、-oProxyCommand= で始まるホスト名は ssh オプションになりました。Phabricator のポストモーテムでは、3つのアクティブにメンテナンスされているツールの中で、Subversion だけが修正でホスト名の前に -- を追加したと指摘されています。git と Mercurial は、部分的には -- がすべての ssh 実装でサポートされているわけではないため、ホスト名のフォーマットを検証しました。同じレポートでは、-- メカニズム自体を「デフォルトで安全ではない」と呼んでいます。なぜなら、それがないコードは正しく見え、引数がダッシュで始まるまで問題なく動作するからです。
パッケージマネージャー
パッケージマネージャーは、git URL またはリファレンスをデータとして受け取り、サブプロセスに渡すことが日常的に行われています。Gemfile の gem 'foo', git: '...'、package.json の github:user/repo#ref、pyproject.toml、Cargo.toml、mix.exs、Package.swift、pubspec.yaml、conanfile.py、go.mod などです。URL とリファレンスは、マニフェスト、ロックファイル、または推移的な依存関係のメタデータとして到着します。
私がチェックした19のパッケージマネージャー1 のうち、17 がデフォルトまたは唯一のパスとして git バイナリをフォークしています。ライブラリをデフォルトとする2つは、Cargo(オプトイン設定 net.git-fetch-with-cli でフォークする libgit2 を使用)と Poetry(1.2.0 で system-git-client 設定でフォールバックするために dulwich に切り替え)です。Nix はローカルリポジトリの読み取りに libgit2 を使用しますが、フェッチには git をフォークします。これは、libgit2 が git-credential ヘルパーをサポートしていないためです。
このクラスのパッケージマネージャーに対する公開された CVE には、CVE-2021-43809 (Bundler)、CVE-2021-29472 および CVE-2022-24828 (Composer)、CVE-2022-36069 (Poetry)、CVE-2023-5752 (pip)、CVE-2022-21223 および CVE-2022-24440 (CocoaPods)、そしてCVE-2025-68119 (Go) が含まれます。いくつかの2022年のエントリを生み出した Snyk の調査はこちらに書かれています。Sonar は、バイナリごとの危険なオプションのカタログを維持しています。
git をフォークする17のうち、--end-of-options を使用しているのは Go の cmd/go のみです。これは、2019年6月にリポジトリ URL の前に -- を追加し、一般的な強化パスとしました。2026年1月にそれが不十分であることが判明し、CVE-2025-68119 の修正として、全体にわたって --end-of-options が追加されました。同時に HGPLAIN=+strictflags も追加されました。これは、2017年の hg 4.4.2 以降、Mercurial の早期オプション解析を制限しています。コミットメッセージは次のように締めくくられています。「将来的により構造化された変更を行い、これらの問題が誤って再導入されるのをより困難にするべきですが、現時点では手元の問題に対処します。」
最小 git バージョン
引数リストを保護している他のパッケージマネージャーは、-- または入力の先頭ダッシュチェックを使用しており、各ガードが追加された時期を見ると、ほとんどは報告された脆弱性への修正として到着したものであり、元の実装ではありませんでした。Bundler の git clone で URL の前に -- が付いているのはCVE-2021-43809 のパッチです。cocoapods-downloader の先頭ダッシュ拒否は、2022年3月の10日間にわたる3つのコミットで着陸し、CVE-2022-21223 の開示と一致しました。Poetry のガードは2021年9月に到着し、CVE は1年後に割り当てられ、dulwich への切り替えはその6ヶ月後でした。vcpkg は、git レジストリサポートが書かれたその日から -- が存在していた例外です。
Composer のCVE-2022-24828 に関するアドバイザリは、なぜこれらのツールのほとんどが --end-of-options を使用しないのかを説明しています。それはフラグを正しい修正として名前を付け、次に Composer はそれ以前の git バージョンをサポートしているため、パッチは先頭ダッシュのリファレンス名を拒否すると述べています。vcpkg の git 統合には、git 2.7.4 のフロアを指定するコメントがあります。Homebrew の HOMEBREW_MINIMUM_GIT_VERSION は Linux では 2.7.0 で、2018年に設定されました。
git 2.14.3 をパッケージ化していた Amazon Linux 2 は、先月サポート終了を迎えました。そのため、それらのフロアが追跡していたディストリビューションは、今ようやく古くなっています。git 2.17.0 を搭載した Ubuntu 18.04 は、2028年まで延長サポート中です。2030年まで延長サポート中の Ubuntu 20.04 は 2.25.1 をパッケージ化しており、これは git fetch で --end-of-options を受け入れるには十分新しいですが、git rev-parse でそれを拒否するには古すぎます。フラグに依存することは、ほとんどのサブコマンドで git の最小バージョンを 2.24.0 に、rev-parse では 2.30.0 に、checkout と reset では 2.43.1 に引き上げ、ディストリビューションでパッケージ化された git をまだ使用しているユーザーを失うことを意味します。
Git ライブラリ
libgit2、gitoxide、go-git、JGit、および dulwich はすべて、git ワイヤプロトコルを十分に実装しており、インプロセスでクローンおよびフェッチを実行できます。これにより、argv の境界がなく、注入される引数リストもありません。Jujutsu は gitoxide を git 相互運用に使用しており、引数インジェクションクラスでの公開された CVE はありません。これまでの2つのアドバイザリは、パス走査とライブラリから継承した SHA-1 衝突チェックの欠如です。go-git には1つの CVE-2025-21613 があり、これは file:// トランスポート、つまり go-git が git バイナリをスポーンする唯一のコードパスに特化したものです。
パッケージマネージャーの CWE の投稿で述べたように、これは問題を別の問題に交換します。バンドルされた git 実装は、アップストリーム git が出荷するすべてのチェックアウトセーフティ修正を追跡する必要があり、libgit2 と JGit は両方ともそれらの修正ラウンドを経験しています。これは実際のコストですが、常にすべての呼び出しサイトで覚えておく必要があるチェックではなく、適用する必要がある特定のパッチのストリームです。
これを書いたことで、git の最小バージョンを 2.30.0 に引き上げ、clone、remote set-url、ls-remote の前に --end-of-options を追加し、rev-parse の前にリファレンスを追加するHomebrew に対する PR を開くきっかけとなりました。checkout と reset の呼び出しはそのままにされています。これらをカバーするには 2024年2月にリリースされた 2.43.1 のフロアが必要であり、これはまだいくつかのサポートされているディストリビューションよりも新しいものです。
- Bundler, Cargo, CocoaPods, Composer, Conan, Go, Helm, Homebrew, Mix, Nix, npm, pip, pnpm, Poetry, Pub, SwiftPM, uv, vcpkg, Yarn. すべて2026年7月に HEAD でチェックされました。↩