Como configurar SAML (Single Sign-On) no Cange
Com o SSO ativado, as pessoas da sua empresa entram no Cange usando as credenciais do provedor de identidade corporativo, e o Cange para de pedir senha própria. Este guia mostra como ativar o SSO na tela de segurança do Cange, de ponta a ponta.
Antes de começar
RequisitoDetalhePlanoDisponível apenas para contas EnterprisePermissão no CangePerfil de Administrador da contaProvedor de identidade (IdP)Um IdP compatível com SAML 2.0 e acesso de administrador neleO que você vai trazer do IdPLogin URL (URL de logon ou SSO) e o certificado público X.509Usuários no CangeCada pessoa que vai entrar por SSO já precisa estar cadastrada no Cange com o mesmo e-mail do IdP. O SSO não cria usuários automaticamente.
A configuração acontece nas duas pontas. Você copia dois valores do Cange para o seu provedor, e traz dois valores do provedor de volta para o Cange. Deixe as duas abas abertas lado a lado.
Passo 1: acesse as configurações de segurança
No painel do administrador, acesse
https://app.cange.me/company-config/security.Role até a seção Autenticação de Dois Fatores (MFA).
Passo 2: ative a MFA obrigatória
No campo MFA Obrigatória, selecione Ativo. Esse passo é o que habilita a definição de um método de autenticação para toda a conta.
Passo 3: selecione SAML como método padrão
No campo Método Padrão, selecione SAML. Assim que a opção for selecionada, um botão Configurar aparece ao lado do campo.
Passo 4: abra a tela de configuração
Clique em Configurar. A janela Configurar SAML (Single Sign-On) abre com quatro campos: dois preenchidos pelo Cange, somente leitura, e dois que você precisa preencher.
Passo 5: copie os endpoints do Cange para o seu IdP
A seção Endpoints do serviço SAML traz os dois valores que identificam o Cange como provedor de serviço. Use o botão Copiar de cada campo e cole no seu provedor de identidade.
Campo no CangeComo costuma se chamar no IdPValorAudience URI (SP Entity ID)Identifier, Entity ID, Audiencehttps://api.cange.me/auth/saml/metadataSingle sign on URL (ACS URL)Reply URL, ACS URL, Assertion Consumer Servicehttps://api.cange.me/auth/saml/acs
Sempre copie os valores direto da tela, pelo botão Copiar. Não digite manualmente e não reaproveite valores de outra documentação. Qualquer diferença de caractere, barra final ou protocolo faz a configuração falhar.
Neste ponto, pause o Cange e vá até o seu provedor de identidade para criar a aplicação e colar esses dois valores. Siga o guia do seu provedor:
Usa outro provedor? O procedimento é o mesmo, só os nomes dos campos mudam. Volte aqui com a Login URL e o certificado em mãos.
Passo 6: preencha a Login URL
Volte à janela do Cange e preencha o campo Login URL com a URL de logon fornecida pelo seu IdP. É o endereço para onde o Cange vai redirecionar o usuário no momento do login. Cada provedor usa um nome diferente para ela:
Microsoft Entra ID: "URL de Logon" ou "Login URL"
Okta: "Identity Provider Single Sign-On URL"
Google Workspace: "URL do SSO"
ADFS: normalmente
https://seu-adfs/adfs/ls/
Passo 7: cole o certificado público do IdP
Preencha o campo IDP Public Certificate com o certificado X.509 que o seu provedor gera para esta aplicação.
No IdP, baixe o certificado no formato Base64, também chamado de PEM ou "certificado bruto".
Abra o arquivo em um editor de texto simples, como Bloco de Notas ou VS Code. Não abra no Word.
Copie todo o conteúdo, incluindo as linhas
-----BEGIN CERTIFICATE-----e-----END CERTIFICATE-----.Cole no campo do Cange.
Este é o certificado público. Nenhuma chave privada é trocada entre as duas plataformas. Se o seu IdP oferecer o download de um arquivo
.pfxou.p12protegido por senha, esse não é o arquivo que você precisa.
Passo 8: teste a conexão
Antes de salvar, use a opção de teste da conexão e confirme que o teste passa. Se falhar, consulte a seção de erros comuns no final deste artigo antes de prosseguir.
Passo 9: salve a configuração
Com o teste aprovado, clique em Salvar. O indicador de status da janela deixa de exibir Não configurado. A partir desse momento, o login da conta passa a ser feito pelo provedor de identidade.
O que muda depois de ativar
Ao acessar o Cange, os usuários são redirecionados para a tela de login do provedor de identidade.
Quem já tem sessão ativa no IdP entra direto, sem digitar credenciais.
As políticas de senha, MFA e acesso condicional passam a ser as do seu provedor.
A desativação de um colaborador no IdP bloqueia o acesso dele ao Cange.
Erros comuns e como resolver
SintomaCausa provávelComo resolverO IdP recusa o login antes de voltar ao CangeIdentifier ou Entity ID divergenteConfira se o valor colado no IdP é exatamente o Audience URI da tela do CangeErro de "Reply URL não corresponde"ACS URL divergenteConfira a Single sign on URL no IdP, incluindo protocolo e ausência de barra finalLogin volta ao Cange mas não autenticaAssinatura inválidaRecopie o certificado e verifique se não há espaços, quebras de linha extras ou caracteres perdidos na colagemFuncionava e parou de repenteCertificado expiradoGere um novo certificado no IdP e atualize o campo IDP Public CertificateUm usuário específico não entraUsuário não atribuído à aplicaçãoVerifique a atribuição de usuários e grupos na aplicação criada no IdP
Boas práticas
Teste com um usuário antes de liberar para todos. Ative com um grupo piloto e só depois amplie.
Mantenha um administrador de reserva. Garanta que exista um caminho de acesso caso o IdP fique indisponível.
Acompanhe a validade do certificado. A maioria dos provedores emite certificados com validade de alguns anos, e o SSO para de funcionar no dia do vencimento. Cadastre um lembrete e um e-mail de notificação de expiração no seu IdP.
Padronize o identificador do usuário. Use o e-mail corporativo como identificador enviado pelo IdP e garanta que ele corresponda ao cadastro do usuário no Cange.
Próximos passos
Este artigo foi útil?