Hub documentation

Colecciones de grupos de enmascarado

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Colecciones de grupos de enmascarado

Esta función forma parte de los planes Team & Enterprise.

Las colecciones de grupos de control de acceso permiten a las organizaciones conceder (o denegar) el acceso a todos los modelos y conjuntos de datos de una colección a la vez, en lugar de hacerlo por repositorio. Los usuarios solo tendrán que pasar por una única solicitud de acceso.

Para habilitar Gating Group en una colección:

  • el propietario de la colección debe ser una organización
  • la organización debe estar suscrita a un plan Team o Enterprise
  • todos los modelos y conjuntos de datos de la colección deben pertenecer a la misma organización que la colección
  • cada modelo o conjunto de datos de la colección solo puede pertenecer a una Gating Group Collection (aunque aún pueden incluirse en colecciones no de control, es decir, regulares).

El control de acceso solo se aplica a modelos y conjuntos de datos; cualquier otro recurso que forme parte de la colección (como un Space o un Paper) no se verá afectado.

Gestionar el grupo de control de acceso como administrador de la organización

Para habilitar las solicitudes de acceso, vaya a la página de la colección y haga clic en Gating group en la esquina inferior derecha.

Hugging Face collection page with gating group collection feature disabled

Por defecto, el grupo de control de acceso está desactivado: haga clic en Configurar solicitudes de acceso para abrir la configuración

Hugging Face gating group collection settings with gating disabled

Por defecto, el acceso a los repositorios de la colección se concede automáticamente a los usuarios cuando lo solicitan. Esto se conoce como aprobación automática. En este modo, cualquier usuario puede acceder a tus repositorios una vez que haya aceptado compartir su información de contacto contigo.

Hugging Face gating group collection settings with automatic mode selected

Si deseas aprobar manualmente qué usuarios pueden acceder a los repositorios de tu colección, debes configurarlo en Manual Review. En este caso, notarás una nueva opción:

Frecuencia de las notificaciones, que permite configurar cuándo recibir notificaciones sobre nuevos usuarios que solicitan acceso. Puede configurarse para que se envíe una vez al día o en tiempo real. De forma predeterminada, los correos electrónicos se envían a los primeros 5 administradores de la organización. También puede configurar una dirección de correo electrónico diferente en el campo Correo electrónico de notificaciones.

Hugging Face gating group collection settings with manual review mode selected

Revisar las solicitudes de acceso

Una vez que las solicitudes de acceso están habilitadas, tienes el control total sobre quién puede acceder a los repositorios de tu colección de grupo de control, ya sea que el modo de aprobación sea manual o automático. Puedes revisar y gestionar las solicitudes desde la interfaz de usuario o a través de la API.

La aprobación de una solicitud para un repositorio en una colección de grupo de control de acceso aprobará automáticamente el acceso a todos los repositorios (modelos y conjuntos de datos) de esa colección.

Desde la interfaz de usuario

Puedes revisar quién tiene acceso a todos los repositorios de tu Gating Group Collection desde la página de configuración de cualquiera de los repositorios de la colección, haciendo clic en el botón Review access requests:

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

Esto abrirá un modal con 3 listas de usuarios:

  • pendiente: la lista de usuarios que esperan la aprobación para acceder a tu repositorio. Esta lista está vacía a menos que hayas seleccionado Revisión manual. Puedes Aceptar o Rechazar cada solicitud. Si la solicitud se rechaza, el usuario no puede acceder a tu repositorio y no puede solicitar acceso de nuevo.
  • accepted: la lista completa de usuarios con acceso a tu repositorio. Puedes Reject el acceso en cualquier momento para cualquier usuario, ya sea que el modo de aprobación sea manual o automático. También puedes Cancel la aprobación, lo que moverá al usuario a la lista pending.
  • rejected: la lista de usuarios que has rechazado manualmente. Esos usuarios no pueden acceder a tus repositorios. Si van a tu repositorio, verán un mensaje 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

A través de la API

Puedes gestionar las solicitudes de acceso de forma programática en una Gated Group Collection a través de la API de cualquiera de sus modelos o conjuntos de datos.

Visita nuestra documentación sobre modelos con acceso restringido o conjuntos de datos con acceso restringido para obtener más información.

Descargar informe de acceso

Puedes descargar los informes de acceso de la Gated Group Collection a través de la página de configuración de cualquiera de sus modelos o conjuntos de datos.

Visita nuestra documentación sobre modelos con acceso restringido o conjuntos de datos con acceso restringido para obtener más información.

Elija qué datos de perfil recopilar

Por defecto, Hugging Face comparte el nombre de usuario y la dirección de correo electrónico principal del solicitante con la organización. En la configuración del grupo de control de acceso, puedes controlar esto y cambiar qué información Hugging Face comparte contigo. Estas configuraciones se aplican a todos los repositorios de la colección y solo afectan a las nuevas solicitudes.

Visita nuestra documentación sobre modelos con acceso restringido o conjuntos de datos con acceso restringido para obtener más información.

Personalizar la información solicitada

Las organizaciones pueden personalizar los parámetros de control de acceso, así como la información del usuario que se recopila por repositorio con control de acceso. Consulte nuestra documentación de modelos con control de acceso o conjuntos de datos con control de acceso para obtener más detalles.

Además de la configuración de datos de perfil anterior, actualmente no hay forma de personalizar los parámetros de la puerta y la información solicitada de manera centralizada. Si desea recopilar los mismos datos sin importar el repositorio de la colección al que un usuario solicite acceso, debe agregar los mismos parámetros de puerta en los metadatos de todos los modelos y conjuntos de datos de la colección y mantenerlos sincronizados.

Ajustes avanzados

Las organizaciones Enterprise Plus pueden rechazar o bloquear automáticamente a visitantes de ubicaciones específicas en todos sus modelos y conjuntos de datos. Estas configuraciones se encuentran en la configuración de Publisher Analytics, en la pestaña Advanced Gating.

Aplicación

La configuración Enforcement controla lo que se deniega a los visitantes bloqueados:

  • Repositorios con acceso restringido: las solicitudes de acceso a los repositorios con acceso restringido de la organización se rechazan automáticamente.
  • Todos los repositorios: además de rechazar automáticamente las solicitudes de acceso, se deniegan las descargas en todos los repositorios de la organización, incluidos los públicos. Los visitantes bloqueados ven un aviso de “no disponible en su región” en la página del repositorio, y el visor de conjuntos de datos se desactiva para ellos.

La aplicación de las restricciones afecta a los visitantes de los países y regiones bloqueados, estén o no iniciados en su sesión. Los miembros de la organización no están exentos.

Ubicaciones bloqueadas

Dos listas definen las ubicaciones bloqueadas:

  • Países bloqueados: países, identificados por su código ISO 3166-1 alpha-2.
  • Regiones bloqueadas: territorios específicos para bloquear además de los países anteriores, para territorios que no son países distintos y por lo tanto no pueden seleccionarse en la lista anterior.

Acceder a repositorios con control de acceso en una colección de grupo de control de acceso como usuario

Una Gated Group Collection muestra un icono específico junto a su nombre:

Hugging Face collection page with gating group collection feature enabled

Para acceder a los modelos y conjuntos de datos de una Gated Group Collection, es necesario presentar una única solicitud de acceso en la página de cualquiera de esos repositorios. Una vez que tu solicitud sea aprobada, podrás acceder a todos los demás repositorios de la colección, incluidos los futuros.

Visita nuestra documentación de modelos con acceso restringido o conjuntos de datos con acceso restringido para obtener más información sobre cómo solicitar acceso a un repositorio.

Update on GitHub