Hub documentation

Coletivos de Grupos de Gating

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Coletivos de Grupos de Gating

Este recurso faz parte dos planos Team & Enterprise.

As Coleções de Grupos de Controle de Acesso permitem que as organizações concedam (ou neguem) acesso a todos os modelos e conjuntos de dados de uma coleção de uma só vez, em vez de por repositório. Os usuários precisarão passar por um único pedido de acesso.

Para habilitar o Gating Group em uma coleção:

  • o proprietário da coleção deve ser uma organização
  • a organização deve estar inscrita em um plano Team ou Enterprise
  • todos os modelos e conjuntos de dados na coleção devem ser pertencentes à mesma organização da coleção
  • cada modelo ou conjunto de dados na coleção pode pertencer a apenas uma Gating Group Collection (mas ainda pode ser incluído em coleções não-gating, ou seja, regulares).

O gating se aplica apenas a modelos e conjuntos de dados; qualquer outro recurso que faça parte da coleção (como um Space ou um Paper) não será afetado.

Gerenciar grupo de controle de acesso como administrador da organização

Para habilitar solicitações de acesso, acesse a página da coleção e clique em Gating group no canto inferior direito.

Hugging Face collection page with gating group collection feature disabled

Por padrão, o grupo de controle de acesso está desativado: clique em Configurar solicitações de acesso para abrir as configurações

Hugging Face gating group collection settings with gating disabled

Por padrão, o acesso aos repositórios na coleção é concedido automaticamente aos usuários quando eles solicitam. Isso é chamado de aprovação automática. Nesse modo, qualquer usuário pode acessar seus repositórios assim que concordar em compartilhar suas informações de contato com você.

Hugging Face gating group collection settings with automatic mode selected

Se você deseja aprovar manualmente quais usuários podem acessar repositórios em sua coleção, você deve configurá-lo como Manual Review. Quando esse é o caso, você notará uma nova opção:

Frequência das notificações, que permite configurar quando você será notificado sobre novos usuários solicitando acesso. Pode ser definido como uma vez por dia ou em tempo real. Por padrão, os e-mails são enviados para os 5 primeiros administradores da organização. Você também pode definir um endereço de e-mail diferente no campo E-mail de notificações.

Hugging Face gating group collection settings with manual review mode selected

Revisar solicitações de acesso

Quando as solicitações de acesso são habilitadas, você tem controle total sobre quem pode acessar os repositórios na sua coleção de grupo de gating, independentemente de o modo de aprovação ser manual ou automático. Você pode revisar e gerenciar as solicitações pela interface ou pela API.

A aprovação de uma solicitação para um repositório em uma coleção de grupo de controle de acesso aprova automaticamente o acesso a todos os repositórios (modelos e conjuntos de dados) nessa coleção.

A partir da interface

Você pode revisar quem tem acesso a todos os repositórios em sua Coleção de Grupo de Controle de Acesso a partir da página de configurações de qualquer um dos repositórios da coleção, clicando no botão Revisar solicitações de acesso:

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

Isso abrirá um modal com 3 listas de usuários:

  • pendente: a lista de usuários aguardando aprovação para acessar seu repositório. Essa lista fica vazia, a menos que você tenha selecionado Manual Review. Você pode Accept ou Reject cada solicitação. Se a solicitação for rejeitada, o usuário não poderá acessar seu repositório e não poderá solicitar acesso novamente.
  • aceitos: a lista completa de usuários com acesso ao seu repositório. Você pode escolher Rejeitar o acesso a qualquer momento para qualquer usuário, independentemente de o modo de aprovação ser manual ou automático. Você também pode Cancelar a aprovação, o que moverá o usuário para a lista pendente.
  • rejeitados: a lista de usuários que você rejeitou manualmente. Esses usuários não podem acessar seus repositórios. Se eles forem ao seu repositório, verão a mensagem Sua solicitação de acesso a este repositório foi rejeitada pelos autores do repositório.
