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

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

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

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

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

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

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

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

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-collection-disabled.webp"
        alt="Hugging Face collection page with gating group collection feature disabled"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-collection-disabled.webp"
        alt="Hugging Face collection page with gating group collection feature disabled"
    />

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

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-disabled.webp"
        alt="Hugging Face gating group collection settings with gating disabled"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-disabled.webp"
        alt="Hugging Face gating group collection settings with gating disabled"
    />

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

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-enabling.webp"
        alt="Hugging Face gating group collection settings with automatic mode selected"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-enabling.webp"
        alt="Hugging Face gating group collection settings with automatic mode selected"  
    />

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

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

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-manual.webp"
        alt="Hugging Face gating group collection settings with manual review mode selected"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-manual.webp"
        alt="Hugging Face gating group collection settings with manual review mode selected"
    />

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

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

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

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

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

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-repo-settings.webp"
        alt="Hugging Face repo access settings when repo is in a gating group collection"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-repo-settings.webp"
        alt="Hugging Face repo access settings when repo is in a gating group collection"
    />

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

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

    <img 
        class="block dark:hidden"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-enabled-pending-users.png"
        alt="Manage access requests modal for a repo in a gating group collection"
    />
    <img
        class="hidden dark:block"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-enabled-pending-users-dark.png"
        alt="Manage access requests modal for a repo in a gating group collection"
    />

#### Через API

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

Ознакомьтесь с нашей документацией по [моделям с ограниченным доступом](https://huggingface.co/docs/hub/models-gated#via-the-api) или [наборам данных с ограниченным доступом](https://huggingface.co/docs/hub/datasets-gated#via-the-api), чтобы узнать больше.

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

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

Ознакомьтесь с нашей документацией по [моделям с ограниченным доступом](https://huggingface.co/docs/hub/models-gated#download-access-report) или [наборам данных с ограниченным доступом](https://huggingface.co/docs/hub/datasets-gated#download-access-report), чтобы узнать больше.

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

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

Ознакомьтесь с нашей документацией по [моделям с ограниченным доступом](https://huggingface.co/docs/hub/models-gated#choose-which-profile-data-hugging-face-shares-with-you) или [наборам данных с ограниченным доступом](https://huggingface.co/docs/hub/datasets-gated#choose-which-profile-data-hugging-face-shares-with-you), чтобы узнать больше.

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

Организации могут настраивать параметры гейтинга, а также пользовательские данные, собираемые для каждого репозитория с гейтингом. Подробности см. в документации о [моделях с гейтингом](https://huggingface.co/docs/hub/models-gated#customize-requested-information) или [наборах данных с гейтингом](https://huggingface.co/docs/hub/datasets-gated#customize-requested-information).

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

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

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

### Принуждение

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

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

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

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

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

- **Заблокированные страны**: страны, идентифицированные по их коду [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
- **Заблокированные регионы**: конкретные территории, которые необходимо заблокировать в дополнение к указанным выше странам, для территорий, не являющихся отдельными странами и поэтому не доступных для выбора в списке выше.

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

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

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-collection-enabled.webp"
        alt="Hugging Face collection page with gating group collection feature enabled"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-collection-enabled.webp"
        alt="Hugging Face collection page with gating group collection feature enabled"
    />

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

Ознакомьтесь с нашей документацией по [моделям с ограниченным доступом](https://huggingface.co/docs/hub/models-gated#access-gated-models-as-a-user) или [наборам данных с ограниченным доступом](https://huggingface.co/docs/hub/datasets-gated#access-gated-datasets-as-a-user), чтобы узнать больше о том, как запросить доступ к репозиторию.