Collections de groupes de gating

Cette fonctionnalité fait partie des plans Team & Enterprise.

Les collections de groupes de contrôle d’accès permettent aux organisations d’accorder (ou de refuser) l’accès à tous les modèles et jeux de données d’une collection en une seule fois, plutôt que par dépôt. Les utilisateurs n’auront à effectuer que une seule demande d’accès.

Pour activer Gating Group dans une collection :

• le propriétaire de la collection doit être une organisation
• l'organisation doit être abonnée à un plan Team ou Enterprise
• tous les modèles et jeux de données de la collection doivent appartenir à la même organisation que la collection
• chaque modèle ou jeu de données de la collection ne peut appartenir qu'à une seule Gating Group Collection (mais il peut toujours être inclus dans des collections non-gating, c'est-à-dire des collections classiques).

Le contrôle d'accès ne s'applique qu'aux modèles et aux jeux de données ; toute autre ressource faisant partie de la collection (telle qu'un Space ou un Paper) ne sera pas affectée.

Gérer le groupe de contrôle d'accès en tant qu'administrateur d'organisation

Pour activer les demandes d’accès, accédez à la page de la collection et cliquez sur Gating group dans le coin inférieur droit.

Par défaut, le groupe de contrôle d'accès est désactivé : cliquez sur Configurer les demandes d'accès pour ouvrir les paramètres

Par défaut, l’accès aux dépôts de la collection est automatiquement accordé aux utilisateurs lorsqu’ils en font la demande. On appelle cela l’approbation automatique. Dans ce mode, tout utilisateur peut accéder à vos dépôts dès qu’il a accepté de partager ses coordonnées avec vous.

Si vous souhaitez approuver manuellement les utilisateurs pouvant accéder aux dépôts de votre collection, vous devez le définir sur Manual Review. Dans ce cas, vous remarquerez une nouvelle option :

Fréquence des notifications, qui permet de configurer le moment où vous recevez des notifications concernant de nouveaux utilisateurs demandant l'accès. Elle peut être définie sur une fois par jour ou en temps réel. Par défaut, les e-mails sont envoyés aux 5 premiers administrateurs de l'organisation. Vous pouvez également définir une adresse e-mail différente dans le champ E-mail de notification.

Examiner les demandes d'accès

Une fois les demandes d’accès activées, vous avez un contrôle total sur qui peut accéder aux dépôts de votre collection de groupe de contrôle, que le mode d’approbation soit manuel ou automatique. Vous pouvez examiner et gérer les demandes depuis l’interface utilisateur ou via l’API.

L’approbation d’une demande pour un dépôt dans une collection de groupe de contrôle d’accès approuve automatiquement l’accès à tous les dépôts (modèles et jeux de données) de cette collection.

Depuis l'interface utilisateur

Vous pouvez consulter qui a accès à tous les dépôts de votre Gating Group Collection depuis la page de paramètres de l’un des dépôts de la collection, en cliquant sur le bouton Review access requests :

Cela ouvrira une fenêtre modale avec 3 listes d'utilisateurs :

• pending : la liste des utilisateurs en attente d’approbation pour accéder à votre dépôt. Cette liste est vide sauf si vous avez sélectionné Manual Review. Vous pouvez Accept ou Reject chaque demande. Si la demande est rejetée, l’utilisateur ne peut pas accéder à votre dépôt et ne peut pas soumettre à nouveau une demande d’accès.
• accepted : la liste complète des utilisateurs ayant accès à votre dépôt. Vous pouvez choisir de Reject l’accès à tout moment pour n’importe quel utilisateur, que le mode d’approbation soit manuel ou automatique. Vous pouvez également Cancel l’approbation, ce qui déplacera l’utilisateur vers la liste pending.
• rejected : la liste des utilisateurs que vous avez manuellement rejetés. Ces utilisateurs ne peuvent pas accéder à vos dépôts. S’ils accèdent à votre dépôt, ils verront le message Your request to access this repo has been rejected by the repo’s authors.

