Коллекции групп гейтинга

Эта функция входит в планы Team & Enterprise.

Gating Group Collections позволяют организациям предоставлять (или отказывать в) доступе ко всем моделям и наборам данных в коллекции сразу, а не по отдельным репозиториям. Пользователям потребуется пройти лишь одну процедуру запроса доступа.

Чтобы включить Gating Group в коллекции:

• владелец коллекции должен быть организацией
• организация должна быть подписана на план Team или Enterprise
• все модели и наборы данных в коллекции должны принадлежать той же организации, что и сама коллекция
• каждая модель или набор данных в коллекции может принадлежать только одной Gating Group Collection (но при этом они могут входить в не-gating, то есть обычные коллекции).

Функция gating применяется только к моделям и наборам данных; другие ресурсы, входящие в коллекцию (например, Space или Paper), не затрагиваются.

Управление группой шлюзов в качестве администратора организации

Чтобы включить запросы на доступ, перейдите на страницу коллекции и нажмите Gating group в правом нижнем углу.

По умолчанию группа управления доступом отключена: нажмите Настроить запросы на доступ, чтобы открыть настройки

По умолчанию доступ к репозиториям в коллекции автоматически предоставляется пользователям по их запросу. Этот режим называется автоматическим одобрением. В этом режиме любой пользователь получает доступ к вашим репозиториям, как только согласится поделиться с вами своими контактами.

Если вы хотите вручную одобрять пользователей, которые могут получать доступ к репозиториям в вашей коллекции, установите значение Manual Review. В этом случае вы увидите новый вариант:

Частота уведомлений, с помощью которой можно настроить, когда получать уведомления о новых пользователях, запрашивающих доступ. Можно установить значение «один раз в день» или «в реальном времени». По умолчанию электронные письма отправляются первым 5 администраторам организации. Вы также можете указать другой адрес электронной почты в поле Адрес для уведомлений.

Обзор запросов на доступ

После включения запросов на доступ вы получаете полный контроль над тем, кто может получать доступ к репозиториям в вашей коллекции групп с ограничением доступа, независимо от того, используется ли ручной или автоматический режим одобрения. Вы можете просматривать и управлять запросами как через интерфейс, так и через API.

Одобрение запроса на репозиторий в коллекции группы контроля доступа автоматически одобряет доступ ко всем репозиториям (моделям и наборам данных) в этой коллекции.

Из интерфейса

Вы можете просмотреть, у кого есть доступ ко всем репозиториям в вашей Gating Group Collection, на странице настроек любого из репозиториев в коллекции, нажав кнопку Review access requests:

Это откроет модальное окно со списками из трёх пользователей:

• pending: список пользователей, ожидающих одобрения доступа к вашему репозиторию. Этот список пуст, если вы не выбрали Manual Review. Вы можете Accept или Reject каждый запрос. Если запрос отклонён, пользователь не сможет получить доступ к вашему репозиторию и не сможет отправить запрос на доступ повторно.
• accepted: полный список пользователей, имеющих доступ к вашему репозиторию. Вы можете в любой момент Reject доступ для любого пользователя, независимо от того, установлен ли ручной или автоматический режим одобрения. Также можно Cancel одобрение, что переместит пользователя в список pending.
• rejected: список пользователей, которых вы отклонили вручную. Эти пользователи не могут получить доступ к вашим репозиториям. Если они перейдут в ваш репозиторий, они увидят сообщение Ваш запрос на доступ к этому репозиторию отклонен авторами репозитория.

Через API

Вы можете программно управлять запросами на доступ в Gated Group Collection через API любой из его моделей или наборов данных.

Ознакомьтесь с нашей документацией по моделям с ограниченным доступом или наборам данных с ограниченным доступом, чтобы узнать больше.

Скачать отчет об доступе

Вы можете скачать отчеты о доступе для Gated Group Collection на странице настроек любой из его моделей или наборов данных.

Ознакомьтесь с нашей документацией по моделям с ограниченным доступом или наборам данных с ограниченным доступом, чтобы узнать больше.

Выберите данные профиля для сбора

По умолчанию Hugging Face передаёт организации имя пользователя и основной адрес электронной почты отправителя запроса. В настройках группы доступа вы можете управлять этим процессом и изменять информацию, которую Hugging Face передаёт вам. Эти настройки применяются ко всем репозиториям в коллекции и влияют только на новые запросы.

Ознакомьтесь с нашей документацией по моделям с ограниченным доступом или наборам данных с ограниченным доступом, чтобы узнать больше.

Настройка запрашиваемой информации

Организации могут настраивать параметры гейтинга, а также пользовательские данные, собираемые для каждого репозитория с гейтингом. Подробности см. в документации о моделях с гейтингом или наборах данных с гейтингом.

Помимо описанных выше настроек данных профиля, на данный момент нет способа централизованно настроить параметры гейта и запрашиваемую информацию. Если вы хотите собирать одни и те же данные независимо от того, репозиторий какой коллекции запрашивает пользователь, вам необходимо добавить одинаковые параметры гейта в метаданные всех моделей и наборов данных коллекции и поддерживать их синхронизацию.

Дополнительные настройки

Организации Enterprise Plus могут автоматически отклонять или блокировать посетителей из определённых регионов для всех своих моделей и наборов данных. Эти настройки находятся в разделе Publisher Analytics, на вкладке Advanced Gating.

Принуждение

Настройка Enforcement определяет, что будет запрещено для заблокированных посетителей:

• Репозитории с ограниченным доступом: запросы на доступ к репозиториям с ограниченным доступом организации отклоняются автоматически.
• Все репозитории: помимо автоматического отклонения запросов на доступ, загрузка запрещена во всех репозиториях организации, включая публичные. Заблокированные посетители видят на странице репозитория уведомление «недоступно в вашем регионе», а просмотрщик датасетов для них отключён.

Ограничения действуют для посетителей из заблокированных стран и регионов независимо от того, вошли ли они в систему. Члены организации не имеют исключений.

Заблокированные места

Два списка определяют заблокированные расположения:

• Заблокированные страны: страны, идентифицированные по их коду ISO 3166-1 alpha-2.
• Заблокированные регионы: конкретные территории, которые необходимо заблокировать в дополнение к указанным выше странам, для территорий, не являющихся отдельными странами и поэтому не доступных для выбора в списке выше.

Доступ к репозиториям с ограниченным доступом в коллекции группы с ограничением как пользователь

Сборка с ограниченным доступом отображает рядом со своим названием определённую иконку:

Для получения доступа к моделям и наборам данных в Gated Group Collection достаточно подать одну заявку на странице любого из этих репозиториев. После одобрения заявки вы сможете получить доступ ко всем остальным репозиториям в коллекции, включая будущие.

Ознакомьтесь с нашей документацией по моделям с ограниченным доступом или наборам данных с ограниченным доступом, чтобы узнать больше о том, как запросить доступ к репозиторию.

Update on GitHub