Pek dasar residensi
Skop jujur: pek dasar ialah pratetap peraturan residensi yang berjenis serta cangkuk provenans. Ia BUKAN produk pematuhan yang diperakui — YABANIN bukan "patuh HIPAA" atau "diperakui ITAR" semata-mata kerana pek wujud, dan pemasaran tidak sekali-kali boleh mendakwa demikian. Pensijilan, apabila diperlukan, ialah proses audit yang berasingan.
YABANIN menguatkuasakan pin wilayah bagi setiap permintaan untuk bidang kuasa yang terkawal: Singapura (PDPA + MAS), India (DPDP + RBI), Indonesia (UU PDP), dan Jepun (APPI). Dokumen ini menerangkan apa yang dikuatkuasakan, peraturan lalai bagi setiap wilayah, cara menindih bagi setiap organisasi melalui API pentadbir, dan bagaimana residensi berkaitan dengan seluruh timbunan kedaulatan.
Apa yang dikuatkuasakan
Bagi setiap permintaan /v1/chat/completions, selepas model akhir dipilih
(pengelas + penghala peringkat + peraturan penghalaan), gerbang menjalankan
Penguatkuasa residensi (pkg/policy/enforcer.go):
- Selesaikan
residency_regionorganisasi (lajur padaorganizations, NULL = global). - Jika global → lepas bebas (tiada beban tambahan kependaman, tiada penilaian pek).
- Jika terkawal tetapi tiada pek didaftarkan untuk wilayah itu → gagal-tertutup (403).
Pek menilai region + family model terhadap peraturannya:
- bidang kuasa tidak dibenarkan → 403
residency_policy_violation - famili tidak dalam senarai putih → 403
- (IN sahaja) terkena senarai hitam → tolak keras 403
- Apabila dibenarkan, respons membawa
X-Residency-RegiondanX-Residency-Pack.
Gagal-tertutup adalah disengajakan: bagi wilayah yang terkawal, menyekat lebih selamat daripada melayan melalui bidang kuasa yang salah.
Peraturan lalai
| Wilayah | ID Pek | Bidang kuasa dibenarkan | Famili dibenarkan | Residensi data | Senarai hitam |
|---|---|---|---|---|---|
| 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 | — |
Pek JP memetakan secara terus cara pembeli terkawal Jepun memperoleh AI: senarai
model yang diluluskan yang hanya menerima model dengan storan data dalam negara
(国内データ保管). Di bawah jp_appi, model hanya lulus apabila didaftarkan
dengan wilayah JP — sumber Azure OpenAI Japan East, model Bedrock
ap-northeast-1, penyedia domestik, atau pemberat terbuka kendalian sendiri.
Endpoint global seperti api.openai.com (wilayah US) ditolak; membuka
US/EU memerlukan penindihan nyata bagi setiap organisasi yang disokong oleh penilaian pemindahan APPI
pelanggan sendiri (Perkara 28: persetujuan atau piawaian destinasi yang setara dengan APPI).
Penindihan setiap organisasi (API pentadbir)
Penindihan disimpan dalam policy_packs (migrasi 0032) sebagai penindihan JSON bagi
ResidencyRule. Endpoint root sahaja:
# 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
Untuk membersihkan penguatkuasaan bagi sesebuah organisasi, tetapkan residency_region kepada "".
Metrik
gateway_residency_enforcement_total{region,decision}— dibenarkan / ditolakgateway_residency_remap_total{region}— ditolak → pemetaan semula dalam wilayahgateway_residency_evaluation_seconds{pack_id}— kependaman penilaian pek
Hubungan dengan seluruh timbunan kedaulatan
Residensi ialah lapisan penguatkuasaan — ia menghalang permintaan daripada sampai ke bidang kuasa yang salah. Ia bergabung dengan komponen kedaulatan yang lain untuk menyampaikan J=3 (kedaulatan bidang kuasa yang penuh):
- Atestasi provenans bidang kuasa — membuktikan, secara kriptografi, di mana setiap permintaan sebenarnya dijalankan. Residensi mencegah; provenans membuktikan.
- Aktif-aktif berbilang wilayah — peraturan residensi bermakna hanya kerana data disemat secara fizikal ke wilayah asal melalui Keselamatan Aras Baris Postgres.
- Jurang udara / di premis sendiri — pelaksanaan penyewa tunggal, VPC pelanggan membawa residensi ke penghujung logiknya: tiada apa-apa yang meninggalkan persekitaran pelanggan.
- Registri model berdaulat — pek residensi menyenarai putih famili model yang sah di sisi undang-undang bagi setiap wilayah; registri mengelaskan model mengikut peringkat kedaulatan.