Hub documentation

Bộ sưu tập nhóm Gating

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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.

Hugging Face collection page with gating group collection feature disabled

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

Hugging Face gating group collection settings with gating disabled

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.

Hugging Face gating group collection settings with automatic mode selected

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.

Hugging Face gating group collection settings with manual review mode selected

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:

Hugging Face repo access settings when repo is in a gating group collection

Đ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.
Manage access requests modal for a repo in a gating group collection

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ó:

Hugging Face collection page with gating group collection feature enabled

Để 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