LiteLLM の Docker イメージの署名を検証する手順の話

ツール・基盤

LiteLLM の Docker イメージの署名を検証する手順の話

スポンサーリンク

LiteLLMの Docker イメージが cosign で署名された。

この記事のポイント

  • 改ざん検知の手法が不明確だった
  • cosignで公開鍵かタグで署名を検証
  • 改ざんを検出できる。鍵の配布は別

どこで使えるか

Dockerイメージの改ざんを検知したい運用者向け。cosignで署名を検証できる GitHub Releaseで公開済み Dockerイメージはcosignで署名済み

動画を見る

スポンサーリンク

解説

かみくだいて説明します

BerriAI のプロジェクト、litellm の v1.102.2 が yuneng-berri によって 2026-09-30 に公開されました。今回は Docker イメージの署名検証を cosign に対応させ、改ざんがないことを確認する方法を公式に提示しています。
Docker イメージの改ざん確認ですね。実際に組み込む側から見ると、この cosign による検証は手元で簡単に動きますか。
動きます。コマンドラインに cosign verify と打ち込むだけで、公開鍵とイメージの照合が完了します。ただ、鍵の取得方法が 2 種類あるため、どちらを選ぶかで手順が変わります。
鍵の取り方が 2 種類あるんですか。どちらの方が確実性が高いんですか。
推奨されているのは、特定のコミットハッシュを指定する方法です。コミットハッシュは暗号的に不変なので、本来の署名鍵を使っていることを最も強く保証できます。タグ指定も同じ鍵を指しますが、タグ保護のルールに依存する分、やや緩い仕組みになります。これは宅配便の追跡番号で荷物の経路を特定するのと同じで、番号が固定されていれば途中で中身が入れ替わっていないことを確実に確認できます。
なるほど、コミットハッシュで固定するのが安全ですね。公開鍵のファイルはどこから取得するんですか。
GitHub のリポジトリから直接取得します。サイト上のファイルパスを指定するだけで、公開鍵のデータが手に入ります。タグ保護が有効なリポジトリなら、バージョンタグをパスに含めるだけで同じ鍵に辿り着けます。
では、バージョンアップのたびに鍵のパスを書き換える手間はどうなるんですか。
基本的には同じ公開鍵を使い続ける設計です。初回の commit 0112e53 で導入された鍵が、すべてのリリースで共通しています。そのため、一度設定すれば以降のアップデートでも同じ手順で検証を繰り返すことができます。
鍵の使い回しで安心できますね。今回の v1.102.2 自体に、どのような変更が入ったんですか。
v1.102.2 の変更点ですが、Full Changelog で v1.102.1 から v1.102.2 までの詳細な変更点を確認できます。
最後に、この署名検証の仕組みは他の Docker イメージにも標準で搭載されるんですか。
いいえ、LiteLLMのDockerイメージはcosignで署名されており、各リリースは特定のキーで署名されています。

出典

この記事のもとになった情報

  • GitHub:v1.102.2
  • 公開日:2026-09-30

※ 本文と音声は生成 AI が作成しています。内容は出典をご確認ください。
本作品のキャラクターには株式会社Live2Dの著作物であるサンプルデータが株式会社Live2Dの定める規約に従って用いられています。本作品は制作者の完全な自己の裁量で制作されています。このキャラクターモデルは株式会社Live2Dより許諾を得て商用利用しています。

スポンサーリンク

-ツール・基盤