メインコンテンツまでスキップ

Yabanin セキュリティ監査

依存関係の CVE スキャン​

ツール: govulncheck(Go の脆弱性スキャナ) 日付: 2026-07-23 結果: 到達可能なコードの脆弱性は 0 件です。

脆弱性パッケージ状態対応
GO-2026-4316go-chi/chi/v5 v5.2.3修正済みv5.2.4 へアップグレード
GO-2026-5932golang.org/x/crypto/openpgp呼び出されていないコードベースではインポートされていません。推移的依存のみです

スキャンコマンド​

govulncheck ./...

脅威モデル​

攻撃対象領域​

コンポーネント露出攻撃ベクトル
ゲートウェイ (:8082)公開インターネットAPI キーの総当たり、プロンプトインジェクション、上流 URL 経由の SSRF
管理 (:8086)内部のみセッションハイジャック、CSRF、権限昇格
ダッシュボード (:3000)内部のみXSS、認証バイパス
PostgreSQL (:5432)内部ネットワークSQL インジェクション、接続の枯渇
Redis (:6379)内部ネットワークキャッシュポイズニング、キーの列挙
分類器 (:8080)内部のみモデルの悪用、情報漏えい
管理 API内部のみIDOR、マスアサインメント、監査ログの改ざん

セキュリティ制御​

認証と認可​

  • API キー: SHA-256 でハッシュ化され、api_keys テーブルに保存され、Redis キャッシュ経由で解決されます
  • 管理セッション: ローテーションに対応した、HMAC 署名付きクッキー
  • ルート限定のルート: 管理操作(組織の管理、キャッシュのフラッシュ、価格設定)には is_root=true が必要です
  • チームの分離: API キーはチームに紐づきます。キー/チームごとにホワイトリストが適用されます

入力検証​

  • リクエスト検証: pkg/validation/openai/ が、すべての受信リクエストを検証します
  • SQL インジェクション: すべてのクエリは、パラメータ化された pgx を使います(文字列の連結はありません)
  • SSRF 保護: pkg/ssrf/ が、上流 URL を許可リストと照合して検証します
  • プロンプトインジェクション: LLM トラフィックに固有です。OUTPLAY プログラム(2026-10)以降は、オプトインの制御で軽減できます。決定的なインジェクション検出器、ガードモード、方針パイプラインのステップです(security-owasp-llm.md、LLM01 を参照)。これらの制御を有効にしない場合、元の態勢(「軽減されていない」)が引き続き適用されます。

データ保護​

  • PII の秘匿: Redis パブリッシャは、イベントペイロードから API キー、トークン、シークレットを秘匿します(redactPII)
  • URL の資格情報の除去: redactSensitiveURL は、ログに記録される上流 URL から資格情報を除去します
  • 保存時の暗号化: プロバイダの API キーは、AES-256-GCM で暗号化されます(pkg/encryption/)
  • シークレット管理: 環境変数ではなく、Docker シークレット(/run/secrets/)です

ネットワークセキュリティ​

  • 読み取り専用コンテナ: すべてのサービスは、read_only: true のファイルシステムで実行されます
  • 新規権限なし: すべてのコンテナで security_opt: no-new-privileges:true
  • 内部ネットワーク: サービスは、app-internal ブリッジネットワーク経由で通信します
  • tmpfs のみ: 読み取り専用コンテナでは、書き込みパスは /tmp に限定されます

レート制限​

  • ゲートウェイ: トークンバケットによる、IP ごとのレート制限
  • 管理ログイン: 15 分あたり 5 回(loginLimiter)
  • 管理 API: 1 分あたり 1000 リクエスト(rateLimiter)

監査証跡​

  • 監査ログ: すべての管理上の変更は、実行者、IP、アクション、リソースとともに記録されます
  • リクエストログ: すべての API リクエストは、組織/チーム/コスト/モデルのメタデータとともに永続化されます
  • ストリームの永続化: Redis ストリームは、DB への書き込み前に、永続的なイベント証跡を提供します

予算の適用(エージェント予算)​

  • ハードリミット: チーム(月次)またはエージェント(日次)の予算を超えると、リクエストは HTTP 429 を返します
  • ソフトリミット: 記録されますが、許可されます
  • フェイルクローズ: 予算ストアのエラーは、リクエストを拒否します(503)。予算ストアが利用できない間、支出が許可されることはありません

キー失効の伝播​

