Hub documentation
Bộ sưu tập nhóm Gating
Bộ sưu tập nhóm Gating
Tính năng này là một phần của các gói Team & Enterprise.
Gating Group Collections cho phép các tổ chức cấp (hoặc từ chối) quyền truy cập vào tất cả các model và dataset trong một collection cùng lúc, thay vì theo từng repo. Người dùng chỉ cần thực hiện một yêu cầu truy cập duy nhất.
Để bật Gating Group trong một bộ sưu tập:
- chủ sở hữu bộ sưu tập phải là một tổ chức
- tổ chức phải được đăng ký gói Team hoặc Enterprise
- tất cả các mô hình và bộ dữ liệu trong bộ sưu tập phải thuộc về cùng một tổ chức với bộ sưu tập
- mỗi model hoặc dataset trong collection có thể chỉ thuộc về một Gating Group Collection (nhưng vẫn có thể được bao gồm trong các collection không gating, tức là thường).
Gating chỉ áp dụng cho các model và dataset; mọi tài nguyên khác thuộc bộ sưu tập (chẳng hạn như một Space hoặc một Paper) sẽ không bị ảnh hưởng.
Quản lý nhóm kiểm soát truy cập với tư cách là quản trị viên tổ chức
Để bật yêu cầu truy cập, hãy chuyển đến trang bộ sưu tập và nhấp vào Gating group ở góc dưới bên phải.

Mặc định, nhóm kiểm soát truy cập bị vô hiệu hóa: nhấp vào Cấu hình yêu cầu truy cập để mở cài đặt

Mặc định, quyền truy cập vào các kho trong bộ sưu tập sẽ được cấp tự động cho người dùng khi họ yêu cầu. Chế độ này được gọi là duyệt tự động. Ở chế độ này, bất kỳ người dùng nào cũng có thể truy cập các kho của bạn sau khi họ đồng ý chia sẻ thông tin liên hệ với bạn.

Nếu bạn muốn tự động phê duyệt người dùng nào có thể truy cập các kho trong bộ sưu tập của mình, bạn phải đặt nó thành Manual Review. Khi đó, bạn sẽ thấy một tùy chọn mới:
Tần suất thông báo, cho phép bạn cấu hình thời điểm nhận thông báo về các người dùng mới yêu cầu quyền truy cập. Bạn có thể đặt là một lần mỗi ngày hoặc theo thời gian thực. Mặc định, email được gửi đến 5 quản trị viên đầu tiên của tổ chức. Bạn cũng có thể đặt một địa chỉ email khác trong trường Email thông báo.

Xem xét các yêu cầu truy cập
Khi các yêu cầu truy cập được bật, bạn có toàn quyền kiểm soát ai có thể truy cập các kho trong bộ sưu tập nhóm kiểm soát truy cập của mình, bất kể chế độ phê duyệt là thủ công hay tự động. Bạn có thể xem xét và quản lý các yêu cầu từ giao diện người dùng hoặc qua API.
Việc phê duyệt yêu cầu cho một kho trong nhóm tập hợp kiểm soát sẽ tự động phê duyệt quyền truy cập vào tất cả các kho (mô hình và bộ dữ liệu) trong tập hợp đó.
Từ giao diện người dùng
Bạn có thể xem ai có quyền truy cập vào tất cả các kho trong Bộ sưu tập Nhóm Gating của mình từ trang cài đặt của bất kỳ kho nào trong bộ sưu tập, bằng cách nhấp vào nút Review access requests:

Điều này sẽ mở một hộp thoại với 3 danh sách người dùng:
- pending: danh sách người dùng đang chờ được phê duyệt để truy cập kho lưu trữ của bạn. Danh sách này trống trừ khi bạn đã chọn Manual Review. Bạn có thể Accept hoặc Reject từng yêu cầu. Nếu yêu cầu bị từ chối, người dùng sẽ không thể truy cập kho lưu trữ của bạn và cũng không thể yêu cầu truy cập lại.
- accepted: danh sách đầy đủ các người dùng có quyền truy cập vào kho lưu trữ của bạn. Bạn có thể Reject quyền truy cập vào bất kỳ lúc nào cho bất kỳ người dùng nào, bất kể chế độ phê duyệt là thủ công hay tự động. Bạn cũng có thể Cancel việc phê duyệt, điều này sẽ chuyển người dùng sang danh sách pending.
- rejected: danh sách người dùng mà bạn đã từ chối thủ công. Những người dùng này không thể truy cập các kho lưu trữ của bạn. Nếu họ truy cập kho lưu trữ của bạn, họ sẽ thấy thông báo Your request to access this repo has been rejected by the repo’s authors.

