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

レジデンシー方針パック

正直な範囲: 方針パックは、型付きのレジデンシールールのプリセットに、リネージのフックを加えたものです。認定されたコンプライアンス製品ではありません。パックがあるからといって、Yabanin が「HIPAA 準拠」や「ITAR 認定」になるわけではなく、マーケティングがそう主張してはいけません。認定が必要な場合は、別の監査プロセスです。

Yabanin は、規制対象の法域について、リクエストごとのリージョン固定 を強制します。対象は、シンガポール(PDPA + MAS)、インド(DPDP + RBI)、インドネシア(UU PDP)、日本(APPI)です。この文書は、何が強制されるか、リージョンごとのデフォルトルール、管理 API で組織ごとに上書きする方法、レジデンシーがソブリニティスタックの残りとどう関係するかを説明します。

強制される内容​

すべての /v1/chat/completions リクエストについて、最終モデルが選ばれたあと(分類器 + ティアルーター + 経路ルール)、ゲートウェイはレジデンシーの Enforcer(pkg/policy/enforcer.go)を実行します。

  1. 組織の residency_region を解決します(organizations の列。NULL = グローバル)。
  2. グローバルの場合 → フリーパス(レイテンシのオーバーヘッドなし、パック評価なし)。
  3. 規制対象だが、そのリージョンにパックが登録されていない場合 → フェイルクローズ(403)。

パックは、モデルの region と family をルールと照合します。

  • 法域が許可されていない → 403 residency_policy_violation
  • ファミリーが許可リストにない → 403
  • (IN のみ)ブラックリスト該当 → ハード拒否 403
  1. 許可された場合、レスポンスは X-Residency-Region と X-Residency-Pack を運びます。

フェイルクローズは意図的です。規制対象のリージョンでは、誤った法域を経由して応答するより、ブロックする方が安全 です。

デフォルトルール​

リージョンパック ID許可される法域許可されるファミリーデータレジデンシーブラックリスト
SGsg_pdpa_masSG, EUopenai, anthropic, sovereign_sg, open_weightsSG—
INin_dpdp_rbiIN, SGopenai, anthropic, sovereign_in, open_weightsINCN
IDid_pdpID, SGopenai, anthropic, sovereign_id, open_weightsID—
JPjp_appiJPopenai, anthropic, sovereign_jp, open_weightsJP—

JP パックは、日本の規制対象の買い手が AI を調達する方法に、直接対応します。国内データ保管のあるモデルだけを認める、承認済みモデルのリストです。jp_appi では、リージョン JP で登録されているモデルだけが通過します。Azure OpenAI の Japan East リソース、Bedrock の ap-northeast-1 モデル、国内プロバイダ、または自社運用のオープンウェイトです。api.openai.com のようなグローバルエンドポイント(リージョン US)は拒否されます。US/EU を開くには、顧客自身の APPI 越境移転評価(第 28 条: 同意、または APPI 相当の移転先基準)に裏付けられた、組織ごとの明示的な上書きが必要です。

組織ごとの上書き(管理 API)​

上書きは、policy_packs(マイグレーション 0032)に、ResidencyRule の JSON 上書きとして保存されます。エンドポイントは root のみです。

# Set org residency region
curl -X PUT http://admin/api/organizations/$ORG_ID/residency \
-H 'Content-Type: application/json' \
-d '{"residency_region":"SG"}'

# Override the SG pack to also allow US
curl -X PUT http://admin/api/organizations/$ORG_ID/policy-packs/SG \
-H 'Content-Type: application/json' \
-d '{"pack_id":"sg_pdpa_mas","config":{"allowed_jurisdictions":["SG","EU","US"]}}'

# List overrides
curl http://admin/api/organizations/$ORG_ID/policy-packs

組織の強制を解除するには、residency_region を "" に設定します。

メトリクス​

  • gateway_residency_enforcement_total{region,decision} — 許可 / 拒否
  • gateway_residency_remap_total{region} — 拒否 → リージョン内への再マッピング
  • gateway_residency_evaluation_seconds{pack_id} — パック評価のレイテンシ

ソブリニティスタックの残りとの関係​

レジデンシーは 強制 のレイヤーです。リクエストが誤った法域へ到達するのを止めます。他のソブリニティ構成要素と組み合わさり、J=3(完全な法域上のソブリニティ)を実現します。

  • 法域リネージ証明 — 各リクエストが実際にどこで実行されたかを、暗号学的に証明します。レジデンシーは防ぎ、リネージは証明します。
  • マルチリージョン active-active — レジデンシールールが意味を持つのは、Postgres の行レベルセキュリティによって、データがホームリージョンへ物理的に固定されているからです。
  • エアギャップ/オンプレミス — シングルテナントの、顧客 VPC への導入は、レジデンシーを論理的な極限まで進めます。顧客の環境から何も出ません。
  • ソブリンモデルレジストリ — レジデンシーパックは、リージョンごとにどのモデルファミリーが合法かを許可リストにします。レジストリは、モデルをソブリニティのティアで分類します。