EYWAL Developers API 1.0 · 2026-11-17

Security & Trust

Mỗi tuyên bố bảo mật dưới đây đi kèm cơ chế, bằng chứng kiểm thử và giới hạn. Kết quả lấy từ bộ test tự động của EYWAL chạy ngày 2026-11-17 (41 file test) và kiểm thật trên production. Bạn có thể tự tái lập phần lớn bằng dự án của chính mình (xem Tự kiểm chứng).

Every security claim below comes with its mechanism, test evidence and limits. Results come from EYWAL's automated suite run on 2026-11-17 (41 test files) and live production checks. You can reproduce most of them with your own project (see Verify it yourself).

Ranh giới tin cậy: ai thấy gì

Trust boundaries: who sees what

BênPartyThấy đượcCan seeKhông thấy đượcCannot see
Ứng dụng của bạnYour appprofileid của dự án bạn, tên/ảnh người dùng chọn chia sẻYour project's profileid, the name/picture the user sharesDanh tính gốc, profileid ở dự án khác, email và số điện thoại (bản hiện tại không trả, kể cả dự án verified)Root identity, profileids in other projects, email and phone (not returned in the current version, even for verified projects)
Trình duyệtBrowserToken một lần (5 giây) trên URL callbackThe one-time token (5 s) on the callback URLHồ sơ: chỉ máy chủ của bạn đổi được token, có PKCE/secretThe profile: only your server can exchange it, with PKCE/secret
Cơ sở dữ liệu EYWALEYWAL databaseHash, bản mã, thời gian; ảnh đại diện (lưu dạng thường); một phần quan hệ bản ghi suy được qua dấu thời gian (DATA-001B)Hashes, ciphertext, timestamps; profile photos (stored unencrypted); some record relations inferable from timestamps (DATA-001B)Bảng ánh xạ người dùng → container → dự án (không tồn tại, DATA-001A). Nội dung vault: chưa bảo đảm (DATA-002A chưa PASS)A user → container → project mapping table (none exists, DATA-001A). Vault contents: not guaranteed yet (DATA-002A not yet PASS)
Máy chủ EYWAL đang chạyRunning EYWAL serverKhoá phiên của người dùng trong lúc họ đăng nhậpThe user's session key while they are signed inChưa có bảo đảm (DATA-002C, RT-001)No guarantee yet (DATA-002C, RT-001)
Trung gian mạng (Cloudflare)Network intermediary (Cloudflare)Lưu lượng của eywal.com và auth.eywal.com sau khi giải TLS, gồm yêu cầu đăng nhập passkey. Passkey được đăng ký cho auth.eywal.com; giá trị PRF của passkey đi qua trung gian nàyTraffic for eywal.com and auth.eywal.com after TLS termination, including passkey sign-in requests. Passkeys are registered to auth.eywal.com; the passkey PRF value passes through this intermediaryChưa có bảo đảm; đang đánh giá phương án kết nối thẳng cho auth.eywal.comNo guarantee yet; a direct connection for auth.eywal.com is being evaluated

Ma trận tuyên bố bảo mật

Security claims matrix

Mọi trạng thái là kiểm chứng nội bộ (test tự động + kiểm production) ngày 2026-11-17, chưa phải kiểm toán độc lập. PARTIAL nghĩa là đúng trong phạm vi đã ghi, còn đường hở được nêu ngay trong dòng. Bảng này là tập con công khai của sổ claim nội bộ; sổ nội bộ có thêm các phát hiện bảo mật (SEC-01..04) chưa công bố chi tiết cho tới khi sửa xong.

Every status is internal verification (automated tests + production checks) on 2026-11-17, not an independent audit. PARTIAL means true within the stated scope, with the remaining gap named in the row. This table is a public subset of the internal claims register, which also tracks security findings (SEC-01..04) whose details stay unpublished until fixed.