Manage access requests modal for a repo in a gating group collection

Via a API

Você pode gerenciar programaticamente solicitações de acesso em uma Coleção de Grupo com Acesso Restrito por meio da API de qualquer um de seus modelos ou conjuntos de dados.

Acesse nossa documentação sobre modelos com acesso restrito ou conjuntos de dados com acesso restrito para saber mais sobre o assunto.

Baixar relatório de acesso

Você pode baixar relatórios de acesso para a Gated Group Collection por meio da página de configurações de qualquer um de seus modelos ou conjuntos de dados.

Acesse nossa documentação sobre modelos com acesso restrito ou conjuntos de dados com acesso restrito para saber mais sobre o assunto.

Escolha quais dados de perfil coletar

Por padrão, o Hugging Face compartilha o nome de usuário e o endereço de e-mail principal do solicitante com a organização. Nas configurações do grupo de controle de acesso, você pode controlar isso e alterar as informações que o Hugging Face compartilha com você. Essas configurações se aplicam a todos os repositórios da coleção e afetam apenas novas solicitações.

Acesse nossa documentação sobre modelos com acesso restrito ou conjuntos de dados com acesso restrito para saber mais sobre o assunto.

Personalize as informações solicitadas

As organizações podem personalizar os parâmetros de controle de acesso, bem como as informações do usuário que são coletadas por repositório com controle de acesso. Por favor, visite nossa documentação de modelos com controle de acesso ou conjuntos de dados com controle de acesso para mais detalhes.

Além das configurações de dados de perfil acima, atualmente não há uma maneira de personalizar os parâmetros do gate e as informações solicitadas de forma centralizada. Se você deseja coletar os mesmos dados, independentemente do repositório de qual coleção o usuário solicita acesso, é necessário adicionar os mesmos parâmetros do gate nos metadados de todos os modelos e conjuntos de dados da coleção e mantê-los sincronizados.

Configurações avançadas

Organizações Enterprise Plus podem rejeitar ou bloquear automaticamente visitantes de localizações específicas em todos os seus modelos e conjuntos de dados. Essas configurações ficam nas configurações de Publisher Analytics, na aba Advanced Gating.

Aplicação

A configuração Enforcement controla o que os visitantes bloqueados têm negado:

  • Repositórios com controle de acesso: solicitações de acesso aos repositórios com controle de acesso da organização são rejeitadas automaticamente.
  • Todos os repositórios: além de rejeitar automaticamente as solicitações de acesso, os downloads são negados em todos os repositórios da organização, incluindo os públicos. Visitantes bloqueados veem um aviso de “não disponível na sua região” na página do repositório, e o visualizador de datasets é desativado para eles.

A aplicação se estende a visitantes dos países e regiões bloqueados, independentemente de estarem ou não conectados. Os membros da organização não estão isentos.

Localizações bloqueadas

Duas listas definem as localizações bloqueadas:

  • Países bloqueados: países, identificados pelo seu código ISO 3166-1 alpha-2.
  • Regiões bloqueadas: territórios específicos para bloquear, além dos países acima, para territórios que não são países distintos e, portanto, não podem ser selecionados na lista acima.

Acessar repositórios restritos em uma Coleção de Grupo de Restrição como usuário

Uma Gated Group Collection exibe um ícone específico ao lado do seu nome:

Hugging Face collection page with gating group collection feature enabled

Para ter acesso aos modelos e conjuntos de dados em uma Coleção de Grupo com Acesso Restrito, é necessário enviar um único pedido de acesso na página de qualquer um desses repositórios. Assim que seu pedido for aprovado, você poderá acessar todos os outros repositórios da coleção, incluindo os futuros.

Acesse nossa documentação de modelos com acesso restrito ou conjuntos de dados com acesso restrito para saber mais sobre como solicitar acesso a um repositório.

Update on GitHub