Cange
Conta e Configurações

Como configurar SAML (Single Sign-On) no Cange

14 de novembro de 20266 min de leitura0 visualizações
#Integração#Configuração

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

  1. No painel do administrador, acesse https://app.cange.me/company-config/security.

  2. 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.

Janela Configurar SAML (Single Sign-On) do Cange, com os campos Audience URI, Single sign on URL, Login URL e IDP Public Certificate
Os dois primeiros campos são gerados pelo Cange e vão para o seu provedor. Os dois últimos recebem os dados do provedor.

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.

  1. No IdP, baixe o certificado no formato Base64, também chamado de PEM ou "certificado bruto".

  2. Abra o arquivo em um editor de texto simples, como Bloco de Notas ou VS Code. Não abra no Word.

  3. Copie todo o conteúdo, incluindo as linhas -----BEGIN CERTIFICATE----- e -----END CERTIFICATE-----.

  4. 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 .pfx ou .p12 protegido 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?