Configurar o login com Google (SSO)
Caminho: Opa! Store → Google → Instalar
Visão geral
O app Google permite que os usuários entrem no Opa! Suite com a conta Google da empresa, sem digitar a senha do Opa! Suite. Esse tipo de acesso é chamado de login único, ou SSO (Single Sign-On). Assim, o acesso fica centralizado nas contas Google que a empresa já administra.
O Opa! Suite identifica o usuário pelo e-mail: o e-mail da conta Google precisa ser o mesmo e-mail cadastrado para o usuário no Opa! Suite.
Pré-requisitos
- Permissão para visualizar o Opa! Store no seu grupo de permissões.
- Acesso ao Google Cloud console para criar um cliente OAuth.
- Usuários cadastrados e ativos no Opa! Suite, com o mesmo e-mail das contas Google. O login com Google não cria usuários.
- Nenhum outro app de SSO instalado. O Opa! Suite aceita um app de SSO por vez.
Passo a passo
1. Criar o cliente OAuth no Google Cloud
- No Google Cloud console, abra a página Clients do Google Auth Platform. Se o projeto ainda não estiver registrado no Google Auth Platform, o Google pede esse registro antes de criar o cliente.
- Clique em Create client e escolha o tipo Web application.
- Em Authorized redirect URIs, adicione o endereço abaixo, trocando pelo endereço do seu Opa! Suite:
https://endereco-do-seu-opa-suite/auth/login/sso/callback/google - Clique em Create.
- Copie o Client ID e o Client secret. O Google só mostra o segredo completo no momento da criação.
As instruções completas estão na ajuda do Google Cloud sobre clientes OAuth.
2. Instalar o app no Opa! Suite
- Acesse Opa! Store e abra o app Google, na categoria SSO.
- Clique em Instalar. A janela Instalar Google abre.
- Preencha os campos:
- ID do cliente: o Client ID copiado do Google Cloud.
- Chave secreta do cliente: o Client secret.
- Clique em Instalar.
Resultado esperado
O app aparece como instalado e o Opa! Suite abre a tela de ajustes, com a seção Dados de integração.
Na tela de login do Opa! Suite passa a aparecer, abaixo de Entrar, o texto ou entre com e o botão Google. Ao clicar, o usuário é levado para o login do Google e, depois de autenticado, volta ao Opa! Suite já conectado.
O login com Google segue as mesmas regras de segurança do login comum:
- Se o usuário tiver autenticação em dois fatores configurada, o código é pedido depois do login no Google.
- O limite de usuários conectados ao mesmo tempo continua valendo.
- Se houver restrição de acesso por IP, ela também vale para o login com Google.
Configurações disponíveis
Para alterar, acesse Opa! Store → Google → Acessar e edite Dados de integração.
| Campo | O que faz |
|---|---|
| Client ID | Identificador do cliente OAuth criado no Google Cloud. |
| Client Secret | Chave secreta do cliente. Aparece mascarada. |
Para remover o login com Google, clique em Desinstalar App e confirme em Desinstalar.
Problemas comuns
| Sintoma ou mensagem | O que verificar |
|---|---|
| "Seu usuário não foi encontrado. Entre em contato com um administrador do sistema." | Não existe usuário ativo no Opa! Suite com o mesmo e-mail da conta Google. Confira o e-mail em Usuários. |
| "Houve um erro ao coletar os dados do seu usuário. Tente novamente mais tarde." | O Google recusou a troca de dados. Confira o ID do cliente e a Chave secreta do cliente. |
| O Google mostra erro de URI de redirecionamento | A URI cadastrada no Google Cloud precisa ser exatamente igual à do Opa! Suite, incluindo https e sem barra no final (documentação do Google). |
| "Quantidade de usuários ultrapassou o limite contratado!" | O limite de usuários conectados ao mesmo tempo foi atingido. |
| "Seu IP não está liberado para efetuar login na plataforma. Por favor, verifique e tente novamente." | O IP de acesso não está liberado nas restrições de acesso do Opa! Suite. |
| A página do app mostra "Um app desta categoria já está instalado" | Já existe outro app de SSO instalado. Desinstale-o antes de instalar o Google. |
Boas práticas
- Antes de divulgar o login com Google, confira se o e-mail de cada usuário no Opa! Suite é o mesmo da conta Google.
- Guarde o Client secret em local seguro, porque o Google não mostra o valor completo de novo.
- Mantenha a autenticação em dois fatores ativa para os usuários com acesso administrativo.