Versão: 0.1
Data: 23/07/2025
Autor: Gusthavo Nóbrega Furuhashi
Documentos relacionados:
1. Objetivo
Este tutorial tem como objetivo mostrar o passo a passo da configuração do Google Workspace para utilizar o SSO da Mambo WiFi.
2. Pré-requisitos
Conhecimentos: Familiaridade com o Painel Administrativo Mambo.Para integrar e configurar o Google Workspace, é necessário possuir conhecimento técnico ou contar com uma equipe especializada. A instalação e manutenção são de responsabilidade do cliente, no entanto, a Mambo WiFi está disponível para auxiliar com dúvidas ou problemas que possam surgir após a integração.
Ferramentas/Softwares: Painel Administrativo Mambo.
Acessos/Permissões: Será necessário ter acesso Administrador ao Painel Administrativo Mambo, Conta do Google Cloud e Workspace.
3. Links Úteis
Ativação de um Painel Administrativo Mambo: https://mambowifi.com/contato/
4. Procedimento
4.1. Configuração
Encontre a aba "APIs & Serviços" e clique sobre ela.
Vá até as opções "Credenciais".
Clique em "+ CRIAR CREDENCIAIS" e selecione a opção "ID do cliente OAuth".
Clique em "Configure consent screen".
Selecione a opção "Interno" e clique em "Criar".
Preencha as informações da seguinte forma:
Nome do app: <Digite o nome de sua empresa>
E-mail para suporte: Selecione o e-mail que você está logado no admin.
Pagina inicial do aplicativo: https://mambowifi.com
Link da Politica de Privacidade do aplicativo: https://mambowifi.com
Link dos Termos de Serviço do aplicativo: https://mambowifi.com
Domínios autorizados: mambowifi.com
Após preencher todas as informações clique em "Salvar e continuar".
Em "Escopos e Teste" clique em "Salvar e continuar".
Em Summary vá até o final da página e clique em "Back to dashboard".
Vá até a aba "Credenciais" novamente e clique na opção "+ CRIAR CREDENCIAIS" e selecione a opção "ID do cliente OAuth".
Em “tipo de aplicativo” selecione a opção "Aplicativo da Web" e preencha as informações da seguinte forma:
Nome: <Nome da sua empresa>
Origens JavaScript - URL 1: https://mambowifi.com
Origens JavaScript - URL 2: https://dominio.mambowifi.com
Em “URLs de redirecionamento” deixaremos em branco para preencher posteriormente.
Você verá que foi adicionado um novo ID do cliente OAuth 2.0.
Clique em cima para acessá-lo e pegar as credenciais.
Acessando seu app, você terá uma aba de “Additional Information” que vai conter o ID do cliente e abaixo é preciso gerar as “Chaves secretas do cliente”.
Na sequência vamos utilizar o campo “ID do cliente” e “chave secreta”.
Agora vamos criar a integração SSO no painel da Mambo. Acesse o painel administrativo da sua conta Mambo e navegue até o “Integração > Gerenciamento de SSO”.
Clique no botão ‘Cadastrar’.
Selecione a opção Google Workspace ou Education e preencha todas as informações abaixo:
Nome da Conexão: <nome para identificação>
Texto do botão que aparecerá no captive (nos 03 idiomas)
Informações de Authorization Server (não é necessário alterar)
Client ID: <Preencher com os dados do passo 14>
Client secret: <Preencher com os dados do passo 14>
Campo identificador: <email>
Resource: <openid>
Escopo: <email>
Completar cadastro após login? <Não>
Protocolo Open ID Connect (OIDC) <Sim>
Após preencher todos os campos, copie a “URL de callback” conforme indicação abaixo e clique em SALVAR, Sua integração será CRIADA e aparecerá na listagem.
Retornando ao console da Google, acesse "credenciais" e clique em cima do seu APP.
Em “URLs de redirecionamento” adicione a URL de Callback que você copiou no passo a passo acima (passo 18) e clique em ‘SALVAR’.
5.Validação
5.1. Acessando o Portal
Pronto! Para testar o recurso, acesse a sua rede WiFi, clique no botão da integração e faça a autenticação pelo Google.
Se houver alguma dúvida ou dificuldade, você pode entrar em contato com nosso suporte através do e-mail suporte@mambowifi.com informando sua dificuldade, número de telefone para contato e URL do painel administrativo.