SSO básico

Este recurso faz parte dos planos Team & Enterprise.

O SSO básico adiciona uma camada de controle de acesso por cima do login padrão do Hugging Face. Ele permite que você exija a autenticação por meio do seu Provedor de Identidade (IdP) quando os membros acessam recursos no namespace da sua organização, como modelos privados, conjuntos de dados e Spaces.

Para uma comparação com o SSO gerenciado, consulte a visão geral do SSO.

Como funciona

O SSO básico não substitui o login do Hugging Face. Seus membros ainda precisarão fazer login no Hugging Face com suas próprias credenciais (e-mail/senha, Google ou GitHub) antes de serem solicitados a concluir a autenticação SSO para acessar os recursos da sua organização. Isso é por design: o SSO básico protege o acesso à sua organização sem assumir a identidade do usuário no Hugging Face.

Quando o Single Sign-On está ativado, os membros da organização se autenticam por meio do seu Identity Provider (IdP). Você escolhe se o SSO é obrigatório ou opcional:

• Aplicado (padrão): Os membros devem concluir a autenticação SSO antes de acessar qualquer coisa no namespace da organização.
• Opcional: Os membros recebem um aviso por meio de um banner no topo da página para configurar o SSO, mas podem ignorá-lo e ainda assim acessar a organização. Isso é útil quando você está migrando muitos usuários e deseja dar a eles tempo para organizar suas contas antes de aplicar o SSO de forma obrigatória.

O conteúdo público continua acessível a todos, incluindo não membros.

Usamos endereços de e-mail para identificar usuários de SSO. Como usuário, certifique-se de que seu endereço de e-mail organizacional (por exemplo, seu e-mail corporativo) tenha sido adicionado a sua conta de usuário.

Quando os usuários fazem login, eles serão solicitados a concluir o fluxo de autenticação de Single Sign-On com um banner semelhante ao seguinte:

O Single Sign-On se aplica apenas à sua organização. Os membros podem pertencer a outras organizações no Hugging Face.

Começando

O SSO básico pode ser configurado diretamente nas configurações da sua organização. O Hugging Face Hub pode funcionar com qualquer provedor de identidade compatível com OIDC ou SAML, incluindo Okta, OneLogin e Microsoft Entra ID (Azure AD).

Consulte nossos Guias de Configuração para instruções de configuração passo a passo.

Provisionamento de usuários

Quando o SSO é ativado na sua organização, um link de adesão direta pode ser copiado e compartilhado com novos membros. Este link de adesão via SSO está disponível nas abas de configurações SSO e Membros. Como organizações com SSO ativado não podem usar links de convite clássicos, o link de adesão via SSO é o método principal para convidar colegas para a sua organização. Basta clicar no botão de copiar para copiar o link para a área de transferência e compartilhá-lo com os membros que você deseja convidar. Quando os destinatários clicarem no link compartilhado, eles poderão autenticar-se via SSO e aderir diretamente à sua organização.

Organizações no plano Enterprise também podem usar SCIM para automatizar o provisionamento baseado em convites a partir do seu Identity Provider. Consulte o guia de SCIM para mais detalhes.

Recursos de SSO

O SSO básico oferece suporte a mapeamento de funções, mapeamento de grupos de recursos, tempo limite de sessão, correspondência de domínios de e-mail e colaboradores externos. Esses recursos são configuráveis nas configurações da sua organização.

Update on GitHub