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

Yabanin のセキュリティ態勢

このページは、Yabanin のセキュリティモデルへの入口です。どのサーフェスを通じて誰が認証できるか、シークレットがどのように保存されるか、方針パイプラインが制御レイヤとしてどこに収まるか、サプライチェーンがどのように守られるかを示します。詳細な所見と脅威モデルの履歴は security-audit.md にあります。LLM アプリケーション向け OWASP Top-10 の対応は security-owasp-llm.md にあります。

認証サーフェス​

サーフェス資格情報仕組みコード
管理コンソール(ローカル)メール + パスワードbcrypt(コスト 12)のハッシュ。ログイン試行は常に bcrypt の計算を消費する(タイミングを均一化)。有効期限と発行時刻を持つ HMAC 署名付きセッション Cookiepkg/adminauth/auth.go, pkg/adminauth/hash.go
管理 SSO — OIDC上流 IdPAuthorization Code + PKCE (S256)、state CSRF トークン、nonce、失敗時クローズのユーザーマッピングpkg/adminauth/oidc.go, sso-oidc.md
管理 SSO — SAML 2.0上流 IdPACS エンドポイント、署名付き 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_org GUC)の下にあります。他の組織の行は見えず、書き込めません。
  • 導入シークレット(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)。

インシデント対応​

ランブック: インシデント対応、重大度の分類、シークレットのローテーション、予算予約アラート、および 本番ランブック。