保証(更新): Redis が設定されている場合(管理サービスはゲートウェイの Redis を共有します)、失効した api_keys / agent_keys の資格情報は 即座に 拒否されます。すべての失効パス(無効化、削除、ローテーション、エージェントの失効、予算の削除)は、共有キャッシュから org:resolve:<sha256(key_hash)> を消去します。そのため、次の解決は DB に当たり、拒否されます。Redis がない場合、上限は YABANIN_ORG_RESOLVER_TTL 秒(デフォルトは 300s)まで劣化します。

  • ゲートウェイの組織リゾルバ(pkg/auth)は、解決に成功した結果を、sha256(plaintext) をキーとして OrgResolverTTL 秒のあいだ Redis にキャッシュします。管理サービスは現在その Redis を共有し、すべての失効パスでキャッシュエントリを消去します(フェイルソフト: 消去に失敗すると警告をログし、TTL の上限が適用されます)。Redis がない場合、TTL が伝播の上限です。
  • したがって上限は 厳密 です。stale window ≤ OrgResolverTTL。pkg/auth/resolver_revocation_test.go の偽クロックテストは、両端を固定します。失効したキーは TTL−1 秒の時点ではまだ解決され、TTL の時点で拒否されます。これは API キーとエージェントキーの両方のパスに当てはまります。Redis に渡される TTL は、設定された上限と等しくなります(環境変数を厳しくすると、上限も厳しくなります)。
  • より速く無効化するための緩和策: 失効させ、かつ 一致する org:resolve:<sha256> の Redis キーをフラッシュします(共有 Redis へのアクセスが必要です)。そうしない場合は、設定された TTL を前提にインシデント対応を計画してください。キーの入れ替わりが多い導入、または失効の SLA が厳しい導入では、YABANIN_ORG_RESOLVER_TTL を低く設定します(例: 30)。代償として、キーごと、ウィンドウごとに、DB のペア読み取りが 1 回増えます。
  • キャッシュエントリは HMAC で署名されています(CacheSigner)。そのため、Redis にアクセスできる攻撃者は、一度も発行されていないキーについて有効な解決結果を偽造できません。同じ上限の中で、すでに発行されたアイデンティティを生かし続けることしかできません。
  • 注: キー失効の修正より前に書かれたエントリは、3 フィールドのエージェントエンコーディングを使っていました。キャッシュ読み取りは、エージェント ID をチームのスロットに誤って割り当てていました。それらは 1 TTL 以内(≤300s)に期限切れとなり、正しい 4 フィールド形式で書き直されます。

ローンチ前のセキュリティチェックリスト​

  • 依存関係スキャン: 到達可能な脆弱性は 0 件
  • すべてのコンテナは、no-new-privileges 付きで読み取り専用として実行されます
  • シークレットは Docker シークレットとして保存されます(環境変数ではありません)
  • すべての SQL クエリは、パラメータ化されたステートメントを使います
  • 上流 URL は、SSRF パターンに対して検証されます
  • イベントストリームとログから、PII が秘匿されます
  • プロバイダの API キーは、保存時に暗号化されます
  • 管理ルートは、ルート限定のミドルウェアで保護されます
  • ゲートウェイと管理ログインに、レート制限があります
  • すべての管理上の変更に、監査ログがあります
  • ロードバランサで TLS を終端します(ローンチ前に設定)
  • ダッシュボードの CORS 方針(既知のオリジンに制限)
  • シークレットのローテーション手順が文書化されています(ランブックを参照)

推奨事項​

  1. TLS: ロードバランサ(nginx/ALB)で TLS を終端します。ゲートウェイと管理は、LB の背後で平文の HTTP を待ち受けます。
  2. CORS: ダッシュボードのドメインに制限した Access-Control-Allow-Origin ヘッダを追加します。
  3. シークレットのローテーション: session_key、cache_hmac、pg_uri を四半期ごとにローテーションします。
  4. WAF: ゲートウェイの前段で、DDoS 保護として Cloudflare/AWS WAF を検討します。
  5. 侵入テスト: SOC2 の準拠作業の前に、外部ペネトレーションテストを予定します。

2026-10 OUTPLAY プログラム — 脅威モデルの補遺​

日付: 2026-10-08(レーン OP-24)。範囲: OUTPLAY プログラムが提供した方針パイプライン(YPP)と、MCP の資格情報/アグリゲータの面(docs/plans/OUTPLAY-PLAN-2026-10-06.md、内部)。この補遺は、新しい脅威モデルと補償制御を記録します。上記のセクションは、引き続き有効です。リスクごとの完全な対応付け(LLM アプリケーションの OWASP Top-10 → 制御。正直なカバレッジ境界付き)は、security-owasp-llm.md にあります。

