LumiBaseDocs

Kiểm toán làm sạch bộ lọc (oracle trên trường bị ẩn)

Issue #738 (epic #674, S09). Trang này ghi lại cách LumiBase ngăn một caller suy ra giá trị của trường mà họ không được đọc, thông qua bộ lọc, sắp xếp, mở rộng quan hệ, biểu thức tìm kiếm hay số đếm. Mỗi vector có trạng thái và test chứng minh.

Mô hình mối đe dọa

Caller có quyền read trên một collection, nhưng whitelist trường của policy ẩn một số trường: fields: ['title'], fields: ['*', '-salary'], hoặc role public với danh sách trường hẹp. Đường đọc đã gỡ trường ẩn khỏi response (PermissionService.maskItem). Nhưng bộ lọc, sắp xếp và biểu thức tìm kiếm được database hoặc search engine đánh giá trên row đã lưu. Vì vậy nếu không có lớp chặn, caller vẫn có thể đặt câu hỏi về giá trị bị ẩn:

  • Oracle boolean. ?filter[salary][_gt]=100000 trả row về hoặc không, và meta.total vẫn đếm nó. Với _starts_with, caller có thể dò ra giá trị từng ký tự một.
  • Oracle thứ tự. ?sort=salary xếp các row theo thứ tự của giá trị bị ẩn.
  • Oracle tồn tại. ?filter[secret][_null]=true cho biết giá trị có được đặt hay không.
  • Ký tự đại diện. _contains: '%' khớp mọi row, còn _ khớp một ký tự bất kỳ. Chúng giúp dò nhanh hơn, và còn nới rộng permission rule có giá trị đến từ caller (ví dụ $CURRENT_USER.email chứa %).
  • Quan hệ. Gom các row con theo khóa ngoại mà caller không được đọc sẽ cho thấy row con nào thuộc row cha nào.
  • Tìm kiếm. Engine khớp q với _title. _title là bản sao của một trường item, và trường đó có thể bị ẩn. Tổng số của engine cũng đếm cả những row caller không thấy.

Lớp chặn

apps/cms/src/services/filter-guard.ts quyết định trước khi chạy bất kỳ truy vấn nào. Mọi trường được bộ lọc nhắc tới (duyệt qua _and / _or, xét segment cấp cao nhất của JSON path có dấu chấm) hoặc được token sắp xếp nhắc tới đều phải đọc được theo quyền read của caller. Cột cấu trúc (id, status, sort, timestamp, user_*) không bao giờ bị che nên luôn được phép. Quyết định chỉ dựa vào permission và truy vấn, không bao giờ dựa vào dữ liệu, nên bản thân việc từ chối không thể làm lộ gì:

  • Cùng một response cho mọi tập dữ liệu: HTTP 403, mã FIELD_FORBIDDEN. Thông báo nêu tên trường mà chính caller đã gửi.
  • Không có round-trip tới database, nên không có gì về dữ liệu lộ qua thời gian phản hồi.
  • Trường không tồn tại bị từ chối y hệt trường bị ẩn, nên caller bị giới hạn không thể dùng việc từ chối để dò schema.
  • Caller có fields: ['*'] (hoặc không có permission context: đường nội bộ và admin) không bị giới hạn.

ItemService.list chạy lớp chặn. REST GET /items/:collection, endpoint export, truy vấn list của GraphQL, đọc item qua MCP / AI và truy cập dữ liệu của extension đều đi qua đó. Route tìm kiếm áp dụng cùng quy tắc cho chuỗi filter / sort của Meili.

Các vector

