Login único (SSO)

A equipe entra com a conta da organização — Microsoft, Google, Keycloak, ADFS ou gov.br — e a Brasmobi não guarda mais uma senha.

O login único (em inglês, single sign-on, SSO) deixa a pessoa entrar no Brasmobi com a mesma conta que já usa na organização. É opcional e vale por negócio: sem provedor ativo, o login continua o de sempre. Um negócio pode ter vários provedores, por SAML 2.0 ou OpenID Connect.

Visão geral

Onde encontrar: Cadastros Segurança de acesso aba Login único. Quem configura é quem tem a permissão Segurança de acesso (o proprietário do negócio).

Aba Login único com o provedor Conta da Prefeitura ativo
A mesma aba no celular
Cada provedor aparece num cartão: tipo, onde vale (painel e/ou portal), domínios de e-mail e as contas já vinculadas.
Provedor de identidade (IdP) é o sistema onde as contas da organização moram (Microsoft Entra ID, Google Workspace, Keycloak, ADFS, gov.br…). O Brasmobi pergunta a ele quem é a pessoa e confia na resposta assinada.

Guia rápido

1
Cadastre o provedor

Em Novo provedor, escolha SAML 2.0, OpenID Connect ou o modelo pronto do gov.br. Dê um nome — ele aparece no botão “Entrar com …”.

2
Troque os endereços com o IdP

O Brasmobi mostra os endereços para cadastrar no IdP (entityID, ACS ou endereço de retorno). Do IdP vêm o certificado ou o client_id e o segredo.

3
Teste e ative

Use Testar configuração, ligue Ativo e entre com uma conta de teste antes de avisar a equipe.

Provedor SAML 2.0

Modal do provedor SAML com os endereços para o IdP
O mesmo modal no celular
Os endereços do Brasmobi ficam no próprio modal, com botão de copiar.
  • No IdP, crie um aplicativo SAML com o Identificador (entityID) e o endereço de resposta (ACS, HTTP-POST) do modal — ou importe os metadados do Brasmobi pelo endereço indicado.
  • No Brasmobi, cole o endereço (ou o XML) dos metadados do IdP em Importar metadados: o entityID, os endereços e o certificado são preenchidos.
  • O IdP precisa mandar o e-mail (atributo email, mail ou o NameID no formato e-mail) e, se quiser, o nome e os grupos.
  • A asserção tem de vir assinada. Login começado no IdP (sem passar pelo botão do Brasmobi) é recusado.

Provedor OpenID Connect

Informe o emissor (issuer) — o Brasmobi lê o resto em /.well-known/openid-configuration —, o client_id e o segredo do cliente (guardado cifrado; depois de salvo, nunca é mostrado). No IdP, cadastre o endereço de retorno do modal. O Brasmobi usa o fluxo authorization code com PKCE.

gov.br (Login Único do governo federal)

Modelo gov.br já preenchido, com o aviso da adesão do órgão
O modelo gov.br já vem com o emissor e os escopos. Faltam só as credenciais, que o gov.br entrega depois da adesão.
1
Adesão do órgão

O órgão (prefeitura, consórcio…) pede a integração ao Login Único pelo formulário do Portal gov.br, informando o sistema, o responsável e o endereço de retorno do Brasmobi (está no modal).

2
Homologação

O gov.br libera primeiro o ambiente de testes: troque o emissor para https://sso.staging.acesso.gov.br/, preencha o client_id e o segredo de homologação e teste com contas de teste.

3
Produção

Com a aprovação, volte o emissor para https://sso.acesso.gov.br/, troque as credenciais pelas de produção e ative.

Dica: o gov.br costuma servir ao portal do cidadão (quem abre chamados). Para a equipe, o provedor da própria prefeitura (Microsoft, Google…) é o mais comum.

Como a pessoa entra

Na tela de login, ao digitar um e-mail de um domínio do provedor, aparece o botão Entrar com …. Um clique leva ao IdP e, de volta, direto ao painel.

Login com o botão Entrar com Conta da Prefeitura
Tela do provedor de identidade (demonstração)
À esquerda, o botão no login; à direita, o IdP (nesta captura, um IdP de demonstração).
  • A conta casa pelo e-mail e precisa fazer parte da equipe deste negócio. Quem não faz parte recebe a orientação de pedir um convite.
  • Com Criar a conta no primeiro login, um e-mail que ainda não tem conta na Brasmobi ganha conta com o papel escolhido, dentro do limite de usuários do plano. Só funciona com domínio de e-mail e Aceitar só e-mails destes domínios ligado. Conta que já existe nunca é anexada pelo IdP.
  • A sessão aberta pelo login único vale só no negócio do provedor: não abre, não administra nem aceita convite de outro negócio da mesma conta, e não cadastra negócio novo. Para isso, entre com e-mail e senha.
  • A conta de Administrador do SaaS (suporte da Brasmobi) nunca entra pelo login único; e quem ficou mais tempo sem acessar do que o sistema permite é bloqueado como no login por senha.
  • Ao sair, a sessão do Brasmobi termina sempre. Com Sair também do IdP (SAML), a pessoa sai do provedor junto.
Página de recusa do login único
Quando algo não confere (login vencido, resposta adulterada, conta fora da equipe), a pessoa vê o motivo e volta ao login.

Contas criadas pelo login único

Com Criar a conta no primeiro login, o provedor cria a conta de quem ainda não tem uma. Essas contas ficam marcadas e podem perder o acesso a este negócio de uma vez, quando o provedor deixa de ser usado.

