Ir para o conteúdo

Guia

Configurar o login único (SSO)

Identidade visual e configurações · 5 min de leitura

O login único (SSO, single sign-on) permite que os membros entrem na sua comunidade com a conta de trabalho do provedor de identidade (IdP) da sua organização, como Okta, Microsoft Entra ID (antigo Azure AD) ou Google. As novas configurações usam OIDC (OpenID Connect).

A configuração de SSO não está disponível no menu no momento. Admin → Configurações não lista SSO. O restante deste artigo descreve como o SSO funciona.

Quem pode fazer isso: só o proprietário da comunidade pode alterar as configurações de SSO, e para salvar você precisa digitar sua senha de novo. Os administradores podem vê-las. · Onde: web (console de administração). Os membros usam o SSO na web e, com OIDC, também no app Mateflow. · Plano: o SSO depende do seu plano da plataforma. Se o seu plano não o incluir, a página SSO informa quais planos incluem. Se você mudar para um plano sem SSO, o SSO para de funcionar e os membros entram com seus outros métodos; suas configurações são mantidas para quando você fizer upgrade.

Conectar seu provedor de identidade com OIDC

Para conectar seu provedor de identidade, você precisa de acesso de administrador a ele.

  1. Na aba Configuração de SSO da página SSO, crie um app correspondente no seu IdP.
  2. Digite a URL do Emissor, o ID do Cliente, o Segredo do Cliente e os Escopos (separados por vírgula), como openid, email, profile.
  3. Clique em Salvar Configuração de SSO e digite sua senha de novo. Adicione ao app do seu IdP a URI de Redirecionamento (URL de Callback) que agora aparece em Informações do SP.
  4. Ative o interruptor em Status do SSO e salve. O SSO não pode ser ativado enquanto a configuração estiver incompleta.

A opção SAML 2.0 só aparece em uma comunidade que já tem SAML salvo.

Executar a checklist de ativação do SSO

Antes de ativar é uma checklist na página SSO, para o proprietário. Ela é executada sobre a configuração salva:

  • Verificar a configuração: clique em Verificar.
  • Entre com sua própria conta: clique em Testar login. Ele leva ao seu provedor de identidade e o vincula à sua conta, e você continua conectado.
  • Administradores de recuperação: adicione pelo menos um, para que alguém ainda consiga entrar se o provedor de identidade parar de funcionar. A checklist cita quem não tem senha, porque o login de recuperação não funciona para essas pessoas.

Alterar as configurações do provedor de identidade apaga os dois primeiros resultados, então execute-os de novo.

Escolher uma política de login com SSO

Sua política de login com SSO decide quais outros métodos de login continuam disponíveis. Na aba Política de Login, escolha um Modo de Login:

  • SSO + Senha: SSO ou e-mail e senha. O login social fica oculto.
  • SSO + Social + Senha: todos os métodos continuam disponíveis.
  • Somente SSO: todos precisam usar o SSO. O login com senha, o login social e o cadastro por e-mail ficam bloqueados.

Você não pode escolher Somente SSO até que Verificar a configuração e Entre com sua própria conta tenham sido aprovados. Adicione também um administrador de recuperação; caso contrário, uma configuração do IdP com problema pode deixar todos sem acesso.

Você também pode definir o Texto do Botão SSO e os Domínios de E-mail Permitidos (separados por vírgula). Com domínios definidos, um e-mail fora deles não pode entrar com SSO, mesmo em uma conta que já esteja vinculada. Só um domínio exato corresponde, não os subdomínios dele.

Ativar ou desativar o provisionamento JIT de usuários

O provisionamento JIT (just-in-time) de usuários decide se o primeiro login com SSO pode criar uma nova conta. É o interruptor Provisionamento JIT de Usuários na aba Sincronização de Usuários, ativado por padrão.

  • Ativado: alguém novo recebe uma conta na primeira vez que entra com SSO.
  • Desativado: quem não tem conta não pode entrar com SSO. Os membros existentes ainda podem usá-lo: o primeiro login deles com SSO é vinculado à conta com o mesmo e-mail.

