Hub documentation
Segurança da Rede
Segurança da Rede
Este recurso faz parte do plano Enterprise Plus.
Defina os intervalos de IP da sua organização
Você pode listar os endereços IP do tráfego de saída da sua organização para impor acesso autenticado ao Hugging Face a partir da sua rede corporativa.
Os intervalos de endereços IP de saída são definidos no formato CIDR. Por exemplo, 52.219.168.0/24 ou 2600:1f69:7400::/40.
Você pode adicionar vários intervalos de uma vez, inserindo-os separados por espaços ou quebras de linha. Cada intervalo é então listado individualmente, e você pode remover qualquer intervalo da lista.
Quando os administradores da organização preenchem os “Organization IP Ranges” nas configurações de Network Security, uma verificação manual — realizada em conjunto pelos Solution Engineers da Hugging Face e pelos administradores da organização — é necessária para que a configuração “Require login for users in your IP ranges” fique disponível.
Cada intervalo de IP na lista exibe um selo de status para que você possa ver quais intervalos estão atualmente aplicados ou pendentes para validação.
Após a verificação manual dos “Organization IP Ranges” e a ativação, pelos administradores da organização, tanto de “Restrict organization access to your IP ranges only” quanto de “Require login for users in your IP ranges”, o seguinte fluxo se aplica:
- Quando um usuário acessa a plataforma, seu endereço IP é verificado.
- Se o IP estiver dentro dos intervalos definidos pela organização, o usuário deve autenticar (via SSO da organização, se habilitado).
- Uma vez autenticado, a Política de Acesso ao Conteúdo determina quais recursos o usuário pode acessar.
Limites de taxa mais altos do Hub
A maioria das ações no Hub possui limites; por exemplo, os usuários são limitados a criar um determinado número de repositórios por dia. O Enterprise Plus concede automaticamente aos seus usuários limites de taxa elevados para todas as ações.
Além disso, a ativação da opção “Higher Hub Rate Limits” permite que sua organização se beneficie dos limites de taxa HTTP mais altos na API do Hub, liberando o download de grandes volumes de modelos ou conjuntos de dados.
Para mais informações sobre limites de taxa, consulte a documentação Limites de taxa do Hub.
Restringir o acesso à organização apenas aos seus intervalos de IP
Esta opção restringe o acesso aos recursos da sua organização apenas para aqueles que vêm dos intervalos de IP definidos por você. Ninguém pode acessar os recursos da sua organização fora dos seus intervalos de IP. As regras também se aplicam a tokens de acesso. Quando ativada, esta opção desbloqueia configurações de segurança aninhadas adicionais abaixo.
Para fluxos de trabalho automatizados que são executados fora da rede corporativa, você pode isentar um token de conta de serviço individual dessas restrições e da Política de Acesso ao Conteúdo.
Exigir login para usuários em seus intervalos de IP
Quando esta opção está ativada, qualquer pessoa que acesse o Hugging Face a partir da sua rede corporativa deve estar conectada e pertencer à sua organização (exige uma verificação manual quando os intervalos de IP mudarem). Se ativada, você pode definir opcionalmente uma política de acesso ao conteúdo.
Todas as páginas públicas exibirão a seguinte mensagem se o acesso não estiver autenticado:
Política de Acesso ao Conteúdo
Defina uma Política de Acesso a Conteúdo de granularidade fina bloqueando conteúdos específicos do Hugging Face Hub.
Por exemplo, você pode impedir que os membros da sua organização acessem Spaces. Quando os usuários da sua organização navegarem para conteúdo bloqueado, a seguinte página será exibida:
Para definir conteúdo bloqueado, adicione regras que visam um tipo de repositório, uma organização, um repositório específico ou uma combinação, como um tipo de repositório dentro de uma organização específica (por exemplo, todos os Spaces de uma organização específica).
O campo Sempre permitido permite definir exceções às regras de bloqueio. Você pode direcionar o conteúdo que deve permanecer acessível mesmo quando uma regra de bloqueio seria aplicada.
Manter os metadados do repositório visíveis
Por padrão, quando um repositório é bloqueado pela Política de Acesso ao Conteúdo, o repositório inteiro se torna inacessível. Ative a opção “Manter metadados do repositório visíveis” para bloquear apenas o conteúdo de um repositório, mantendo seus metadados visíveis.
Quando essa opção está ativada, os repositórios bloqueados ainda exibem seus metadados (cartão do repositório, perfil e páginas de listagem), e apenas seu conteúdo é bloqueado: downloads de arquivos, o visualizador de datasets, a execução de Spaces e a inferência de modelos.
Gerenciar a segurança da rede via API
Você pode ler e atualizar as configurações de segurança de rede da sua organização programaticamente por meio da API do Hub.
Referência OpenAPI:
- GET /api/organizations/
/settings/network-security - PATCH /api/organizations/
/settings/network-security