Giao diện
Bí mật & khoá
Trang sinh tự động
Đo trên source và trên schema sau khi chạy 820 migration, tại commit ad83b0aea. Chỉ TÊN biến, không bao giờ giá trị.
Tài liệu này không chứa giá trị secret nào
Dưới đây chỉ là tên biến môi trường. Giá trị do người vận hành đặt trực tiếp trong Edge Function secrets của từng project; CI không đọc được giá trị — nó chỉ liệt kê tên để kiểm thiếu đủ trước khi deploy.
Khoá ký nằm ở đâu
Access token ký bằng ES256 — khoá bất đối xứng. Ba hệ quả:
- Chỉ function
authcần khoá riêng. - Các function khác chỉ cần khoá công khai để xác thực.
- Xoay khoá theo
kidkhông đăng xuất ai: token cũ vẫn xác thực được bằng khoá công khai cũ cho tới khi hết hạn.
Supabase cấp secret theo project, nghĩa là về mặt nền tảng thì mọi function trong project đều đọc được mọi secret. Việc "khoá riêng chỉ nằm trong auth" vì vậy do code và gate CI bảo đảm, không phải do nền tảng.
Gate canh phạm vi bí mật
auth-secretsbackend-scopeclient-no-decodecontent-gates.testdiff-gatesdiff-gates.testlibno-gotrueui-diff
Chạy qua node scripts/auth-gates/run-all.mjs.
Tên biến môi trường có trong code
PiPoint
PIPOINT_AUTH_ENABLED · PIPOINT_AUTH_REQUIRED_APP_USER · PIPOINT_CONTRACT_VERSION · PIPOINT_EKYC_TRUSTED_VIA · PIPOINT_EVENTS_AUDIENCE · PIPOINT_EVENTS_PUSH_SA · PIPOINT_FAKE_ISSUER · PIPOINT_MODE · PIPOINT_PROJECT_ID · PIPOINT_SA_KEY_B64 · PIPOINT_TIMEOUT_MS
Danh tính và khoá ký
AUTH_ABSOLUTE_SECONDS_WEB_ADMIN · AUTH_ACCESS_TTL_SECONDS · AUTH_AUDIENCE · AUTH_IDLE_SECONDS_APP_SALE · AUTH_IDLE_SECONDS_APP_USER · AUTH_IDLE_SECONDS_WEB_ADMIN · AUTH_ISSUER · AUTH_PBKDF2_ITERATIONS · AUTH_SIGNING_KEY · AUTH_TRUSTED_ISSUERS
Kết nối và môi trường
PI_API_DB_URL · PI_AUTH_DB_URL · PI_ENVIRONMENT · PI_WORKER_DB_URL
Hạ tầng Supabase
SUPABASE_DB_URL · SUPABASE_SERVICE_ROLE_KEY · SUPABASE_URL
Quy tắc
- Giá trị secret không bao giờ vào Git, kể cả trong file ví dụ.
- Giá trị không bao giờ được trả về client hay ghi vào log.
- CI chỉ kiểm sự tồn tại của tên, không đọc giá trị.
- Khoá dịch vụ của PiPoint có gate riêng bảo đảm function
authkhông bao giờ giữ nó.