Yabanin のセキュリティ態勢
このページは、Yabanin のセキュリティモデルへの入口です。どのサーフェスを通じて誰が認証できるか、シークレットがどのように保存されるか、方針パイプラインが制御レイヤとしてどこに収まるか、サプライチェーンがどのように守られるかを示します。詳細な所見と脅威モデルの履歴は security-audit.md にあります。LLM アプリケーション向け OWASP Top-10 の対応は security-owasp-llm.md にあります。
認証サーフェス
| サーフェス | 資格情報 | 仕組み | コード |
|---|---|---|---|
| 管理コンソール(ローカル) | メール + パスワード | bcrypt(コスト 12)のハッシュ。ログイン試行は常に bcrypt の計算を消費する(タイミングを均一化)。有効期限と発行時刻を持つ HMAC 署名付きセッション Cookie | pkg/adminauth/auth.go, pkg/adminauth/hash.go |
| 管理 SSO — OIDC | 上流 IdP | Authorization Code + PKCE (S256)、state CSRF トークン、nonce、失敗時クローズのユーザーマッピング | pkg/adminauth/oidc.go, sso-oidc.md |
| 管理 SSO — SAML 2.0 | 上流 IdP | ACS エンドポイント、署名付き AuthnRequest、アサーション再生キャッシュ(各アサーション ID は一度だけ受理) | pkg/adminauth/saml.go, sso-saml.md |
| SCIM 2.0 プロビジョニング | 組織スコープのベアラートークン | 公開ルーター上に独自のベアラーガードでマウントする(管理セッションは使わない)。SHA-256 によるトークン検索(一意インデックス、SQL 内でのシークレット比較なし)+ 定数時間比較 | services/admin/handlers/scim.go, pkg/adminstore/scim.go |
| ゲートウェイ JWT 認証 | 外部 JWT | 組織が設定した JWKS のみから kid で鍵を選択する。iss/aud/exp/nbf を強制する。組織クレームはリクエストの組織コンテキストになり、キーラベルのクレームはロックされたキーラベルになる。JWKS に仕込まれた対称鍵は拒否する。JWKS に到達できない場合、ゲートウェイは失敗時クローズ(503、陳腐化に上限あり) | pkg/gateway/auth_jwt.go |
ゲートウェイ API キー(yab_*) | ベアラーキー | SHA-256 ハッシュで保存する。sha256(plaintext) をキーとする Redis キャッシュを通じて解決し、エントリは HMAC 署名される(CacheSigner)。Redis の攻撃者は解決結果を偽造できない | pkg/auth/resolver.go, pkg/auth/sessionkeys.go |
エージェントキー(yag_*) | ベアラーキー | 同じハッシュ方式。エージェント主体のセマンティクス(ツール呼び出し、予算、タスクタグ) | pkg/auth/agentkey.go, agent-governance.md |
失効の伝播には上限があり、テストで固定されています。すべての失効経路は共有の解決キャッシュをパージするため、失効したキーは、Redis がある場合は直ちに拒否され、ない場合は YABANIN_ORG_RESOLVER_TTL(既定 300 秒)以内に拒否されます — security-audit.md の「キー失効の伝播」。
総当たりと濫用: 管理ログインは 15 分あたり 5 回、管理 API は毎分 1000 リクエストに制限され、Redis をバックエンドとするリミッター(pkg/adminauth/ratelimit_redis.go)を使います。ゲートウェイは IP ごとのトークンバケット制限を適用します。管理操作の変更はハッシュ連鎖の監査ジャーナル(pkg/auditlog: row_hash = sha256(prev_hash || payload))に記録され、特権ルートには root 専用ミドルウェアが必要です。
保存時のシークレット
enc:エンベロープ。 プロバイダキー(BYOK)と MCP 上流の資格情報は、enc:バージョン接頭辞付きの AES-256-GCM 暗号文として保存されます。書き込みは失敗時クローズ です。設定された暗号化機能がない場合、書き込みは拒否されます。鍵が欠けていても、黙って平文へダウングレードすることはありません。弱い鍵(短い、低エントロピーの hex)は構築時に拒否されます(pkg/encryption/encryption.go)。- KMS マスターキー。
local(環境変数またはファイルのマスターキー、YABANIN_KMS_LOCAL_KEY)とfileプロバイダは接続されています。awsプロバイダは、設定されない限り失敗時クローズです(pkg/kms/factory.go)。 - ハッシュ化され、復元できません。 API キーとエージェントキーは SHA-256 ハッシュです。SCIM のベアラートークンは、ハッシュ検索と定数時間の確認で解決します。管理者パスワードは bcrypt です。これらのいずれにも平文の経路は存在しません。
- マスクされた読み取り。 シークレットを返すすべての API は、マスクされた行(
secret_last4、has_secret)を返します。平文は store/resolve メソッドへの呼び出し引数としてのみ存在し、ログにもシリアライズにも入りません(mcp-gateway.md §6)。 - 組織の分離。 シークレットを持つテーブルは、組織分離の RLS 契約(
ENABLE+FORCE、トランザクションごとに固定されるapp.current_orgGUC)の下にあります。他の組織の行は見えず、書き込めません。 - 導入シークレット(
session_key、cache_hmac、pg_uri、KMS キー)は、環境変数ではなく Docker シークレット(/run/secrets/)としてプロビジョニングされます。ローテーションは文書化されたランブックです(ops/secrets-rotation.md)。
制御レイヤとしての方針パイプライン
方針パイプライン(YPP)は、コンテンツレベルの制御を強制する地点です。対象は、PII、シークレット、インジェクションの検出器、リダクションと仮名化のミューテータ、外部スキャナ、LLM ジャッジ、出力スキーマとストリーミングの検査です。これを機能ではなく 制御 にする性質は、次のとおりです。
- 既定ではオフ、管理者が所有。
YABANIN_POLICY_MODEが未設定のとき、ランタイムは構築されません。リクエストごとの(SDK が渡す)方針設定はないため、クライアントは管理者の方針を回避できません。 - 失敗時クローズが既定。 ステップのエラーは既定で拒否します(
on_error: fail_closed)。fail_openはステップごとの明示的な選択です。未知のアクションは拒否として扱われます。 - シャドウ → 強制。 方針はシャドウモード(記録のみで、決して変更しない)で展開されます。判断ログ(保持期間 90 日、コンテンツはハッシュ化)と方針ごとのメトリクスが、レビューの対象になります。プロセ ス全体のキルスイッチは、一度の操作ですべてをシャドウへ降格します。
- 外部送信の制限。 コールアウトステップには、運用者の許可リスト(
YABANIN_POLICY_CALLOUT_ALLOW_HOSTS)が必要です。すべての接続は、固定された DNS(再バインドの余地なし)によって SSRF から守られ、リダイレクトはなく、リトライはなく、URL ごとのサーキットブレーカーがあります。
OWASP LLM Top-10 の対応(security-owasp-llm.md)は、このレイヤがリスクごとに何をカバーし、何をカバーしないかを説明します。
サプライチェーン
- ゲートでの依存関係 CVE スキャン。
make analyze-securityはgo mod verifyとシンボルレベルのgovulncheckを実行します。同じ検査は品質ゲート(scripts/quality/dep_audit.py)なので、到達可能な CVE はレポートだけでなくビルドを失敗させます。アナライザのバージョンは固定されています(make install-analysis-tools)。所見のトリアージにはscripts/security/govulncheck-classify.shを使います。現在のスキャン結果は security-audit.md にあります。 - 依存関係の方針。 新しい Go の依存関係は、コード変更と同じレビューと品質ゲートに従います。スキャナは到達可能性によって所見を分類し、「呼び出されていない」所見は、黙殺する のではなくその根拠とともに記録されます。
- ランタイムのサプライチェーン。 コンテナは内部ブリッジネットワーク上で、no-new-privileges 付きの読み取り専用で実行されます。サービスは内部インターフェースにバインドし、ユーザーが指定したホストへの外部送信は、常に SSRF の許可リストガード(
pkg/ssrf)を通過します。 - 方針、プロンプト、モデルの来歴。 方針は git から照合され、宣言したリビジョンの git SHA を記録します。ジャッジのプロンプトとプロンプトスタジオのリソースはバージョン管理されます。モデルの適格性は、モデルホワイトリストのステップで組織ごとに制約できます。ダッシュボードとサイトの npm ツリー、および Docker のベースイメージは、Go のスキャン対象外です。これは既知の、文書化された境界です(security-owasp-llm.md、LLM03)。
インシデント対応
ランブック: インシデント対応、重大度の分類、シークレットのローテーション、予算予約アラート、および 本番ランブック。