Como configurar o Google Workspace para o SSO do Cange
Este guia é a contraparte de Como configurar SAML (Single Sign-On) no Cange, para empresas que usam o Google Workspace como provedor de identidade. Aqui você cria um app SAML personalizado no Google Admin Console e obtém os valores que o Cange precisa: a URL do SSO, o certificado público e o ID da entidade do Google.
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
RequisitoDetalheConta GoogleGoogle Workspace ou Cloud Identity com permissão para criar apps SAML personalizadosPermissãoSuperadministrador do Google Workspace, ou função de administrador com o privilégio de gerenciar apps SAMLPortalhttps://admin.google.comValores em mãosAudience URI e ACS URL, copiados da tela do CangeUsuários no CangeCada pessoa que vai entrar por SSO já precisa estar cadastrada no Cange com o mesmo e-mail da conta Google. O SSO não cria usuários automaticamente.
Não existe "gerar chave" nesse processo. O SAML não usa client ID e client secret, e não é a mesma coisa que o botão "Fazer login com o Google". O Google cria automaticamente um certificado para o app, e você baixa apenas a parte pública dele.
Os nomes dos menus abaixo seguem o Admin Console em português. Se o seu console estiver em inglês, os equivalentes são: Apps, Web and mobile apps, Add app, Add custom SAML app.
Passo 1: crie o app SAML personalizado
Acesse
https://admin.google.comcom uma conta de administrador.No menu lateral, vá em Apps, Apps da Web e para dispositivos móveis.
Clique em Adicionar app, Adicionar app SAML personalizado.
Em Nome do app, informe Cange. Descrição e ícone são opcionais.
Clique em Continuar.
Passo 2: copie os dados do provedor de identidade do Google
A tela seguinte, Detalhes do provedor de identidade do Google, traz os três valores que o Cange precisa. Copie todos antes de clicar em Continuar.
Valor no GoogleFormatoPara onde vaiURL do SSOhttps://accounts.google.com/o/saml2/idp?idpid=XXXXXXXXCampo Login URL do CangeID da entidadehttps://accounts.google.com/o/saml2?idpid=XXXXXXXXEnviado ao time do Cange, veja o passo 7CertificadoArquivo .pemCampo IDP Public Certificate do Cange
Para o certificado:
Na linha Certificado, clique em Fazer o download do certificado.
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
-----BEGIN CERTIFICATE-----e-----END CERTIFICATE-----.
Se preferir, use Fazer o download dos metadados: o arquivo XML traz os três valores juntos e serve como registro da configuração.
A URL do SSO e o ID da entidade são parecidos, mas não são iguais. O primeiro termina em
/saml2/idp?idpid=e o segundo em/saml2?idpid=. Trocar um pelo outro é um erro comum. Confira antes de colar.
Clique em Continuar.
Passo 3: preencha os detalhes do provedor de serviços
Na tela Detalhes do provedor de serviços, preencha com os valores copiados do Cange:
Campo no GoogleO que colarURL do ACSA Single sign on URL (ACS URL) copiada do CangeID da entidadeO Audience URI (SP Entity ID) copiado do CangeURL inicialDeixe em brancoResposta assinadaDeixe desmarcado
Deixe Resposta assinada desmarcado. Com essa opção marcada, o login falha na validação.
Ainda nessa tela, na seção ID do nome:
Formato do ID do nome: EMAIL
ID do nome: Informações básicas, E-mail principal
O e-mail principal enviado pelo Google precisa ser o mesmo cadastrado no usuário dentro do Cange. Se houver divergência, como alias de e-mail, domínio secundário ou e-mail antigo, o login falha mesmo com toda a configuração correta.
Clique em Continuar.
Passo 4: mapeie os atributos (recomendado)
Na tela Mapeamento de atributos, clique em Adicionar mapeamento e crie as três linhas abaixo. O nome do atributo do app precisa ser digitado exatamente como está na tabela, em minúsculas.
Atributos do Google DirectoryAtributos do appInformações básicas, E-mail principalemailInformações básicas, Nomegiven_nameInformações básicas, Sobrenomefamily_name
O e-mail já vai no ID do nome, então este passo não é obrigatório para o login funcionar. Ele deixa a integração explícita e evita ambiguidade se o formato do ID do nome for alterado no futuro.
Clique em Concluir.
Passo 5: ative o app para os usuários
Este passo é obrigatório. Todo app SAML personalizado nasce desativado para todos os usuários. Sem ativar, o Google bloqueia o login com o erro app_not_configured_for_user.
Na página do app Cange, clique em Acesso do usuário.
Para o teste inicial, selecione na lateral a unidade organizacional ou o grupo do usuário piloto.
Marque ATIVADO e clique em Salvar.
A ativação pode levar alguns minutos para valer e, em casos raros, até 24 horas. Se o primeiro teste falhar com
app_not_configured_for_userlogo depois de ativar, aguarde e tente de novo antes de mudar a configuração.
Depois de validar o fluxo completo com o piloto, ative para a unidade organizacional ou grupo definitivo, ou para todos.
Passo 6: volte ao Cange e preencha a configuração
Com os valores em mãos, volte à janela Configurar SAML (Single Sign-On) do Cange:
Campo no CangeValor obtido no GoogleLogin URLURL do SSO do passo 2IDP Public CertificateConteúdo do arquivo de certificado do passo 2
Clique em Salvar.
Passo 7: envie o ID da entidade ao suporte do Cange
Este passo é obrigatório e precisa ser feito antes de ativar o SSO. Envie ao suporte do Cange:
o nome da sua empresa no Cange;
o ID da entidade copiado no passo 2 (
https://accounts.google.com/o/saml2?idpid=XXXXXXXX).
O suporte confirma o cadastro para você. Só siga para o próximo passo depois dessa confirmação.
Sem esse envio, o login é concluído no Google, mas o usuário volta para a tela de login do Cange sem entrar.
Passo 8: ative o SSO e teste com o usuário piloto
No Cange, com MFA Obrigatória em Ativo e Método Padrão em SAML, clique em Salvar MFA. É nesse momento que o login por SSO passa a valer para a conta.
Mantenha a sua sessão de administrador aberta nesta janela.
Em uma janela anônima, acesse
https://app.cange.mee entre com o e-mail do usuário piloto.O Cange redireciona para o Google. Depois do login no Google, o usuário volta ao Cange já autenticado.
Se o teste falhar, não feche a sessão de administrador. Use essa sessão para voltar o Método Padrão e corrigir a configuração.
O que muda depois de ativar
Ao acessar o Cange, os usuários são redirecionados para a tela de login do Google.
Quem já está com a conta Google aberta no navegador entra direto, sem digitar credenciais.
As políticas de senha, verificação em duas etapas e acesso passam a ser as do seu Google Workspace.
Suspender a conta de um colaborador no Google bloqueia o acesso dele ao Cange.
O login deve sempre começar pelo Cange, em
https://app.cange.me. Abrir o Cange pelo ícone no menu de apps do Google não é suportado e termina em erro.
Manutenção: rotação do certificado
O certificado SAML do Google vale cinco anos, e o SSO para de funcionar na data do vencimento. A validade aparece em Segurança, Autenticação, SSO com apps SAML. Planeje a troca com antecedência:
Em Segurança, Autenticação, SSO com apps SAML, clique em Adicionar certificado.
Faça o download do novo certificado.
Atualize o campo IDP Public Certificate no Cange.
Abra o app Cange no Admin Console, edite os Detalhes do provedor de identidade do Google e selecione o novo certificado.
A ordem importa. Execute os passos 2 e 3 antes de trocar o certificado do app no Google. Se você trocar primeiro e atualizar o Cange depois, os logins ficam bloqueados no intervalo entre as duas ações. A troca de certificado não muda o ID da entidade, então não é preciso acionar o suporte do Cange.
Erros comuns do Google Workspace
Código ou mensagemO que significaComo resolverapp_not_configured_for_userO app está desativado para a unidade organizacional ou grupo do usuárioAtive o app em Acesso do usuário e aguarde a propagaçãoapp_not_configuredO ID da entidade enviado pelo Cange não corresponde a nenhum appRecopie o Audience URI do Cange para o campo ID da entidade do appErro 400 sobre a URL do ACSA URL do ACS cadastrada no Google difere da configurada no CangeRecopie a Single sign on URL do Cange, sem barra no finalLogin conclui no Google mas volta ao Cange sem entrarCertificado divergente, "Resposta assinada" marcado ou ID da entidade não enviado ao suporteRecopie o certificado, desmarque "Resposta assinada" e confirme o passo 7 com o suporteO Cange informa que o usuário não foi encontradoO e-mail enviado pelo Google não existe no CangeCadastre o usuário no Cange com o e-mail principal da conta GoogleFuncionava e parou de repenteCertificado expiradoSiga a seção de rotação do certificado
Checklist final
App SAML personalizado "Cange" criado no Admin Console
URL do SSO, ID da entidade e certificado do Google copiados
URL do ACS preenchida com a ACS URL do Cange
ID da entidade do app preenchido com o Audience URI do Cange
"Resposta assinada" desmarcado
ID do nome no formato EMAIL, mapeado para o e-mail principal
Atributos
email,given_nameefamily_namemapeadosApp ativado para o usuário piloto
Login URL e certificado colados no Cange e salvos
ID da entidade do Google enviado e confirmado pelo suporte do Cange
Usuários cadastrados no Cange com o mesmo e-mail da conta Google
Login testado com o usuário piloto em janela anônima
Lembrete de vencimento do certificado cadastrado
Próximos passos
Este artigo foi útil?