requirements.txt - pip install requirements.txt - pip freeze requirements.txt

requirements.txt の隠れた危険性: 依存関係の固定化でどのように救われるか

requirements.txt:コアツールか、それとも隠れた脅威か?

すべての Python プロジェクトにはそれがあります。無害そうに見える requirements.txt リポジトリのルートにあるファイル pip install requirements.txt 消費されるものは、確かに依存関係のリストですが、注意しないと、不安定なビルド、脆弱なパッケージ、深刻なセキュリティ問題への大きな扉を開くことにもなりかねません。

その中心に、 Requirements.txt アプリケーションが取り込むサードパーティパッケージを制御します。 pip install -r requirements.txtPython のパッケージマネージャは、リストされているすべての依存関係をインストールします。しかし、ここが重要な点です。正確なバージョンを固定しないと、 PyPIを信頼する 常に安全で互換性があり、改変されていないバージョンを提供する。現代のアプリケーションセキュリティはそういうものではない。

ピン留めしないと、ビルドが失敗する可能性があります。さらに悪いことに、アプリケーションが悪意のあるパッケージを意図せず取り込んでしまう可能性があります。オープンエンドのバージョン管理(フラスコ >=1.0, 例えば)または緩いバージョン制約(django~=3.2は、安全でないコードを注入する温床となります。そのため、適切に管理することが重要です。 Requirements.txt これはセキュリティの中核的なタスクです。

pip freezeとpip install requirements.txtの内訳

ピップフリーズ 便利ではあるが、何をキャプチャするのかを理解せずに使用すると危険でもある。開発者はしばしば生成する。 Requirements.txt pip freeze requirements.txt環境をロックダウンしてくれることを期待して、freeze を使用する。しかし、freeze は依存関係のセキュリティや出所を検証せず、推移的なパッケージや古い可能性のあるパッケージも含め、現在インストールされているすべてを単にダンプするだけだ。

今度は、チームメイトやCIが盲目的に走るところを想像してみてください。 pip install -r requirements.txtそのファイルに非推奨、脆弱、または タイプミスを利用したパッケージつまり、あなたはセキュリティインシデントを自動化してしまったのです。

簡単な例:

				
					# Developer's freeze output
pip freeze > requirements.txt
boto3==1.24.20
requests==2.27.1

				
			

⚠️ 安全性の低い例です。本番環境では使用しないでください。

これをCIに追加してください pipeline:

				
					- name: Install dependencies
run: pip install -r requirements.txt
				
			

あなたは、環境が再現可能であり、PyPI で何も変更されていないことを信頼しています。 すべての依存関係 は依然として安全です。 pip freeze requirements.txt ワークフロー。

実際のアプリケーションセキュリティの脅威:requirements.txtにおけるタイポスクワッティングと依存関係の混乱

攻撃者はオープンソースのエコシステムを好みます。なぜでしょうか?それは、開発者がデフォルト設定や暗黙の信頼に依存していることが多いからです。攻撃者は、オープンソースのエコシステムを利用して攻撃を仕掛けます。 Requirements.txt:

  • タイポスコーティング:次のような名前の悪意のあるパッケージをアップロードします リクエスト リクエスト文字が1つでもずれると、あなたのビルドは完全に負けてしまいます。

リクエスト # ⚠️ これは例示であり、実際にインストールするパッケージではありません

  • 依存関係の混乱内部パッケージがピン留めされていない、またはプライベートスコープになっていない場合、攻撃者は同じ名前の悪意のあるバージョンをPyPIに公開する可能性があります。CIがソースを検証しない場合、自分のパッケージではなく攻撃者のパッケージがインストールされてしまいます。

どちらの攻撃も、厳密なピン留めとソース管理の欠如を悪用しています。 Requirements.txtもしあなたの ただ言う 内部ライブラリ、そして走る pip インストール要件.txt CI環境では、間違った場所から間違ったパッケージを取得してしまう可能性があります。

requirements.txt を保護する CI/CD Pipelineハッシュとピン留めを含む

硬化させる方法は次のとおりです Requirements.txt 現実世界の脅威に対抗する:

  • ピン留めの正確なバージョン: 常に使用する == パッケージごとに Requirements.txtワイルドカードも範囲指定も不可。
  •   –ハッシュを要求する: これにより pip install -r requirements.txt ダウンロードしたすべてのパッケージの整合性を検証する。

例:

				
					flask==2.2.5 \
--hash=sha256:<actual_hash_here> 
				
			

⚠️ これは例示であり、実際のプロジェクトでは実際のハッシュに置き換えてください。

  • ビルドを分離する常にクリーンで最小限のコンテナ内で構築してください。ベースイメージを盲目的に信頼しないでください。
  • プライベートPyPIインデックスを使用する独自のプロキシ/キャッシュをホストし、信頼できるパッケージのみをミラーリングします。

依存関係のスキャンを実行する:次のようなツールを統合する pip監査 または使用 SBOM-ベースの分析 pipelines.

GitHub Actionsのスニペット例:

				
					- name: Secure install
  run: pip install --require-hashes -r requirements.txt
				
			

⚠️ 教育 pipeline 例えば、環境に適応する

厳格な取り扱い pip install -r requirements.txt in CI/CD これは、オープンソースのリスクを軽減する最も簡単な方法の1つです。

再現可能なビルド:環境を問わず安定性を維持する

アプリがローカルでは動作するが、ステージングまたはプロダクションで失敗する場合は、依存関係の不整合が原因である可能性があります。 Requirements.txt いつも疑われるのは、これらの要因です。わずかなバージョンずれでも大きな問題を引き起こします。

次の戦略を使用します。

  • ピップツール: つかいます pip-compile 引き起こす Requirements.txt から 要件.in適切なピン留めによって依存関係を解決します。
  • 環境マーカーOS固有のパッケージやPythonバージョン固有の依存関係については、次のようなマーカーを使用します。 platform_system == 'Linux'.
  • Dockerのキャッシュ: CI では、依存関係をインストールした後、Docker レイヤーをキャッシュします。 Requirements.txt 製造時のばらつきを減らすため。

pip-toolsを使った例:

				
					# requirements.in
flask

# Compile
pip-compile requirements.in

				
			

⚠️ これはあくまで例であり、実際の出力は環境によって異なります。

出力は完全にピン留めされています Requirements.txt.

のようなツール ピップフリーズと組み合わせると、 pip install -r requirements.txt 建設中は、規律と追加の安全対策が必要となる。

結論:自信を持って要件を確定する

管理ミス Requirements.txt これは単なる悪い習慣ではなく、積極的なセキュリティリスクです。緩いピン留め、検証されていないインストール、オープンレジストリへの盲信は、攻撃者があなたの CI/CD pipelineこれらは理論上の欠陥ではなく、日常的に悪用されている。

依存関係の固定は、単なるベストプラクティス以上のものです。それは、Python におけるサプライチェーン攻撃に対する最初の防御線です。 –ハッシュを要求するビルドの分離、再現可能なツールなど ピップツール、すると、 pipeline それは妥協するのがより難しい。

使用しているかどうか pip インストール要件.txt ローカル環境でもCI環境でも、ビルドに含まれるものを常に検証および監視してください。次のようなツール ザイゲニ Pythonサプライチェーンを保護するための可視性、ポリシーの適用、および自動チェックを提供します。 pip freeze requirements.txt 制作過程全体を通して。

sca-tools-ソフトウェア構成分析ツール
ソフトウェアのリスクを優先順位付けし、修復し、保護する
無料アカウントを作成しましょう。
いいえ、クレジットカードは必要ありません。

ソフトウェア開発と配信を安全に

Xygeni製品スイートと共に