Cange
Conta e Configurações

Como configurar o Microsoft Entra ID para o SSO do Cange

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

Este guia é a contraparte de Como configurar SAML (Single Sign-On) no Cange, para empresas que usam o Microsoft Entra ID, antigo Azure AD, como provedor de identidade. Aqui você cria a aplicação no Entra e obtém os dois valores que o Cange precisa: a Login URL e o certificado público.

Faça primeiro os passos 1 a 5 do artigo do Cange, para ter em mãos o Audience URI e a ACS URL.

Antes de começar

RequisitoDetalheLicença do EntraO SSO SAML básico está disponível em todos os planos, inclusive o gratuitoPermissãoAdministrador de Aplicativos, Administrador de Aplicativos de Nuvem ou função com privilégios equivalentesPortalhttps://entra.microsoft.comValores em mãosAudience URI e ACS URL, copiados da tela do Cange

Não existe "gerar chave" nesse processo. Diferente de OAuth, o SAML não usa client ID e client secret. O Entra ID cria automaticamente um certificado autoassinado quando você configura o SSO, e você baixa apenas a parte pública dele.

Passo 1: crie a aplicação empresarial

  1. Acesse https://entra.microsoft.com e faça login.

  2. No menu lateral, vá em Aplicativos, Aplicativos Empresariais.

  3. Clique em Novo aplicativo.

  4. Clique em Criar seu próprio aplicativo.

  5. Dê o nome Cange.

  6. Selecione a opção Integrar qualquer outro aplicativo que você não encontra na galeria (Non-gallery).

  7. Clique em Criar. A criação leva alguns segundos.

Passo 2: escolha o método SAML

  1. Dentro da aplicação que você acabou de criar, clique em Logon único no menu lateral.

  2. Selecione o bloco SAML.

A tela Configurar Logon Único com SAML abre dividida em blocos numerados. Você vai trabalhar nos blocos 1, 2, 3 e 4.

Passo 3: preencha a configuração básica (bloco 1)

Clique no ícone de lápis em Configuração Básica do SAML e preencha:

Campo no Entra IDO que colarIdentificador (ID da Entidade)O Audience URI (SP Entity ID) copiado do CangeURL de Resposta (URL do Serviço do Consumidor de Asserção)A Single sign on URL (ACS URL) copiada do CangeURL de LogonDeixe em branco, ou informe a URL de acesso do Cange se quiser habilitar login iniciado pelo Entra

Clique em Salvar e feche o painel lateral.

Marque a URL de resposta como padrão se o Entra oferecer essa opção. Confira caractere por caractere: divergência de protocolo, barra final ou subdomínio é a causa mais frequente de falha na integração.

Passo 4: ajuste os atributos e declarações (bloco 2)

Clique no ícone de lápis em Atributos e Declarações. O identificador principal do usuário é a Declaração de nome exclusivo (Name ID). Confirme que o valor de origem é o e-mail corporativo:

  • Origem: Atributo

  • Atributo de origem: user.mail, ou user.userprincipalname se o UPN for o e-mail corporativo da sua organização

  • Formato: Endereço de e-mail ou Persistente

As declarações adicionais padrão, nome, sobrenome e e-mail, já atendem à maioria dos casos. Ajuste apenas se o time do Cange tiver solicitado um atributo específico.

O e-mail enviado nessa declaração precisa ser o mesmo cadastrado no usuário dentro do Cange. Se houver divergência, como apelido de domínio, alias ou e-mail antigo, o login vai falhar mesmo com toda a configuração correta.

Passo 5: baixe o certificado de assinatura (bloco 3)

Localize o bloco Certificado de Assinatura SAML. O Entra ID já gerou um certificado autoassinado, com validade padrão de três anos.

  1. Na linha Certificado (Base64), clique em Baixar.

  2. Salve o arquivo .cer.

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

  4. Copie todo o conteúdo, incluindo -----BEGIN CERTIFICATE----- e -----END CERTIFICATE-----.

