SSO com Microsoft Entra ID
O SSO deixa alunos e administradores entrarem com a conta Microsoft da empresa, e é configurado pelo Administrador da plataforma com o Client ID, o Tenant ID e o Secret ID de um aplicativo criado no Microsoft Entra ID.
O que é
SSO (Single Sign-On) é o login único: a pessoa entra na plataforma com a conta que já usa na empresa, sem criar outra senha.
O provedor disponível é o Microsoft Entra ID. Não há login por Google, Okta ou outros provedores.
Onde acessar
Plataforma > Configuração > SSO (Single Sign-On).
🔒 O item só aparece para o Administrador da plataforma.
A tela se chama SSO e mostra o bloco Autenticações disponíveis, com um card para o Microsoft Entra ID, o status (Ativo ou Inativo), uma chave de ligar e desligar e o botão Configurar.
Antes de começar
Você vai precisar de alguém com acesso de administração ao Microsoft Entra ID da empresa, para registrar um aplicativo e obter:
- Client ID
- Tenant ID
- Secret ID (o segredo do aplicativo)
Essa pessoa também vai precisar do Redirect_URI da sua plataforma, que a tela da Evob mostra pronto para copiar.
Passo a passo
1. Copie o Redirect_URI
- No card do Microsoft Entra ID, clique em Configurar.
- Na janela, localize o campo Redirect_URI. Ele vem preenchido com o endereço do seu site seguido de
/ssoe não pode ser editado. - Clique no botão de copiar ao lado do campo.
2. Registre o aplicativo no Microsoft Entra ID
No portal da Microsoft, a equipe de TI registra um aplicativo, informa o Redirect_URI copiado como endereço de redirecionamento e gera um segredo. Ao fim, ela terá o Client ID, o Tenant ID e o Secret ID.
3. Preencha a conexão
De volta à janela de configuração:
| Campo | O que colocar |
|---|---|
| Client ID | O identificador do aplicativo |
| Tenant ID | O identificador do diretório da empresa |
| Secret ID | O segredo gerado para o aplicativo |
| Authorization URI | Já vem com https://login.microsoftonline.com. Mantenha, a menos que a TI oriente outro endereço |
Os quatro campos são obrigatórios. Campo vazio mostra "Este campo é obrigatório".
4. Escolha onde o SSO vale
Em Aplicações:, marque:
- Administradores: o botão de login com a Microsoft aparece na entrada do admin.
- Alunos: aparece na entrada do site.
Pode marcar um ou os dois.
5. Ative e salve
- Ligue a chave Ativar SSO:.
- Clique em Salvar.
A confirmação é "As configurações foram atualizadas com sucesso!". O card passa a mostrar Ativo.
6. Confira a tela de login do site
Para os alunos, o botão de SSO depende também de uma chave no Builder: em Builder > Autenticação > Login, confira se Habilitar SSO está ligada.
7. Teste
Abra o site (ou o admin) em uma janela anônima. A tela de login mostra o botão Entrar com Microsoft Entra ID. Entre com uma conta da empresa.
Primeiro acesso de quem nunca teve cadastro
Quando uma pessoa entra por SSO com um e-mail que ainda não existe na plataforma, o cadastro dela é criado na hora, com o nome e o e-mail vindos da conta Microsoft.
Entrar por SSO não dá acesso ao admin. Para isso, a pessoa precisa ser adicionada como colaboradora. Veja Adicionar colaboradores à plataforma.
Permitir ou bloquear o cadastro comum
No rodapé do bloco Autenticações disponíveis há uma chave com o texto "Permitir o cadastro de novos usuários sem SSO, através do formulário padrão disponível na plataforma".
- Ligada: além do SSO, qualquer pessoa pode se cadastrar pelo formulário do site.
- Desligada: novos cadastros só entram por SSO.
Para plataformas de treinamento corporativo, desligar essa chave garante que só quem tem conta na empresa consiga entrar.
💡 A opção de criar conta exibida na tela de login e no cabeçalho do site também pode ser escondida no Builder, pelas chaves Cadastro de Builder > Autenticação > Login e de Builder > Header e footer > Header.
Trocar o segredo
O Secret ID não fica visível depois de salvo. Para trocar:
- Clique em Configurar.
- Clique em Editar Secret ID.
- Cole o novo segredo e clique em Salvar.
Segredos do Microsoft Entra ID têm validade. Anote a data de vencimento e troque antes: com o segredo vencido, o login por SSO para de funcionar.
Desligar o SSO
Desligue a chave do card, ou a chave Ativar SSO: dentro da configuração. O status volta para Inativo. Os dados da conexão ficam guardados, e você pode religar depois sem preencher de novo.
Antes de desligar, confira a chave de cadastro comum, no rodapé do bloco: se ela estiver desligada e o SSO também, a plataforma fica sem porta de entrada para pessoas novas.
O que o SSO não faz
- Não aplica o MFA da Evob. Quem entra por SSO é verificado pela Microsoft. O segundo fator, se houver, é o que a empresa exige na conta dela.
- Não remove o acesso sozinho. Desativar a conta de alguém no Microsoft Entra ID impede novos logins por SSO, mas não exclui o cadastro nem as matrículas na plataforma.
- Não sincroniza grupos nem cargos. Só o nome e o e-mail chegam à plataforma.
Erros comuns
"Nenhum provedor de SSO disponível neste momento."
A plataforma não tem provedor liberado. Fale com o suporte.
"A chave do card está desabilitada"
O provedor ainda não foi configurado. Clique em Configurar, preencha os campos e salve. Depois a chave passa a responder.
"O botão de SSO não aparece para os alunos"
Confira três pontos: o status Ativo no card, a opção Alunos marcada em Aplicações: e a chave Habilitar SSO em Builder > Autenticação > Login.
"A Microsoft mostra erro de endereço de redirecionamento"
O Redirect_URI cadastrado no aplicativo da Microsoft não é igual ao da tela da Evob. Copie de novo pelo botão de copiar e peça à TI para conferir. Se o domínio do site mudou, o Redirect_URI também mudou.
"Parou de funcionar de um dia para o outro"
O segredo do aplicativo provavelmente venceu. Gere outro no Microsoft Entra ID e troque em Editar Secret ID.