Pular para o conteúdo
Central de Ajuda Clevera

Configurar SSO com o Google Workspace

Configuração passo a passo do Google Workspace para o logon único (SSO) do Clevera: um cliente OAuth interno para OpenID Connect ou um aplicativo SAML personalizado no console do Google Admin, com os valores que devem ser inseridos em cada campo do Clevera.

Atualizado 6 min de leitura

Configure o logon único entre o Google Workspace e o Clevera para que sua equipe acesse usando a conta de trabalho do Google. Você pode conectar via OpenID Connect (OIDC) por meio de um cliente OAuth do Google Cloud ou via SAML 2.0 por meio de um aplicativo SAML personalizado no console do Google Admin.

Os consoles do Google mudam ocasionalmente. Se um rótulo abaixo não corresponder, procure a configuração com o mesmo significado e use os guias gerais para a lista completa de valores: SAML, OIDC.

Antes de começar

  • Você é o Proprietário de um workspace do Clevera em um Plano personalizado.
  • Para OIDC: você pode criar clientes OAuth em um projeto do Google Cloud que pertença à sua organização do Google Workspace.
  • Para SAML: você é um super administrador do Google Workspace.
  • Você conhece seus domínios do Google Workspace, como acme.example, incluindo domínios secundários.

Abra a caixa de diálogo de configuração do Clevera primeiro: abra o menu do workspace na parte superior da barra lateral, escolha Configurações da equipe, depois Segurança e clique em Configurar SSO. Escolha Google Workspace como o Provedor de identidade.

Etapa 1 da caixa de diálogo de configuração de SSO com Google Workspace e SAML 2.0 selecionados e os valores para copiar
Com SAML 2.0, copie estes valores para o console do Google Admin.

Conectar com OpenID Connect

  1. Definir o aplicativo como interno

    No console do Google Cloud, escolha um projeto na sua organização e abra a Plataforma de autenticação do Google (em consoles mais antigos, APIs e serviços → Tela de consentimento OAuth). Defina o Público-alvo (tipo de usuário) como Interno, para que apenas contas no seu Google Workspace possam fazer login. Preencha o nome do aplicativo (Clevera) e o e-mail de suporte.

  2. Criar o cliente OAuth

    Na caixa de diálogo de configuração do Clevera, defina o Protocolo como OpenID Connect e copie o URI de redirecionamento (URL de retorno de chamada) da caixa cinza. Em seguida, no Google, abra Clientes (ou APIs e serviços → Credenciais) e crie um ID do cliente OAuth:

    Campo do Google Valor
    Tipo de aplicativo Aplicativo da Web
    Nome Clevera
    URIs de redirecionamento autorizados O URI de redirecionamento (URL de retorno de chamada): https://app.clevera.ai/sso/oidc/callback

    Clique em Criar e copie o ID do cliente e o Segredo do cliente.

  3. Preencher no Clevera

    No Clevera, clique em Continuar e insira:

    Campo do Clevera Valor
    ID do cliente ID do cliente do Google
    Segredo do cliente Segredo do cliente do Google
    URL de descoberta https://accounts.google.com/.well-known/openid-configuration

O Google envia as declarações email e name para os escopos openid email profile que o Clevera solicita, portanto, não há mais nada para mapear.

Conectar com SAML 2.0

  1. Adicionar um aplicativo SAML personalizado

    No console do Google Admin, vá para Apps → Apps da Web e para dispositivos móveis, clique em Adicionar app e escolha Adicionar app SAML personalizado. Dê o nome de Clevera e clique em Continuar.

  2. Copiar os valores do Google para o Clevera

    Em Detalhes do provedor de identidade do Google, copie os valores para o Clevera (defina o Protocolo como SAML 2.0 e clique em Continuar primeiro):

    Valor do Google Campo do Clevera
    ID da entidade ID da entidade do IdP
    URL de SSO URL de login de SSO
    Certificado Certificado X.509

    Clique em Continuar no Google.

  3. Inserir os valores do Clevera

    Em Detalhes do provedor de serviço:

    Campo do Google Valor
    URL do ACS https://app.clevera.ai/sso/saml/callback
    ID da entidade ID da entidade / URI do público-alvo da caixa de diálogo do Clevera
    URL de início Deixe vazio
    Resposta assinada Marcado
    Formato do ID do nome E-MAIL
    ID do nome Informações básicas → E-mail principal

    Clique em Continuar.

  4. Mapear os nomes

    Em Mapeamento de atributos, mapeie Nome para firstName e Sobrenome para lastName. Clique em Concluir.

  5. Ativar o aplicativo

    Abra o Acesso do usuário do aplicativo, escolha ATIVADO para todos (ou para as unidades organizacionais ou grupos que devem usar o Clevera) e clique em Salvar. O Google informa que pode levar algum tempo para ser aplicado.

Finalizar no Clevera

  1. Em Domínios e funções, adicione todos os domínios do Google Workspace que sua equipe usa. Escolha Criar contas no primeiro login e a Função padrão para novos membros de SSO.
  2. Em Revisar, clique em Salvar configuração.
  3. Clique em Executar teste, ative Habilitar SSO e faça login como um usuário de teste em uma janela privada, começando pela página de login do Clevera.
  4. Quando funcionar para todos, ative Exigir SSO se quiser que o SSO seja a única forma de acesso. Isso também desativa o Continuar com o Google para esses membros.

Os membros digitam seu e-mail de trabalho na página de login do Clevera e clicam em Continuar com o Google Workspace.

Solução de problemas

Problema O que verificar
O Google mostra "Erro 400: redirect_uri_mismatch" Os URIs de redirecionamento autorizados devem ser exatamente o URI de redirecionamento (URL de retorno de chamada) do Clevera, https://app.clevera.ai/sso/oidc/callback.
O Google diz que o aplicativo está restrito a usuários da organização A pessoa não está logada com uma conta do seu Workspace.
"Falha na autenticação de SSO..." após o login do Google, com SAML Resposta assinada está marcada; o certificado no Clevera corresponde ao certificado atual do aplicativo; o ID da entidade corresponde exatamente ao do Clevera. Se ainda falhar, conecte via OIDC.
"Sessão de SSO expirada. Tente novamente." após abrir o Clevera pelo menu de aplicativos do Google Esperado: o login deve começar na página de login do Clevera.
O Google diz que o aplicativo não está configurado para o usuário (SAML) Ative o aplicativo para a unidade organizacional ou grupo deles em Acesso do usuário.
"Seu domínio de e-mail não está autorizado para o SSO desta equipe." Adicione o domínio deles, incluindo domínios secundários, em Domínios de e-mail permitidos.

Mais mensagens: Corrigir problemas de login com SSO.