Thông qua API
Bạn có thể quản lý các yêu cầu truy cập trong một Gated Group Collection một cách có chương trình thông qua API của bất kỳ model hoặc dataset nào trong đó.
Xem tài liệu về mô hình có kiểm soát truy cập hoặc bộ dữ liệu có kiểm soát truy cập của chúng tôi để biết thêm chi tiết.
Tải báo cáo truy cập
Bạn có thể tải xuống các báo cáo truy cập cho Gated Group Collection thông qua trang cài đặt của bất kỳ model hoặc dataset nào thuộc bộ sưu tập đó.
Xem tài liệu về mô hình có kiểm soát truy cập hoặc bộ dữ liệu có kiểm soát truy cập của chúng tôi để biết thêm chi tiết.
Chọn dữ liệu hồ sơ cần thu thập
Mặc định, Hugging Face chia sẻ tên người dùng và địa chỉ email chính của người yêu cầu với tổ chức. Trong cài đặt nhóm gating, bạn có thể kiểm soát điều đó và thay đổi thông tin mà Hugging Face chia sẻ với bạn. Những cài đặt này áp dụng cho tất cả các repo trong bộ sưu tập và chỉ ảnh hưởng đến các yêu cầu mới.
Xem tài liệu về mô hình có kiểm soát truy cập hoặc bộ dữ liệu có kiểm soát truy cập của chúng tôi để biết thêm chi tiết.
Tùy chỉnh thông tin được yêu cầu
Các tổ chức có thể tùy chỉnh các tham số kiểm soát truy cập cũng như thông tin người dùng được thu thập cho từng kho có kiểm soát. Vui lòng truy cập tài liệu về mô hình có kiểm soát hoặc dataset có kiểm soát để biết thêm chi tiết.
Ngoài các cài đặt dữ liệu hồ sơ ở trên, hiện tại chưa có cách nào để tùy chỉnh các tham số cổng và thông tin được yêu cầu một cách tập trung. Nếu bạn muốn thu thập cùng một dữ liệu bất kể người dùng yêu cầu truy cập vào kho lưu trữ của bộ sưu tập nào, bạn cần thêm cùng các tham số cổng trong metadata của tất cả các model và dataset trong bộ sưu tập, và giữ cho chúng đồng bộ.
Cài đặt nâng cao
Tổ chức Enterprise Plus có thể tự động từ chối hoặc chặn khách truy cập từ các vị trí cụ thể trên tất cả các mô hình và bộ dữ liệu của họ. Các cài đặt này nằm trong cài đặt Publisher Analytics, dưới tab Advanced Gating.
Thực thi
Cài đặt Enforcement kiểm soát những gì mà khách truy cập bị chặn sẽ bị từ chối:
- Kho có cổng: các yêu cầu truy cập vào các kho có cổng của tổ chức sẽ bị tự động từ chối.
- Tất cả các kho lưu trữ: ngoài việc tự động từ chối các yêu cầu truy cập, việc tải xuống cũng bị cấm trên mọi kho lưu trữ của tổ chức, bao gồm cả các kho công khai. Khách truy cập bị chặn sẽ thấy thông báo “không khả dụng trong khu vực của bạn” trên trang kho lưu trữ, và trình xem bộ dữ liệu sẽ bị vô hiệu hóa đối với họ.
Việc thực thi áp dụng cho khách truy cập từ các quốc gia và khu vực bị chặn, bất kể họ có đăng nhập hay không. Thành viên của tổ chức không được miễn trừ.
Các vị trí bị chặn
Hai danh sách xác định các vị trí bị chặn:
- Các quốc gia bị chặn: các quốc gia, được xác định bằng mã ISO 3166-1 alpha-2 của chúng.
- Khu vực bị chặn: các lãnh thổ cụ thể cần chặn ngoài các quốc gia ở trên, dành cho những lãnh thổ không phải là quốc gia độc lập và do đó không thể được chọn trong danh sách ở trên.
Truy cập các kho có kiểm soát trong một Bộ sưu tập Nhóm Kiểm soát với tư cách là người dùng
Một Gated Group Collection hiển thị một biểu tượng cụ thể bên cạnh tên của nó:

Để truy cập các model và dataset trong một Gated Group Collection, bạn chỉ cần gửi một yêu cầu truy cập trên trang của bất kỳ repository nào trong số đó. Sau khi yêu cầu của bạn được phê duyệt, bạn sẽ có thể truy cập tất cả các repository khác trong bộ sưu tập, bao gồm cả những repository được thêm vào sau này.
Xem tài liệu về mô hình có kiểm soát truy cập hoặc bộ dữ liệu có kiểm soát truy cập của chúng tôi để tìm hiểu thêm về cách yêu cầu quyền truy cập vào một kho lưu trữ.
Update on GitHub