O proprietário e a equipe nunca são vinculados por e-mail. Se tentarem, verão "Este e-mail pertence a uma conta da equipe da comunidade, então não pode ser vinculado automaticamente." Eles entram da forma habitual e clicam em Vincular SSO em Configurações → Segurança na web.

Adicionar administradores de recuperação para o SSO

Os administradores de recuperação podem entrar com senha quando o SSO falha, mesmo com Somente SSO. Cada um precisa ser proprietário ou administrador da sua comunidade e ter uma senha na conta.

  1. Na aba Sincronização de Usuários, digite os IDs de usuário em IDs de Usuário Admin de Recuperação (separados por vírgula). Para encontrar um ID, acesse Admin → Membros → Todos os Membros, clique na pessoa e use Copiar ID ao lado de ID do membro.
  2. Clique em Salvar Configuração de SSO.

Com Somente SSO, os administradores de recuperação clicam em Login de administrador de recuperação na página de login e digitam o e-mail e a senha. A autenticação de dois fatores continua valendo, e cada login de recuperação é registrado e enviado por e-mail a esse administrador.

Analisar os logins com SSO no log de auditoria

O log de auditoria do SSO registra os logins com SSO, as contas criadas pelo provisionamento JIT, as alterações de configuração e os erros. A aba Auditoria mostra Total de Usuários SSO, Logins SSO (Últimos 30 Dias) e Último Login SSO. Clique em Abrir Logs de Auditoria para ver a lista completa, que pode ser filtrada por Ação (Login SSO, Provisionamento Automático de Usuário, Alteração de Configuração, Conta vinculada, Login de recuperação ou Erro), Data de Início e Data de Término.

O que os membros veem ao entrar com SSO

Os membros começam na página de login da sua comunidade, clicam no seu botão de SSO (Usar SSO empresarial por padrão), entram no seu IdP e voltam já conectados. A autenticação de dois fatores continua valendo.

O login precisa começar na sua comunidade. Clicar no bloco do app no portal do seu IdP (login iniciado pelo IdP) não é compatível.

No app Mateflow, os membros podem entrar com OIDC (o botão padrão é Sign in with SSO). O app não é compatível com SAML: com Somente SSO, ele pede aos membros que usem a web; nos outros casos, mostra apenas os outros métodos.

Solução de problemas de login com SSO

Sintoma: os membros recebem um erro quando começam pelo portal de apps do IdP. Por que acontece: o login iniciado pelo IdP não é compatível. Solução: peça aos membros que comecem pela página de login da sua comunidade, ou aponte para ela a URL de login do bloco do app, se o seu IdP permitir.

Sintoma: pessoas novas não conseguem entrar com SSO depois que você desativou o JIT. Por que acontece: com o JIT desativado, o SSO não cria contas novas. Essas pessoas veem "Esta comunidade não cria novas contas por SSO. Entre em contato com o administrador." Solução: ative de novo o Provisionamento JIT de Usuários ou convide essas pessoas primeiro.

Sintoma: ninguém consegue entrar com Somente SSO. Por que acontece: a conexão com o IdP deixou de funcionar. Solução: um administrador de recuperação entra com Login de administrador de recuperação e corrige as configurações.

Sintoma: um membro vê "Seu provedor de identidade não confirmou este e-mail. Entre em contato com o administrador." Por que acontece: seu IdP não marcou o e-mail dessa pessoa como confirmado, então o Mateflow não o associa a uma conta. Solução: verifique o e-mail da conta dessa pessoa no seu IdP.

Artigos relacionados

Este guia foi útil?

Voltar aos guias

Não encontra o que precisa?

Se você é membro de uma comunidade, fale com os administradores dela. Se está criando ou gerenciando uma comunidade no Mateflow, nossa equipe pode ajudar.