IDTuyên bốClaimCơ chế / giới hạnMechanism / limitBằng chứngEvidenceTrạng tháiStatus
ID-001Mỗi project nhận một profileid riêng; hạn chế liên kết qua mã định danh EYWAL (thuộc tính tự chia sẻ và metadata vẫn có thể giúp nhận diện)Each project gets its own profileid, limiting linkage via the EYWAL identifier (shared attributes and metadata can still help correlate)profileid dẫn xuất theo dự án và chế độ hồ sơ; dạng cũ dẫn xuất từ cột bind có trong DB (xem ID-002)profileid derived per project and profile mode; the legacy form derives from bind, which is in the DB (see ID-002)crypto_vectors_test 17/17 · session_exchange_test 33/33VERIFIED INTERNALLY
ID-002Người nắm DB không tính được profileidA database holder cannot compute profileidsDạng cũ suy từ cột bind (có trong DB); dạng mới HMAC từ khoá người dùng đang chuyển (F-08)Legacy form derives from bind (in the DB); new HMAC form from the user key is migrating (F-08)F-08 pha 1 · f08_profile_testPARTIAL
DATA-001ACSDL không có bảng ánh xạ, chủ sở hữu hay khoá ngoạiNo mapping table, owner column or foreign key5 bảng chỉ hash, bản mã, thời gian5 tables of hashes, ciphertext, timestampsblind_schema_test 10/10 · information_schema: 0 FKVERIFIED INTERNALLY
DATA-001BKhông ghép được bản ghi với nhau qua metadataRecords cannot be linked to each other through metadataHiện chưa đúng. Mô phỏng nội bộ ghép được một phần bản ghi qua dấu thời gian tạo/cập nhật. Đang thiết kế cách khắc phục; chi tiết nằm trong báo cáo nội bộ.Not true today. An internal simulation matched part of the records through created/updated timestamps. A fix is being designed; details stay in the internal report.mô phỏng phân tích metadata, 2026-11-17metadata-analysis simulation, 2026-11-17FAIL
DATA-002AChỉ có bản sao DB (không bí mật máy chủ) thì không mở được vault người dùngA database copy alone (no server secrets) cannot open user vaultsĐường passkey: reviewer nội bộ đánh giá đạt có điều kiện. Còn bản ghi thế hệ cũ đang được đóng (khoá tra cứu đăng nhập Google chưa có khoá bí mật; một số khoá dữ liệu dự án dạng cũ). Chi tiết chỉ nằm trong báo cáo nội bộ.Passkey path: conditionally passed by internal review. Older-generation records are still being closed (the Google sign-in lookup hash is not yet keyed; some legacy project-data keys). Details stay in the internal report.review nội bộ + thực nghiệm, 2026-11-17internal review + experiments, 2026-11-17NOT YET PASS
DATA-002BCó DB và bí mật máy chủ vẫn không mở được vault người dùngDB plus server secrets still cannot open user vaultsHiện chưa đúng. Vault mở bằng thẻ đăng nhập Google thế hệ cũ vẫn mở được bằng bí mật phía máy chủ. Mã khắc phục (SEC-02 R1) đã triển khai nhưng chưa bật; một đường khác (SEC-01) đã đóng và nghiệm thu nội bộ 2026-11-17.Not true today. Vaults opened by older-generation Google sign-in cards can still be opened with server-side secrets. The fix (SEC-02 R1) is deployed but not yet switched on; another path (SEC-01) was closed and internally accepted on 2026-11-17.ARCHITECTURE_CONFLICT · SEC-01 PASS · SEC-02 chưa bậtnot enabledFAIL
DATA-002CChiếm ứng dụng hoặc root máy chủ vẫn không mở được vaultTaking over the app or server root still cannot open vaultsKiến trúc hiện tại không cam kết mức này: máy chủ đang chạy xử lý khoá phiên và dữ liệu đã giải mã (RT-001).The current architecture does not commit to this level: the running server handles the session key and decrypted data (RT-001).theo thiết kếby designFAIL
DATA-003Thông tin dự án được tách quyền theo 4 lớpProject metadata is separated into 4 access layers(1) Trong DB: bản mã; có DB kèm bí mật máy chủ thì giải mã được, và với bản ghi dạng cũ, khoá có thể suy được nếu biết mã dự án cũ (đang đánh giá và đóng); (2) Máy chủ đang chạy giải mã để hiển thị consent và kiểm redirect; (3) Công khai cho người dùng trên màn hình consent: tên, logo; (4) Chỉ chủ dự án quản lý: cấu hình, danh sách redirect, client secret. Quyền đọc lúc chạy (2) không đồng nghĩa với quyền đọc DB (1). Không suy ra được dự án thuộc người dùng nào.(1) In the DB: ciphertext; a DB copy plus server secrets can decrypt it, and for legacy records the key may be derivable from the old project identifier (being assessed and closed); (2) the running server decrypts it to render consent and check redirects; (3) public to users on the consent screen: name, logo; (4) managed by the project owner only: settings, redirect list, client secret. Runtime read access (2) is not DB read access (1). The owning user cannot be inferred.Theo thiết kế; xem DATA-001PARTIAL
AUTH-001Token chỉ dùng một lần, hết hạn sau khoảng 5 giây (tối đa ~6 giây do làm tròn giây)Tokens are single-use and expire after about 5 s (up to ~6 s due to second rounding)Đổi bằng rename nguyên tử; kiểm expAtomic rename on exchange; exp checksession_exchange_test 33/33VERIFIED INTERNALLY
AUTH-002Lộ token trên URL callback không đủ để đăng nhập thayA leaked callback token is not enough to sign inPKCE S256 + client secret tuỳ chọn; token nằm trong query nên có thể vào log/lịch sử của RPPKCE S256 + optional secret; the token sits in the query string and may reach RP logs/historyp0_session_pkce_test 12/12; chưa có cơ chế đưa token ra khỏi URLPARTIAL
AUTH-003Dự án bắt buộc PKCE không bị hạ cấpPKCE-required projects cannot be downgradedKiểm ở consent và /sessionEnforced at consent and /sessionp0_pkce_downgrade_test 9/9 (staging) + kiểm production 2026-11-17VERIFIED INTERNALLY
AUTH-004Chống login CSRF và mở chuyển hướngLogin CSRF and open redirectstate; redirect phải xác minh; ràng buộc redirect_uristate; verified redirects; redirect_uri bindingauth_hardening_test 12/12VERIFIED INTERNALLY
AUTH-005PKCE giữ nguyên khi người dùng phải đăng nhập giữa chừngPKCE survives a mid-flow sign-inTrước đây PKCE có thể không được giữ qua bước đăng nhập khi người dùng chưa đăng nhập lúc mở consent (dự án bắt buộc PKCE bị từ chối thay vì hạ cấp). Bản sửa đã áp production 2026-11-17 07:52 UTC; nghiệm thu chính thức đang chờ.Previously PKCE might not carry over the sign-in step when the user was signed out on reaching consent (PKCE-required projects were refused rather than downgraded). The fix was applied to production on 2026-11-17 07:52 UTC; formal acceptance is pending.đọc mã + curl, 2026-11-17; áp production 07:52 UTCcode review + curl, 2026-11-17; applied 07:52 UTCAPPLIED · ACCEPTANCE PENDING
CONSENT-001Thu hồi không bị ghi đè khi chạy song songRevocation survives concurrent writesGhi có điều kiện (CAS)Conditional writes (CAS)p1_grant_race_test: 12 tiến trình × 5 vòng + nhóm đối chứngVERIFIED INTERNALLY
PRIV-001Hồ sơ chính không tạo liên kết chéo qua thuộc tínhThe main profile creates no cross-app link through attributesTên và ảnh của hồ sơ chính giống nhau ở mọi app; dùng hồ sơ ẩn danh để tránhMain-profile name and picture are identical across apps; use the anonymous profile to avoid thisĐề xuất A1 (người dùng tự chọn chia sẻ ảnh)PARTIAL
OPS-001Giới hạn tần suất, đóng khi lỗiRate limits, fail-closedTheo IP-hash, cửa sổ thời gianPer IP-hash, time windowsrate_limit_failclosed_test 19/19VERIFIED INTERNALLY
OPS-002Chặn SSRFSSRF blockedChặn mạng nội bộ, ghim IP, không theo chuyển hướngInternal ranges blocked, IP pinning, no redirectsf05_ssrf_test 38/38VERIFIED INTERNALLY
OPS-003Phát hiện file lõi bị sửaCore-file tampering detectedTripwire SHA-256 cho 6 file, kiểm hằng ngàySHA-256 tripwire on 6 files, dailyverify_core_lock.phpVERIFIED INTERNALLY
RT-001An toàn khi máy chủ đang chạy bị chiếm hoàn toànSafe under full takeover of the running serverChưa có: khoá phiên đi qua máy chủ khi người dùng đăng nhậpNone yet: the session key passes through the server at sign-inGiới hạn kiến trúc đã biếtKnown architectural limitNOT MET
STD-001Tương thích OIDC, W3C DID / Verifiable CredentialsOIDC, W3C DID / Verifiable Credentials compatibilityChưa triển khaiNot implemented—PLANNED

