Skip to main content

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):

  1. Selesaikan residency_region organisasi (lajur pada organizations, NULL = global).
  2. Jika global → lepas bebas (tiada beban tambahan kependaman, tiada penilaian pek).
  3. 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
  1. Apabila dibenarkan, respons membawa X-Residency-Region dan X-Residency-Pack.

Gagal-tertutup adalah disengajakan: bagi wilayah yang terkawal, menyekat lebih selamat daripada melayan melalui bidang kuasa yang salah.

Peraturan lalai​

WilayahID PekBidang kuasa dibenarkanFamili dibenarkanResidensi dataSenarai hitam
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—

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 / ditolak
  • gateway_residency_remap_total{region} — ditolak → pemetaan semula dalam wilayah
  • gateway_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.