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.
Nesta página
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).
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
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)
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.
À 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.
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.
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.
À 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.
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.
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
Campo
O que controla
Nome no botãoessencial
Texto do botão “Entrar com …”.
Vale para
Painel da equipe e/ou portal do solicitante e central de ajuda.
Domínios de e-mail
Quem 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ínios
Recusa a resposta do IdP com e-mail de outro domínio.
Criar a conta no primeiro login
Conta 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 MFA
Dispensa o código da Brasmobi nas entradas por este provedor.
Só entra quem estiver nos grupos
Lista de grupos do IdP; vazia = qualquer conta.
Atributos
Nomes 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 vinculadas
Cada 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.