Phạm vi hiển thị tài nguyên

Mỗi tài nguyên — agent, skill, ứng dụng kết nối, mẫu prompt, artifact và kho tri thức — mang quy tắc chia sẻ của riêng nó. Phạm vi hiển thị trả lời câu hỏi người này được thao tác trên những gì. Nó chạy ở mỗi lần mở và mỗi danh sách, và không cấp quyền hạn, mô hình hay ngân sách nào.

Quy tắc chính

Quy tắc chặn được xét trước và luôn thắng, kể cả với chủ sở hữu.
Một quy tắc chỉ định một phòng ban, một nhóm hoặc một người.
Phạm vi hiển thị không bao giờ cấp quyền hạn, mô hình hay ngân sách — chỉ quyền được thấy và dùng.
Bị ẩn trông y như không tồn tại. Không ai biết được tài nguyên có tồn tại.
Kho tri thức quyết định cho mọi thứ bên trong nó.

Thử ngay: sân chơi phạm vi hiển thị

Chọn một người, bật tắt quy tắc và xem quá trình kiểm tra chạy. Thứ tự giống hệt thứ tự portal dùng ở mọi danh sách và mọi lần mở.

Thử nghiệm quyền xem Tương tác

Tài nguyên

Pricing AssistantAgent · Le Minh sở hữu

Can use it · cho phép

Hidden from · chặn

Bấm vào một quy tắc để bật hoặc tắt

Kiểm tra cho

Đường quyết địnhtrực tiếp

1. Tài khoản còn hoạt động?Tài khoản bị tạm ngưng hoặc đã xoá không thấy gì. Có
2. Tài nguyên có tồn tại?Tài nguyên đã xoá không trả về gì. Có
3. Có quy tắc chặn nào khớp?Khớp khi nêu tên người đó, phòng ban hoặc một nhóm của họ. Contractors
4. Có chia sẻ cho mọi người?Công tắc cho toàn tổ chức. Chưa xét
5. Người đó là chủ sở hữu?Chủ sở hữu luôn thấy tài nguyên của mình. Chưa xét
6. Có quy tắc cho phép nào khớp?Cách khớp giống quy tắc chặn. Chưa xét

Ẩn với Tran MaiQuy tắc chặn nêu tên nhóm của cô, Contractors. Cô nhận "không tìm thấy".

Cấu trúc quy tắc

Mỗi tài nguyên mang quy tắc riêng. Không tài nguyên nào thuộc về phòng ban, nên không có gì được kế thừa.

orgWide: true | false
allow:   departments, groups, users
deny:    departments, groups, users

Chỉ công tắc toàn tổ chức được lưu. Tài nguyên đóng có quy tắc là cái mà màn hình gọi là Restricted (hạn chế); không có quy tắc là Private (riêng tư).
Mỗi quy tắc gồm một hiệu lực (cho phép hoặc chặn) và đúng một trong: phòng ban, nhóm hoặc một người.
“Khớp” là cùng một phép thử cho chặn và cho phép: quy tắc chỉ định chính người này, phòng ban họ được tính phí, hoặc một trong các nhóm của họ.

Thứ tự kiểm tra

Các bước chạy từ trên xuống, bước đầu tiên cho ra đáp án sẽ kết thúc.

Tài khoản đang hoạt động

Người bị tạm ngưng trong portal hoặc bị vô hiệu trong nhà cung cấp định danh không thấy gì, với mọi tài nguyên.
Tài nguyên tồn tại trong tổ chức

Tài nguyên không tồn tại thì không có gì để hiện.
Có quy tắc chặn khớp — dừng tại đây

Một lần khớp là ẩn tài nguyên. Chủ sở hữu, quy tắc cho phép hay “mọi người” đều không gỡ được.
Chia sẻ với mọi người

Công tắc toàn tổ chức làm nó hiển thị với tất cả những người còn lại.
Chủ sở hữu

Chủ sở hữu luôn thấy, trừ khi quy tắc chặn đã nói không.
Có quy tắc cho phép khớp

Khớp thì hiển thị. Không khớp: bị ẩn.

Quy tắc chặn luôn thắng

Quy tắc chặn được xét trước công tắc toàn tổ chức, quyền sở hữu và quy tắc cho phép, và trả kết quả ngay. Một nhà thầu trong phòng Sales vẫn bị chặn khỏi agent của Sales khi có quy tắc chặn chỉ định nhóm của họ: quy tắc cho phép theo phòng ban, công tắc toàn tổ chức hay quyền sở hữu đều không cứu được ai.

Thắng cả quyền sở hữu giúp người rà soát tuân thủ gỡ một tài nguyên mà không đổi chủ sở hữu. Điều này cũng đúng khi ghi, vì sửa cũng đòi hỏi tài nguyên phải hiển thị.