Guarde esse conteúdo: ele vai no campo IDP Public Certificate do Cange.

Configure o aviso de expiração (recomendado)

Ainda no bloco do certificado, clique no lápis e preencha o campo Endereço de e-mail de notificação com um e-mail monitorado pela equipe de TI, não a caixa pessoal de um administrador. O Entra envia o aviso com antecedência do vencimento.

Usar um certificado próprio (opcional)

Se a sua política de segurança exigir certificado emitido por uma CA interna, use Adicionar certificado, Importar Certificado no mesmo bloco. Na maioria dos casos o certificado autoassinado do Entra é suficiente.

Passo 6: copie a URL de logon (bloco 4)

No bloco Configurar Cange, copie o valor de URL de Logon. Ela tem este formato:

https://login.microsoftonline.com/{tenant-id}/saml2

Esse é o valor que vai no campo Login URL do Cange. O bloco também exibe o Identificador do Microsoft Entra e a URL de Logoff. Guarde os dois, é útil ter registrado.

Passo 7: atribua usuários e grupos

Este passo é obrigatório. Sem ele, o login falha mesmo com todo o resto correto.

  1. No menu lateral da aplicação, clique em Usuários e grupos.

  2. Clique em Adicionar usuário/grupo.

  3. Selecione os usuários ou grupos que devem ter acesso ao Cange.

  4. Clique em Atribuir.

Para o teste inicial, atribua apenas um usuário piloto. Depois de validar o fluxo completo, troque pelo grupo definitivo.

Passo 8: volte ao Cange e finalize

Com os dois valores em mãos, volte à janela Configurar SAML (Single Sign-On) do Cange:

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.

Campo no CangeValor obtido no Entra IDLogin URLURL de Logon do bloco 4IDP Public CertificateConteúdo do arquivo Base64 do bloco 3

Teste a conexão e clique em Salvar. A configuração está concluída.

Manutenção: rotação do certificado

O certificado do Entra expira em três anos e o SSO para de funcionar na data do vencimento. Planeje a troca com antecedência:

  1. No bloco Certificado de Assinatura SAML, clique em Editar, Nova Certificação.

  2. Defina a data de validade e salve.

  3. Baixe o novo certificado em formato Base64.

  4. Atualize o campo IDP Public Certificate no Cange.

  5. Volte ao Entra e torne o novo certificado ativo.

A ordem importa. Execute os passos 3 e 4 antes de ativar o novo certificado no Entra. Se você ativar primeiro e atualizar o Cange depois, os logins ficam bloqueados no intervalo entre as duas ações.

Erros comuns do Entra ID

Código ou mensagemO que significaComo resolverAADSTS50011, URL de resposta não correspondeA ACS URL cadastrada no Entra difere da configurada no CangeRecopie a Single sign on URL da tela do Cange para o campo URL de RespostaAADSTS700016, aplicativo não encontradoO Identifier está incorreto ou o app foi criado em outro tenantConfira o Audience URI e o tenant em usoAADSTS50105, usuário não atribuídoO usuário não está na lista da aplicaçãoAtribua o usuário ou grupo em Usuários e gruposAADSTS75011, método de autenticação incompatívelConflito com política de acesso condicionalRevise as políticas de acesso condicional aplicadas à aplicaçãoLogin conclui no Entra mas falha no CangeAssinatura inválida ou e-mail divergenteRecopie o certificado e confira o Name ID enviado

Checklist final

  • Aplicação empresarial criada no Entra ID

  • Identifier preenchido com o Audience URI do Cange

  • URL de Resposta preenchida com a ACS URL do Cange

  • Name ID mapeado para o e-mail corporativo

  • Certificado Base64 baixado e colado no Cange

  • E-mail de notificação de expiração cadastrado

  • URL de Logon copiada para o campo Login URL do Cange

  • Usuários ou grupos atribuídos à aplicação

  • Conexão testada e configuração salva no Cange

Próximos passos

Este artigo foi útil?