Hub documentation
Single Sign-On (SSO)
Single Sign-On (SSO)
Este recurso faz parte dos planos Team & Enterprise.
O Hugging Face oferece dois modelos de SSO distintos, cada um projetado para diferentes necessidades organizacionais. Compreender as diferenças entre essas duas abordagens é fundamental para escolher a configuração adequada para a sua equipe.
Visão geral
| SSO básico | SSO gerenciado | |
|---|---|---|
| Plano | Equipe e Empresa | Enterprise Plus |
| Escopo | Recursos apenas da organização | Plataforma Hugging Face |
| Substitui o login da Hugging Face | Não — os usuários mantêm suas credenciais existentes do Hugging Face | Sim — seu IdP se torna o único método de login |
| Contas de usuário | Os usuários mantêm sua conta pessoal do Hugging Face | As contas são possuídas e gerenciadas pela organização |
| Conteúdo pessoal | Os usuários podem criar conteúdo em seu namespace pessoal | Os usuários só podem criar conteúdo dentro da organização |
| Membro de múltiplas organizações | Os usuários podem pertencer a várias organizações | Usuários são restritos à sua organização gerenciadora |
| Provisionamento de usuários | Manual (link de adesão via SSO) — ou baseado em convite SCIM no Enterprise | Ciclo de vida completo (SCIM) |
| Configuração | Serviço autônomo a partir das configurações da organização | Exige configuração com a equipe do Hugging Face |
| Colaboradores externos | Sim | Sim |
| Protocolos | SAML 2.0 e OIDC | SAML 2.0 e OIDC |
| Mapeamento de papéis | Sim | Sim |
| Mapeamento de grupo de recursos | Sim | Sim |
SSO básico
O SSO básico adiciona uma camada de controle de acesso por cima do login padrão do Hugging Face. Ele não substitui o login do Hugging Face — os membros mantêm suas credenciais existentes e são solicitados a concluir o SSO apenas ao acessar os recursos da sua organização.
Isso é ideal para equipes que desejam garantir o acesso aos recursos da organização, preservando a flexibilidade das contas individuais do Hugging Face. A configuração é feita de forma autosserviço nas configurações da sua organização.
SSO gerenciado
O SSO gerenciado substitui completamente o login do Hugging Face. Seu Provedor de Identidade se torna o único método de autenticação em toda a plataforma do Hugging Face. A organização controla todo o ciclo de vida do usuário, desde a criação da conta até a desativação.
Isso foi projetado para empresas que exigem controle completo sobre identidade, acesso e governança de dados. As contas gerenciadas possuem restrições específicas (sem conteúdo pessoal, colaboração vinculada à organização). A configuração requer coordenação com a equipe da Hugging Face.
Começando com SSO gerenciado →
Provisionamento de usuários (SCIM)
Ambos os modelos de SSO suportam SCIM (System for Cross-domain Identity Management) para automatizar o provisionamento de usuários a partir do seu Identity Provider. Os dois modelos utilizam o SCIM de maneiras diferentes, em consonância com suas respectivas filosofias:
- SSO básico (plano Enterprise): o SCIM automatiza o convite de usuários existentes do Hugging Face para a sua organização. Os usuários devem aceitar o convite para participar.
- SSO gerenciado (plano Enterprise Plus): o SCIM gerencia o ciclo de vida completo do usuário — criação de contas, atualizações de perfil e desativação.
Saiba mais no guia de Provisioning de Usuários (SCIM).
Qual modelo você deve escolher?
Escolha SSO Básico se sua equipe precisa proteger o acesso aos recursos organizacionais, permitindo que os membros mantenham suas próprias contas no Hugging Face e participem da comunidade em geral.
Escolha SSO gerenciado se sua empresa exigir controle centralizado sobre todas as contas de usuário, provisionamento e desprovisionamento automatizados e políticas rigorosas de governança de dados que impeçam a criação de qualquer conteúdo fora da organização.
Ambos os modelos suportam os protocolos SAML 2.0 e OIDC e podem ser integrados a provedores de identidade populares, como Okta, Microsoft Entra ID (Azure AD) e Google Workspace.
Leituras adicionais
- Gestão de usuários — Mapeamento de papéis, mapeamento de grupos de recursos, tempo limite de sessão e muito mais
- Guias de configuração — Instruções passo a passo para configuração do Okta, Microsoft Entra ID e Google Workspace