Como configurar SAML SSO com o Google Workspace

Neste guia, usaremos o Google Workspace como provedor de SSO e o protocolo Security Assertion Markup Language (SAML) como nosso protocolo de identidade preferido.

Atualmente, suportamos autenticação iniciada pelo SP e iniciada pelo IdP. Para provisionamento de usuários, consulte SCIM.

Este recurso faz parte dos planos Team & Enterprise.

Etapa 1: Criar aplicativo SAML no Google Workspace

• No console de administração do Google Workspace, navegue até Admin > Apps > Web and mobile apps.
• Clique em Add app e depois em Add custom SAML app.
• Você deve fornecer um nome para o seu aplicativo no campo “App name”.
• Clique em Continue.

Etapa 2: Configure o Hugging Face com os detalhes do IdP do Google

• A próxima tela na configuração do Google contém as informações de SSO para o seu aplicativo.
• Nas configurações da sua organização no Hugging Face, vá para a aba SSO e selecione o protocolo SAML.
• Copie a SSO URL do Google para o campo Sign-on URL no Hugging Face.
• Copie o Certificado do Google para o campo correspondente no Hugging Face. O certificado público deve ter o seguinte formato:
  Copiado

  -----BEGIN CERTIFICATE-----
  {certificate}
  -----END CERTIFICATE-----

• Na configuração do Google Workspace, clique em Continue.

Etapa 3: Configure o Google com os detalhes do SP da Hugging Face

• Na tela “Service provider details”, você precisará da Assertion Consumer Service URL e do SP Entity ID das configurações de SSO do Hugging Face. Copie-os para os campos correspondentes ACS URL e Entity ID no Google.
• Certifique-se de que os seguintes itens estejam configurados:
  • Marque a caixa Resposta assinada.
  • Formato do ID do nome: EMAIL
  • ID do nome: Basic Information > Primary email

• Clique em Continue.

Etapa 4: Mapeamento de Atributos

• Na tela “Attribute mapping”, clique em Add mapping e configure os atributos que deseja enviar. Esta etapa é opcional e depende se você deseja usar Role Mapping ou Resource Group Mapping no Hugging Face.

• Clique em Finish.

Etapa 5: Testar e habilitar o SSO

Antes de testar, verifique se você concedeu acesso à aplicação para os usuários apropriados no console de administração do Google Workspace, nas configurações de “Acesso do usuário” da aplicação. O administrador que executa o teste deve ter acesso. Pode levar alguns minutos para que as alterações de acesso do usuário sejam aplicadas no Google Workspace.

• Agora, nas suas configurações de SSO do Hugging Face, clique em “Update and Test SAML configuration”.
• Você deve ser redirecionado para a tela de login do Google. Após fazer login, você será redirecionado para a página de configurações da sua organização.
• Uma marca de verificação verde perto do seletor SAML confirmará que o teste foi bem-sucedido.
• Quando o teste for bem-sucedido, você pode habilitar o SSO para sua organização clicando no botão “Enable”.
• Uma vez habilitado, os membros da sua organização devem concluir o fluxo de autenticação SSO descrito na seção Como funciona.

Update on GitHub