# SSO básico

> [!WARNING]
> 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](./enterprise-sso).

## Como funciona

> [!NOTE]
> **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](https://huggingface.co/settings/account).**

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](./security-sso-configuration-guides) 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](./enterprise-scim) para automatizar o provisionamento baseado em convites a partir do seu Identity Provider. Consulte o [guia de SCIM](./enterprise-scim) para mais detalhes.

## Tokens de acesso e chaves SSH

Para usar um [User Access Token](./security-tokens) ou uma [SSH key](./security-git-ssh) com uma organização que impõe SSO, você primeiro precisa autorizá-lo para essa organização. Até lá, as solicitações feitas com ele aos recursos da organização são rejeitadas, incluindo Git over SSH. O acesso aos seus outros recursos não é afetado.

Para autorizar um token ou uma chave SSH:

1. Vá para [Access Tokens](https://huggingface.co/settings/tokens) ou [SSH and GPG Keys](https://huggingface.co/settings/keys) em suas configurações.
2. Abra o menu ao lado do token ou da chave e clique em **Configure SSO**.
3. Clique em **Autorizar** ao lado da organização. Você será redirecionado para seu Provedor de Identidade para fazer login.

Tokens que você cria enquanto estiver conectado à organização com SSO são autorizados para ela automaticamente.

Uma autorização permanece válida até que você a desautorize pelo mesmo menu ou saia da organização. Se você voltar, autorize novamente seus tokens e chaves. Colaboradores externos não precisam autorizar suas credenciais.

Administradores de organização podem ver autorizações e desautorizações nos [logs de auditoria](./audit-logs).

## 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](./security-sso-user-management). Esses recursos são configuráveis nas configurações da sua organização.