Lista das contas criadas pelo login único, com e-mail, último acesso e se têm senha
A mesma lista no celular
No cartão do provedor, Criadas pelo login único lista as contas, com o último acesso e se já têm senha. Marque as que devem sair e use Inativar o vínculo com este negócio.
  • A conta criada assim começa sem senha e entra só pelo provedor. Para ter senha, a pessoa usa Esqueci minha senha na tela de login e recebe o link no próprio e-mail — a sessão do login único não cria senha.
  • Inativar o vínculo tira o acesso só a este negócio: as sessões dela aqui terminam, e a conta e os outros negócios dela não mudam. Cada inativação fica na trilha de auditoria.
  • Ao desligar um provedor, a lista abre sozinha com as contas que ele criou e que ainda têm acesso. Ao excluir, a confirmação já vem marcada para inativar essas contas junto.
  • Desligar ou excluir o provedor encerra as sessões abertas por ele, mas quem já criou uma senha pelo e-mail continua entrando — por isso a escolha de inativar aparece nesse momento.
  • Em Contas vinculadas, cada conta mostra se foi criada pelo login único ou se já existia.
Lista aberta sozinha depois de desligar o provedor
Confirmação da exclusão do provedor com a opção de inativar as contas criadas por ele
À esquerda, a lista que abre ao desligar o provedor; à direita, a confirmação da exclusão.

Portal do solicitante e central de ajuda

Marque Portal do solicitante e central de ajuda no provedor e o portal do Help Desk ganha o botão. Quem entra assim acompanha e abre chamados como sempre, sem conta no painel: o Brasmobi encontra (ou cria) a pessoa no cadastro pelo e-mail.

Portal com o botão do login único
Solicitante já dentro do portal, no celular
O código por e-mail continua disponível para quem não tem conta no provedor.

Só login único

Com Só login único para a equipe, a senha da Brasmobi deixa de abrir o negócio: a pessoa vê o botão do provedor. Proprietários e o suporte da Brasmobi continuam podendo usar a senha, para ninguém ficar trancado fora se o IdP cair.

Interruptor Só login único para a equipe
Login por senha mostrando o botão do provedor
Atenção: a regra só liga com um provedor do painel ativo, e esse provedor não pode ser desligado enquanto ela estiver ligada.

Verificação em duas etapas

Por padrão, quem ativou a verificação em duas etapas da Brasmobi digita o código também depois do login único — é o mais seguro. Se o provedor já exige MFA de todas as contas, ligue O provedor já exige verificação em duas etapas: o código da Brasmobi deixa de ser pedido nessas entradas, inclusive quando a política do negócio exige a verificação.

Configurações

CampoO que controla
Nome no botão essencialTexto do botão “Entrar com …”.
Vale paraPainel da equipe e/ou portal do solicitante e central de ajuda.
Domínios de e-mailQuem digitar um e-mail destes domínios no login vê o botão. Um domínio pertence a uma organização só; domínios de e-mail gratuito (Gmail, Hotmail…) não são aceitos.
Aceitar só e-mails destes domíniosRecusa a resposta do IdP com e-mail de outro domínio.
Criar a conta no primeiro loginConta nova com o papel escolhido (só para e-mail sem conta na Brasmobi; exige domínio com “Aceitar só e-mails destes domínios”).
O provedor já exige MFADispensa o código da Brasmobi nas entradas por este provedor.
Só entra quem estiver nos gruposLista de grupos do IdP; vazia = qualquer conta.
AtributosNomes dos atributos de e-mail, nome e grupos, quando o IdP não usa os nomes comuns.
Sair também do IdP (SAML)Logout único: ao sair do Brasmobi, sai do provedor também.
Contas vinculadasCada conta fica ligada à identidade do IdP no primeiro login, com a origem (criada pelo login único ou conta que já existia). Desfaça o vínculo quando o IdP trocar a identidade da pessoa.

Segurança

  • Assinatura SAML conferida pela biblioteca onelogin/php-saml (inclusive contra XML Signature Wrapping), com audiência, destino e prazo; cada resposta vale uma vez.
  • OpenID Connect com PKCE, state e nonce de uso único e o id_token validado pelas chaves públicas do provedor.
  • O login tem de terminar no mesmo navegador em que começou. Depois do login, o Brasmobi só leva a telas do próprio sistema.
  • Metadados e configurações do provedor só são buscados em endereços https públicos.
  • Cada configuração e cada entrada ficam na trilha de auditoria; o segredo do cliente nunca aparece nela.

Perguntas frequentes

O proprietário continua entrando com a senha e pode desligar o “Só login único” na mesma aba. Sem essa regra, a senha da equipe continua valendo.

O IdP mandou outra identidade para o mesmo e-mail (por exemplo, a conta foi recriada). Confira com a TI e use Contas vinculadas › Desfazer.

O login único de um negócio abre só aquele negócio. Para o outro, a pessoa entra pelo login dele (senha ou o provedor de lá).

O certificado digital pessoal (e-CPF), a senha, o nome, a foto e as preferências são da sua conta Brasmobi, não da organização. Quem entrou pelo login único confirma a senha da conta (e o código do aplicativo, se usar a verificação em duas etapas) antes de usar, trocar ou excluir o certificado ou mudar esses dados. A confirmação vale por 5 minutos naquele acesso. Conta criada pelo login único começa sem senha: para criar uma, use “Esqueci minha senha” na tela de login — o link vai ao seu e-mail. Sem senha, o certificado pessoal e os dados da conta ficam bloqueados. O e-CNPJ da empresa continua assinando normalmente.