パイプラインの脅威モデル(pkg/pipeline、pkg/policystore)​

パイプラインは、ゲートウェイのトラフィックに対する、プログラム可能な検査/改変の搬送路です(pipeline.md)。独自の攻撃対象領域と制御は、次のとおりです。

対象面脅威制御
条件エンジン(pkg/pipeline/script: デフォルトは expr、lua、starlark)方針の条件が、DoS/脱出のベクトルになる条件は、方針の読み込み時に一度だけコンパイルされます(無効なソース = 読み込みエラーであり、黙ってスキップされることはありません)。expr は設計上ループがありません。lua は、命令予算付きのサンドボックスで実行されます。ステップごとの timeout が、すべてのエンジンを制限します。条件のエラーは on_error に従います(デフォルトはフェイルクローズ)。方針は管理者が作成し、git で照合されます。クライアント入力ではありません
コールアウトステップ(pkg/pipeline/callout)スキャナ URL 経由の SSRF。プロジェクションを通じたデータの持ち出しステップは、YABANIN_POLICY_CALLOUT_ALLOW_HOSTS が設定されている場合にのみコンパイルされます(空 = フェイルクローズ)。SSRF ガードは DNS の応答を固定し、ダイヤル時に予約アドレスを拒否します(リバインディングの窓は閉じます)。リダイレクトはなく、リトライもなく、URL ごとのサーキットブレーカと、ステップごとのタイムアウトがあります。expose プロジェクションは、出て行く内容を制限します(メタデータは決して出ません)。max_response_bytes が応答の上限になります
LLM 判定(pkg/pipeline/llmjudge)パイプラインの再帰(判定がゲートウェイを呼び出し、パイプラインに再入して、コストを増幅する)ハードな除外: ゲートウェイが行う判定呼び出しは、judge=true のメタと X-Yabanin-Judge: true を持ちます。内部呼び出しは免除されます。一方、そのヘッダを提示する受信リクエスト(任意の値、空、重複を含む)は、認証のあと 400 judge_reentry_unsupported で拒否されます(pipeline.md §6.2)。判定プロンプトは、バージョン管理されたリソースです。temperature は 0 に固定されます。省略された確信度は 1.0 として数えられます(フェイルクローズ)
判定の合成バグのあるステップが、deny をすり抜けて allow を持ち込む固定の厳格さのスケールは deny > mask > flag > allow です。付与された方針をまたぎ、最も制限的な判定で和を取ります。未知のアクションは deny として順位付けされます。最初の deny で短絡します
ストリーミング改変分断された書き込みが、チャンク境界をまたいで置換前の値を漏らすプレフィックスゲート(64 トークン / 500 ms)は、解放前に拒否します。チャンクキャリーが部分一致を保持します。変換は、キャッシュライターの前に実行されます(pipeline.md §7)
判定ログ所見を通じて、機微な内容が残る証拠はハッシュ化して保存されます。引用されたユーザの内容は、シャドウ/デバッグの保持でのみ残ります。保持期間は 90 日です(マイグレーション 0009)

MCP 資格情報の脅威モデル(pkg/mcpagg、マイグレーション 0007)​

mcp-gateway.md §6、§8(R4) からの要約です。出荷された R4 の態勢は次のとおりです。シークレットは、組織分離の RLS の下で、enc: により暗号化されたエンベロープとしてのみ存在します(書き込みはフェイルクローズ)。読み取りは、マスクされた行のみを返します(secret_last4/has_secret)。すべての CRUD/ステータスのステップは、ハッシュ連鎖の監査ジャーナルに記録されます。平文には上限があり(8 KiB)、ログには残りません。資格情報が出口を広げることはありません。サーバ URL に対する SSRF 許可リストの検査は、すべての呼び出しで、資格情報の解決より前に行われます。ユーザごとの資格情報フロー(送信/ローテーション、OAuth の開始/コールバック)には、有効な許可が必要です。許可は、すべてのフローステップの上限です。

2026-07 の監査に対する態勢の変化​

7 月の監査は、「プロンプトインジェクション: 軽減されていない」と記録しました。プログラムは、デフォルトの態勢を変えずに、オプトイン の軽減策(ガードモード、インジェクション検出器、方針ステップ、ツール結果の事後チェック)を追加します。新しい対象面はすべてオフで出荷されます(YABANIN_POLICY_MODE、YABANIN_MCP_GATEWAY、ガードモードはすべてデフォルトでオフ/未マウントです)。出口の設定は、デフォルトでフェイルクローズです。未設定の導入は、以前と同じ動作をします。