Kho tri thức và mọi thứ bên trong

Kho tri thức (tên nội bộ là collection) là một tài nguyên như mọi tài nguyên khác. Không thứ gì bên trong có đáp án riêng: một câu trong bộ nhớ và một đoạn tài liệu là các dòng trong cùng một kho lưu trữ, mỗi dòng ghi tên kho tri thức của nó, và đọc hay ghi đều theo đáp án của kho tri thức.

Các kho tri thức mà một lần tìm kiếm được đọc được phân giải theo người dùng trước khi truy vấn chạy. Kho bị từ chối không trả lời gì — kể cả qua một agent được gắn với kho đó.

Bộ nhớ cá nhân của bạn nằm trong một kho tri thức bạn sở hữu, không có quy tắc và không xuất hiện trong danh sách nào; bạn không cần quyền hạn nào để ghi vào đó. Một câu có ghi kèm hội thoại và thời hạn vẫn là cùng loại dòng, chỉ sống ngắn hơn.

Kiểm tra truy cập bằng lời thường

Phạm vi hiển thị kết hợp với quyền hạn của người dùng từ Vai trò và quyền hạn:

Hành động	Được phép khi
Đọc	tài nguyên hiển thị với bạn
Sửa	tài nguyên hiển thị và bạn sở hữu nó hoặc giữ quyền manage của loại đó
Đổi chia sẻ	bạn sở hữu và nó hiển thị với bạn — hoặc bạn giữ quyền chia sẻ

Quyền chia sẻ (visibility.manage) bỏ qua phép thử hiển thị, vì tài nguyên riêng tư vô hình với mọi người trừ chủ sở hữu, và người giữ quyền này phải quản được nhiều hơn những gì được chia sẻ với họ. Nhưng họ vẫn không chạm được tài nguyên của tổ chức khác.
Đường của chủ sở hữu vẫn giữ phép thử hiển thị, nên quy tắc chặn ẩn tài nguyên khỏi chủ sở hữu không trao cho họ quyền gỡ quy tắc đó.
Quyền sửa nội dung không bao giờ được tính là quyền đổi chia sẻ.

Cam kết

Cam kết	Cách thực hiện
Người không có quyền truy cập không thấy gì, với mọi tài nguyên	kiểm tra trước khi chạm dữ liệu tài nguyên hay quy tắc, cho cả người bị vô hiệu ở IdP lẫn bị tạm ngưng trong portal
Danh sách được lọc trước khi phân trang, không phải sau	trang 3 là trang 3 của những gì bạn thấy
Không hiển thị thì báo “không tìm thấy”, không bao giờ “bị cấm”	mọi lần mở trả cùng lỗi như tài nguyên không tồn tại
Mọi danh sách bạn thấy đều được lọc	backend của portal quyết định; một màn hình không lọc cũng là cùng một lỗ hổng

Thư viện của bạn

Tiếp cận được một tài nguyên là chuyện quản trị: người chia sẻ và quản trị viên quyết định, chặn thắng cho phép, bị từ chối là “không tìm thấy”. Có nó trên kệ của mình là lựa chọn của bạn và không cần quyền hạn nào.

Quy tắc	Chi tiết
Chia sẻ đẩy (pushed)	Chia sẻ từ người giữ quyền manage của loại đó (với mọi thứ trừ artifact) vào thẳng thư viện của bạn
Chia sẻ mời (offered)	Chia sẻ từ đồng nghiệp chờ đến khi bạn thêm
Hai chia sẻ mâu thuẫn	Chia sẻ đẩy thắng
Quyền sở hữu	Tài nguyên của bạn luôn trên kệ, kể cả khi riêng tư
Artifact	Luôn là chia sẻ mời: bạn phải bấm Add, kể cả với artifact toàn tổ chức hay được đẩy. Sản phẩm của chính bạn vẫn có sẵn
Đã gỡ	Việc bạn gỡ thắng một lần đẩy sau đó. Không ai chèn lại vào danh sách của người khác được
Lưu trữ	Chỉ lưu khi khác mặc định; chia sẻ với nhóm hai trăm người không ghi dòng nào
Kho tri thức	Không nằm trên kệ — bạn vào chúng từ màn hình tri thức

Cách chia sẻ và quản lý kệ: Chia sẻ và thư viện của bạn.

Các mức chia sẻ

Bảng chia sẻ có ba mức. Chỉ một công tắc được lưu — mở cho mọi người hay không — còn các quy tắc bạn thêm làm nó thành hạn chế.

