レジデンシー方針パック
正直な範囲: 方針パックは、型付きのレジデンシールールのプリセットに、リネージのフックを加えたものです。認定されたコンプライアンス製品ではありません。パックがあるからといって、Yabanin が「HIPAA 準拠」や「ITAR 認定」になるわけではなく、マーケティングがそう主張してはいけません。認定が必要な場合は、別の監査プロセスです。
Yabanin は、規制対象の法域について、リクエストごとのリージョン固定 を強制します。対象は、シンガポール(PDPA + MAS)、インド(DPDP + RBI)、インドネシア(UU PDP)、日本(APPI)です。この文書は、何が強制されるか、リージョンごとのデフォルトルール、管理 API で組織ごとに上書きする方法、レジデンシーがソブリニティスタックの残りとどう関係するかを説明します。
強制される内容
すべての /v1/chat/completions リクエストについて、最終モデルが選ばれたあと(分類器 + ティアルーター + 経路ルール)、ゲートウェイはレジデンシーの Enforcer(pkg/policy/enforcer.go)を実行します。
- 組織の
residency_regionを解決します(organizationsの列。NULL = グローバル)。 - グローバルの場合 → フリーパス(レイテンシのオーバーヘッドなし、パック評価なし)。
- 規制対象だが、そのリージョンにパックが登録されていない場合 → フェイルクローズ(403)。
パックは、モデルの region と family をルールと照合します。
- 法域が許可されていない → 403
residency_policy_violation - ファミリーが許可リストにない → 403
- (IN のみ)ブラックリスト該当 → ハード拒否 403
- 許可された場合、レスポンスは
X-Residency-RegionとX-Residency-Packを運びます。
フェイルクローズは意図的です。規制対象のリージョンでは、誤った法域を経由して応答するより、ブロックする方が安全 です。
デフォルトルール
| リージョン | パック ID | 許可される法域 | 許可されるファミリー | データレジデンシー | ブラックリスト |
|---|---|---|---|---|---|
| SG | sg_pdpa_mas | SG, EU | openai, anthropic, sovereign_sg, open_weights | SG | — |
| IN | in_dpdp_rbi | IN, SG | openai, anthropic, sovereign_in, open_weights | IN | CN |
| ID | id_pdp | ID, SG | openai, anthropic, sovereign_id, open_weights | ID | — |
| JP | jp_appi | JP | openai, anthropic, sovereign_jp, open_weights | JP | — |
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 への導入は、レジデンシーを論理的な極限まで進めます。顧客の環境から何も出ません。
- ソブリンモデルレジストリ — レジデンシーパックは、リージョンごとにどのモデルファミリーが合法かを許可リストにします。レジストリは、モデルをソブリニティのティアで分類します。