Kẻ tấn công lấy được gì

What an attacker gets

Khả năngCapabilityKết luậnConclusion
Chỉ có bản sao DBDatabase copy onlyChỉ bản sao DB (không khoá máy chủ): chưa chứng minh được là không mở vault (DATA-002A chưa PASS); ghép được một phần bản ghi qua dấu thời gian (DATA-001B); thông tin dự án dạng cũ có thể đọc được nếu biết mã dự án cũ (DATA-003). DB kèm bí mật phía máy chủ: vault của thẻ Google thế hệ cũ mở được (DATA-002B) và đọc được thông tin dự án lớp (1) (DATA-003). Tính được profileid dạng cũ cho tới khi xong F-08 (ID-002).DB copy alone (no server keys): not yet proven unable to open vaults (DATA-002A not yet PASS); some records can be matched through timestamps (DATA-001B); legacy project metadata may be readable if the old project identifier is known (DATA-003). DB plus server-side secrets: vaults of older-generation Google cards can be opened (DATA-002B), and layer (1) project metadata can be read (DATA-003). Can compute legacy profileids until F-08 completes (ID-002).
Quyền quản trị DBDatabase adminNhư trên; thêm khả năng xoá hoặc quay lui bản ghi (phát hiện được qua backup, không giải mã được).As above, plus deleting or rolling back rows (detectable via backups, not decryptable).
Đánh cắp phiên một người dùngStolen session of one userVào được tài khoản người đó tới khi phiên hết hạn (idle 14 ngày, tối đa 30 ngày) hoặc bị thu hồi; người dùng có “Không phải tôi” và “Đăng xuất mọi thiết bị”.Access to that account until the session expires (14 days idle, 30 max) or is revoked; users have “Not me” and “Sign out everywhere”.
Root máy chủ đang chạyRoot on the running serverChưa có bảo đảm (DATA-002C, RT-001).No guarantee yet (DATA-002C, RT-001).