#VectorTrạng tháiTest
1_eq / _neq / _in / _gt… trên trường ẩnĐã sửa: FIELD_FORBIDDEN trước mọi truy vấnfilter-sanitisation.property.test.ts (thuộc tính oracle)
2_contains / _starts_with / _ends_with trên trường ẩnĐã sửa (cùng lớp chặn)như trên, danh sách hồi quy
3_null / _nnull trên trường ẩn (tồn tại)Đã sửa (cùng lớp chặn)như trên
4Mệnh đề ẩn lồng trong _or / _andĐã sửa: lớp chặn duyệt cùng cây với bộ dựng SQL; độ lồng giới hạn 16 tầng (INVALID_FILTER)như trên, MAX_FILTER_DEPTH
5JSON path vào trường ẩn (secret.x)Đã sửa: kiểm theo segment cấp cao nhất; author.name được phép khi author đọc đượcnhư trên
6_json_contains / _has_key trên trường ẩnĐã sửa (cùng lớp chặn)như trên
7sort=secret (oracle thứ tự)Đã sửa (cùng lớp chặn)như trên
8Phân biệt "bị ẩn" với "không tồn tại"Không thể: cả hai bị từ chối như nhautest lớp chặn thuần
9% / _ / \ trong bộ lọc item họ _containsĐã sửa: được escape, khớp theo nghĩa đenthuộc tính ngữ nghĩa LIKE
10Ký tự đại diện trong permission rule (giá trị magic như $CURRENT_USER.email)Đã sửa: SQL nay khớp với bộ đánh giá trong bộ nhớthuộc tính tương đương SQL ↔ evaluate
11filter của SCIM so khớp chuỗi con trên e-mailĐã sửa: được escape (bề mặt chỉ dành cho admin)n/a (thay đổi một dòng)
12SQL injection qua tên trường, JSON path, toán tử, giá trị, sortVốn đã an toàn: segment theo allow-list ^[A-Za-z0-9_]+$, giá trị và khóa được bind làm tham số, toán tử lạ bị từ chốithuộc tính injection (marker không bao giờ lọt vào text SQL)
13Bộ lọc quan hệ author.secret_fieldKhông phải join: khóa có dấu chấm là JSON path trong cùng row và không bao giờ chạm tới collection kháclớp chặn + #5
14Mở rộng o2m (fields=comments.*) khi FK của row con bị ẩnĐã sửa: mở rộng thành [] mà không nạp row cono2m expansion yields nothing…
15Mở rộng m2m qua junction mà caller không được đọcĐã sửa: cần quyền read trên junction, áp row rule của nó, và cả hai trường liên kết phải đọc được; nếu không thì []m2m expansion yields nothing…
16Mở rộng m2oVốn đã an toàn: đọc FK từ row đã được checác test quan hệ hiện có
17Tham số filter / sort của GraphQLĐã sửa: cùng đường ItemService.listđược #1–#7 bao phủ
18Trường o2m của GraphQL khi FK bị ẩnĐã sửa: trả [] cho mọi row cha, không báo lỗischema-builder.test.ts
19Keyset cursor mã hóa giá trị sắp xếp bị ẩnN/A: item dùng phân trang offset. Export phân trang keyset theo id (cột cấu trúc), và cursor của audit log (chỉ admin) mã hóa (timestamp, id)—
20Oracle số đếm meta.totalAn toàn: đếm với cùng WHERE (có cả row rule); bộ lọc trên trường ẩn không bao giờ được chạythuộc tính oracle
21Aggregate / groupByN/A: item không có endpoint aggregate—
22q của tìm kiếm khớp _title được chép từ trường ẩnĐã sửa: hit có _title đã lưu khác với title suy ra từ các trường đọc được thì bị bỏsearch-hidden-fields.test.ts
23totalHits của tìm kiếm đếm cả row caller không thấyĐã sửa: caller bị giới hạn nhận số hit thấy đượcnhư trên
24filter / sort của tìm kiếm trên thuộc tính ẩn (hoặc _title)Đã sửa: FIELD_FORBIDDEN trước khi gọi engine. Giá trị không đặt trong dấu nháy bị coi là thuộc tính, nên hãy đặt giá trị trong dấu nháynhư trên + thuộc tính về attribute
25Mặt nạ tìm kiếm với ['*', '-x'] gỡ hết mọi trườngĐã sửa (tính đúng): loại trừ nay được áp dụng đúngnhư trên
26Các section trang của /deliverN/A: caller không cung cấp filter hay sort; orderBy và status lấy từ layout trang do admin soạn—
27Thời gian phản hồi khi từ chốiAn toàn: quyết định trước mọi I/Othuộc tính oracle (không có select nào)

Các test nằm ở apps/cms/src/services/__tests__/filter-sanitisation.property.test.ts, apps/cms/src/routes/__tests__/search-hidden-fields.test.ts và apps/cms/src/graphql/__tests__/schema-builder.test.ts.

Rủi ro còn lại

  • Cách suy ra title khi tìm kiếm (1 bit). _title lấy từ giá trị không rỗng đầu tiên trong title / name / label / heading / slug, nếu không có thì từ trường chuỗi đầu tiên. Nếu một trong các trường đó bị ẩn, việc hit có bị bỏ hay không phụ thuộc vào việc trường ẩn đó có rỗng hay không. Nội dung trường ẩn không bao giờ lộ, nhưng "rỗng hay không" thì có. Muốn đóng hẳn cần sửa phía index: trường hiển thị được cấu hình, thuộc tính searchable theo từng trường và attributesToSearchOn theo role. Việc này được theo dõi trong backlog ngoài phạm vi.
  • Row rule trên trường ẩn. Policy có row rule kiểm tra một trường ẩn ({ salary: { _lt: 1000 } }) sẽ cho thấy row nào thỏa. Đó là lựa chọn của người viết policy, không phải input của caller.

Quy tắc cho code mới

  • Mọi filter, sort, cursor hay aggregate mới do caller cung cấp phải đi qua ItemService.list hoặc tự gọi findUnreadableQueryField, trước khi truy vấn.
  • Giá trị họ _contains phải đi qua apps/cms/src/services/like-pattern.ts, không bao giờ ghép thô '%' + value + '%'.
  • Cursor chỉ được mã hóa cột cấu trúc, hoặc trường caller đọc được, và phải được kiểm bằng lớp chặn khi giải mã.
Last modified: 15/11/2026