Mức	Ai thấy	Ghi chú
Everyone (toàn tổ chức)	cả tổ chức, trừ người bị quy tắc chặn chỉ định	cần quyền công bố, như `agent.publish_org`
Restricted (hạn chế)	chỉ các phòng ban, nhóm và người bạn thêm, trừ chặn	mặc định khi chia sẻ
Only you (riêng tư)	chủ sở hữu	tài nguyên mới bắt đầu ở đây

Bạn đặt mức này trong mục Sharing (Chia sẻ) của tài nguyên.

Bảng chia sẻ của một agent — Mục Sharing của một agent.

Quy tắc của trình chỉnh sửa:

Trạng thái chia sẻ hiện tại được đọc trước khi hiển thị. Khi chưa có, không có huy hiệu, trình chỉnh sửa báo đang đọc, và việc lưu bị từ chối — mỗi lần lưu thay toàn bộ trạng thái chia sẻ, nên một phỏng đoán sẽ xóa các quy tắc bạn không được thấy.
Quy tắc được giữ qua một lần lưu giữ nguyên định danh và thời điểm tạo.
Only you dành cho chủ sở hữu, nên tài nguyên không có chủ thì không thể đặt riêng tư; lựa chọn bị làm mờ, và lần lưu khiến tài nguyên không ai tiếp cận được sẽ bị từ chối.
Chuyển sang Only you xóa các quy tắc cho phép. Quy tắc chặn tồn tại qua mọi lần đổi mức; gỡ quy tắc chặn vẫn cần visibility.manage.
Danh sách cho phép chỉ áp dụng ở Restricted; ở các mức khác chúng bị bỏ.

Vì sao lại như vậy

Vì sao tài nguyên bị ẩn là 'không tìm thấy' chứ không phải 'bị cấm'?

“Bị cấm” sẽ xác nhận tài nguyên có tồn tại. Trả “không tìm thấy” cho cả trường hợp không tồn tại lẫn bị ẩn nghĩa là danh sách, đường link hay địa chỉ đoán mò không bao giờ để lộ những gì có ở đó.

Vì sao quy tắc chặn có thể ẩn tài nguyên khỏi chính chủ sở hữu?

Chặn được xét trước quyền sở hữu, nên người rà soát tuân thủ có thể gỡ tài nguyên mà không tước nó khỏi người tạo. Chủ sở hữu vẫn là chủ — nhưng bị ẩn khỏi nó không cho họ quyền gỡ quy tắc đang ẩn nó.

Vì sao chặn theo nhóm là cách an toàn nhất để loại nhà thầu?

Nhà thầu làm với Sales vẫn được tính phí vào Sales, nên quy tắc cho phép theo phòng ban sẽ cho họ vào. Quy tắc chặn trên nhóm của họ được xét trước và thắng quy tắc cho phép đó, công tắc toàn tổ chức và quyền sở hữu — và nó theo tư cách thành viên, nên ai vào nhóm cũng bị loại ở mọi nơi quy tắc xuất hiện.

Bên dưới

AssertResourceAccess

AssertResourceAccess kết hợp phạm vi hiển thị với quyền hạn; HTTP guard và bên gọi trực tiếp đều dùng nó, còn hai bộ phân giải bên dưới không biết đến nhau.

read      = visible
write     = visible AND (owner OR capability)
authorise = (owner AND visible) OR capability

Route khai báo truy cập nội dung bằng @RequireAccess(resource, "read" | "write"); guard từ chối đối tượng không tồn tại, thuộc tổ chức khác hoặc không truy cập được trước khi use case tải nội dung. Một lần ghi đã xác minh thỏa mãn các kiểm tra đọc trong cùng lần gọi. Quản trị chia sẻ dùng authorise riêng, có lặp lại kiểm tra khác tổ chức. Ràng buộc “đúng một đối tượng” của dòng quy tắc được thực thi trong mã domain.

Đọc danh sách và đọc trạng thái chia sẻ

Danh sách lấy ứng viên và quy tắc của chúng bằng hai truy vấn rồi phân trang trên tập id kết quả. Chỉ bộ phân giải danh sách mới đọc lựa chọn thư viện; test khẳng định đường truy cập không bao giờ đọc.

Trạng thái chia sẻ được đọc từ GET /visibility/resources?ids= (tối đa 200 id mỗi yêu cầu), chỉ trả những tài nguyên mà bên gọi được quản lý chia sẻ — số còn lại bị bỏ ra, không bị từ chối. Lần lưu khiến tài nguyên không ai tiếp cận được thất bại với resource_unreachable.

Liên quan

Chia sẻ và thư viện của bạn Chia sẻ tài nguyên và quản lý kệ của bạn.

Nhóm Lớp mà quy tắc hiển thị thường chỉ định.

Vai trò và quyền hạn Một người được làm gì khi đã thấy tài nguyên. Quản lý nhóm Cho quản trị viên: tạo nhóm và thành viên.