Via l'API

Vous pouvez gérer les demandes d'accès d'une collection de groupes à accès restreint de manière programmatique via l'API de l'un de ses modèles ou jeux de données.

Consultez notre documentation sur les modèles à accès restreint ou les jeux de données à accès restreint pour en savoir plus.

Télécharger le rapport d'accès

Vous pouvez télécharger les rapports d'accès pour la Gated Group Collection via la page de paramètres de l'un de ses modèles ou jeux de données.

Consultez notre documentation sur les modèles à accès restreint ou les jeux de données à accès restreint pour en savoir plus.

Choisir les données de profil à collecter

Par défaut, Hugging Face partage le nom d’utilisateur et l’adresse e-mail principale du demandeur avec l’organisation. Dans les paramètres du groupe de contrôle d’accès, vous pouvez gérer cela et modifier les informations que Hugging Face partage avec vous. Ces paramètres s’appliquent à tous les dépôts de la collection et n’affectent que les nouvelles demandes.

Consultez notre documentation sur les modèles à accès restreint ou les jeux de données à accès restreint pour en savoir plus.

Personnaliser les informations demandées

Les organisations peuvent personnaliser les paramètres de contrôle d'accès ainsi que les informations utilisateur collectées pour chaque dépôt sous contrôle d'accès. Veuillez consulter notre documentation sur les modèles sous contrôle d'accès ou les jeux de données sous contrôle d'accès pour plus de détails.

En plus des paramètres de données de profil ci-dessus, il n’existe actuellement aucun moyen de personnaliser de manière centralisée les paramètres de la porte et les informations demandées. Si vous souhaitez collecter les mêmes données, quel que soit le dépôt de la collection auquel un utilisateur demande l’accès, vous devez ajouter les mêmes paramètres de porte dans les métadonnées de tous les modèles et jeux de données de la collection, et maintenir leur synchronisation.

Paramètres avancés

Les organisations Enterprise Plus peuvent automatiquement refuser ou bloquer les visiteurs provenant de localisations spécifiques sur l’ensemble de leurs modèles et jeux de données. Ces paramètres se trouvent dans les paramètres Publisher Analytics, sous l’onglet Advanced Gating.

Application

Le paramètre Enforcement contrôle ce qui est refusé aux visiteurs bloqués :

• Dépôts à accès restreint : les demandes d’accès aux dépôts à accès restreint de l’organisation sont automatiquement rejetées.
• Tous les dépôts : en plus du rejet automatique des demandes d’accès, les téléchargements sont refusés sur tous les dépôts de l’organisation, y compris les dépôts publics. Les visiteurs bloqués voient un message « non disponible dans votre région » sur la page du dépôt, et le visualiseur de jeux de données est désactivé pour eux.

L'application de cette mesure concerne les visiteurs des pays et régions bloqués, qu'ils soient connectés ou non. Les membres de l'organisation ne sont pas exemptés.

Emplacements bloqués

Deux listes définissent les emplacements bloqués :

• Pays bloqués : pays, identifiés par leur code ISO 3166-1 alpha-2.
• Régions bloquées : territoires spécifiques à bloquer en plus des pays ci-dessus, pour les territoires qui ne sont pas des pays distincts et ne peuvent donc pas être sélectionnés dans la liste ci-dessus.

Accéder aux dépôts restreints d'une collection de groupe de restriction en tant qu'utilisateur

Une collection de groupes à porte affiche une icône spécifique à côté de son nom :

Pour accéder aux modèles et aux jeux de données d'une collection de groupes à accès restreint, il suffit d'envoyer une demande d'accès sur la page de l'un de ces dépôts. Une fois votre demande approuvée, vous pourrez accéder à tous les autres dépôts de la collection, y compris ceux qui seront ajoutés à l'avenir.

Consultez notre documentation sur les modèles sous contrôle d'accès ou les jeux de données sous contrôle d'accès pour en savoir plus sur la demande d'accès à un dépôt.

Update on GitHub