EYWAL Developers API 1.0 · 2026-11-17

Kiến trúc

Architecture

Một danh tính EYWAL gốc, mỗi project một mã hồ sơ riêng. Trạng thái từng cơ chế được ghi rõ: đã triển khai, đang làm hoặc mục tiêu.

One root EYWAL identity, a separate profile id per project. Each mechanism is labelled as implemented, in progress or target.

EYWAL danh tính gốc · root Project 1profile_4c1e Project 2profile_9b02 Project 3profile_e7d5 ✕ không có bảng ánh xạ
Danh tính gốc không rời EYWAL. Mỗi project nhận một định danh riêng, hạn chế liên kết qua mã định danh EYWAL; thuộc tính người dùng tự chia sẻ (tên, ảnh) và metadata vẫn có thể giúp nhận diện chung.
The root identity never leaves EYWAL. Each project gets its own identifier, limiting linkage through the EYWAL identifier; attributes the user chooses to share (name, picture) and metadata can still help correlate.

Quản lý khoá & ranh giới tin cậy

Key management & trust boundaries

Mô tả ở mức khái niệm. Không công bố tên khoá, cấu trúc lưu trữ hay chi tiết các phát hiện đang khắc phục.

Conceptual level only. Key names, storage layout and details of findings under remediation are not published.

Ai / cái gìWho / whatGiữ gìHoldsTrạng tháiStatus
Người dùngUserPhương tiện mở khoá tài khoản: cookie thiết bị tin cậy, passkey, mã khôi phục, đăng nhập Google. Đây là cách chứng minh quyền, không phải danh tính gốc. Thẻ Google thế hệ cũ vẫn mở được bằng bí mật máy chủ (DATA-002B).Unlock factors: trusted-device cookie, passkey, recovery code, Google sign-in. These prove access; they are not the root identity. Older-generation Google cards can still be opened with server secrets (DATA-002B).Đã triển khaiImplemented
Cơ sở dữ liệuDatabaseBản mã, hash, thời gian; không bảng ánh xạ người dùng ↔ ứng dụng (DATA-001A). Ảnh đại diện lưu dạng thường; ghép được một phần bản ghi qua dấu thời gian (DATA-001B).Ciphertext, hashes, timestamps; no user ↔ app mapping table (DATA-001A). Profile photos stored unencrypted; some records can be matched through timestamps (DATA-001B).001A đã triển khai001A implemented 001B FAIL
Bí mật phía máy chủServer-side secretsMục tiêu: một mình chúng (kể cả kèm DB) không đủ mở vault. Hiện chưa đạt: thẻ Google thế hệ cũ mở được bằng DB kèm bí mật máy chủ; mã khắc phục đã triển khai, chưa bật.Target: they alone (even with the DB) cannot open vaults. Not met yet: older-generation Google cards can be opened with the DB plus server secrets; the fix is deployed but not yet switched on.DATA-002B FAIL 002A NOT YET PASS
Máy chủ đang chạyRunning serverTrong lúc người dùng đăng nhập, máy chủ xử lý khoá phiên và dữ liệu đã giải mã để phục vụ yêu cầu.While a user is signed in, the server handles the session key and decrypted data to serve requests.Giới hạn đã biết (DATA-002C, RT-001)Known limit (DATA-002C, RT-001)
Trung gian mạng (Cloudflare)Network intermediary (Cloudflare)Giải TLS cho eywal.com và auth.eywal.com nên thấy yêu cầu đăng nhập, kể cả giá trị PRF của passkey (passkey đăng ký cho auth.eywal.com).Terminates TLS for eywal.com and auth.eywal.com, so it sees sign-in requests, including the passkey PRF value (passkeys are registered to auth.eywal.com).Giới hạn đã biếtKnown limit
Ứng dụng (project)App (project)profileid riêng của project và thuộc tính người dùng chọn chia sẻ; không thấy danh tính gốc.Its own profileid and attributes the user chose to share; never the root identity.Đã triển khaiImplemented
Giải mã phía người dùngUser-side decryptionKhoá chỉ mở được trên thiết bị người dùng, máy chủ không thấy bản rõ.Keys unlock only on the user's device; the server never sees plaintext.Mục tiêuTarget

Mô hình bảo vệ & trạng thái

Protection model & status

Khi kẻ tấn công chỉ có bản sao cơ sở dữ liệu hoặc quyền truy cập database, kiến trúc điểm mù ngăn dựng lại cây dữ liệu từ bảng ánh xạ (không có bảng nào như vậy). Tuy vậy, vẫn ghép được một phần bản ghi qua dấu thời gian (DATA-001B, chưa đạt). Việc giải mã vault chưa được bảo đảm, chia theo ba mức: chỉ có DB (DATA-002A, chưa PASS), DB kèm bí mật máy chủ (DATA-002B, FAIL), chiếm ứng dụng hoặc root (DATA-002C, FAIL). EYWAL chưa chứng minh được bảo vệ tuyệt đối khi kẻ tấn công chiếm toàn quyền máy chủ đang chạy, vì khoá phiên của người dùng đi qua máy chủ trong lúc xử lý.

When an attacker only has a database copy or database access, the blind architecture prevents rebuilding the data tree from mapping tables (there are none). Even so, some records can still be matched through timestamps (DATA-001B, not met). Vault decryption is not guaranteed yet, split into three levels: database copy only (DATA-002A, not yet PASS), database plus server secrets (DATA-002B, FAIL), takeover of the app or root (DATA-002C, FAIL). EYWAL has not yet proven full protection against an attacker who controls the running server, because the user's session key passes through the server during processing.

Cơ chếMechanismTrạng tháiStatus
Mỗi project một mã hồ sơ, không bảng ánh xạ, vault 3 lớp mã hoáPer-project profile id, no mapping tables, 3-layer encrypted vaultĐã triển khaiLive
Token một lần 5 giây, redirect đã xác minh, state, PKCE S256, client secret5-second one-time token, verified redirects, state, PKCE S256, client secretĐã triển khaiLive
Người dùng xem và thu hồi quyền ứng dụngUsers review and revoke app accessĐã triển khaiLive
Mã hồ sơ thế hệ mới, không suy ra được từ cơ sở dữ liệu (F-08)Next-generation profile id not derivable from the database (F-08)Đang chuyển đổiMigrating
sdk.js hỗ trợ state và PKCEsdk.js with state and PKCEĐang làmIn progress
Bảo vệ cả khi máy chủ đang chạy bị chiếm (giải mã phía người dùng)Protection even if the running server is taken over (user-side decryption)Mục tiêuGoal
Chuẩn OIDC, W3C DID / Verifiable CredentialsOIDC, W3C DID / Verifiable CredentialsMục tiêuGoal
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.