Đối chiếu tiêu chuẩn

Standards mapping

Yêu cầuRequirementEYWALEYWAL
RFC 7636 · S256Chỉ nhận S256, từ chối plain; verifier 43–128 ký tự (AUTH-003, vector RFC khớp)S256 only, plain rejected; 43–128 char verifier (AUTH-003, RFC vector matches)
RFC 9700 · redirect chính xácRFC 9700 · exact redirectRedirect phải xác minh trước; ràng buộc redirect_uri khi đổi token (AUTH-004)Redirects must be verified first; redirect_uri bound at exchange (AUTH-004)
RFC 9700 · chống CSRFRFC 9700 · CSRFstate + PKCE (AUTH-004)state + PKCE (AUTH-004)
RFC 9700 · PKCE cho public clientRFC 9700 · PKCE for public clientsHỗ trợ; bắt buộc theo cấu hình dự án, chưa bắt buộc mặc địnhSupported; enforced per project, not yet the default
RFC 9700 · mã ngắn hạn, một lần, ràng buộcRFC 9700 · short-lived, single-use, bound codesToken một lần, 5 giây, ràng buộc dự án + redirect + PKCE (AUTH-001, AUTH-002). Token đi qua query callback như mã OAuth chuẩn, nên RP phải giữ token khỏi log và Referer.Single-use, 5 s, bound to project + redirect + PKCE (AUTH-001, AUTH-002). The token travels in the callback query like a standard OAuth code, so RPs must keep it out of logs and Referer.
Tài liệu viết theo mã đang chạy ngày 2026-11-17. Trang tĩnh, không cơ sở dữ liệu, không giữ bí mật.