Como configurar a autenticação do Google no controlador Omada local

Knowledgebase
Configuration Guide
02-26-2025
24888

Conteúdo

Objetivo

Requisitos

Introdução

Pré-requisitos

Configuração

Configurando a API Google OAuth

Configurando a autenticação do Google no Controller

Conclusão

Objetivo

Este artigo demonstra como configurar a Autenticação do Google no Controller Local, incluindo a configuração passo a passo da API Google Cloud OAuth e a integração para autenticação do Google.

Requisitos

  • Omada Software Controller

  • API Google OAuth

Introdução

A autenticação Omada Google Portal integra a API Google OAuth ao Portal do sistema de gerenciamento de rede Omada, permitindo que os usuários concluam serviços de autenticação de rede de forma conveniente e segura usando suas contas do Google.

Pré-requisitos

  • O recurso de autenticação do Google é baseado na API Google OAuth. Para atender aos requisitos da API Google OAuth, ao usar a autenticação do Google no Controller Local, você precisa ter um nome de domínio e um certificado confiável para esse domínio. Além disso, certifique-se de que a configuração de DNS possa resolver as solicitações dos clientes web para esse domínio ao endereço IP do Controller Local. Para requisitos específicos do nome de domínio, consulte a documentação do Google: https://developers.google.cn/identity/protocols/oauth2/web-server#uri-validation

Configuração

Configurando a API Google OAuth

A autenticação do Google requer uma API Google OAuth. Se você não criou uma, siga os passos abaixo para criar e configurar uma.

Passo 1. Por favor, visite https://console.cloud.google.com/ para criar um projeto para sua autenticação do Google.

Crie um novo projeto no Google Cloud. Passo 2. Após concluir a criação do projeto, acesse a seção APIs & Services através do acesso rápido ou da barra lateral.

Acesse API & Services através da barra lateral esquerda ou acesso rápido.

Passo 3. Entre e configure a tela de consentimento OAuth.

Configure a tela de consentimento OAuth

Clique em GET STARTED.

Uma imagem indicando a posição do botão "Get Started"

Por favor, preencha os campos obrigatórios: Nome do aplicativo, E-mail de suporte ao usuário e clique em NEXT.

Insira o Nome do aplicativo e o E-mail de suporte ao usuário da tela de consentimento OAuth

Selecione o tipo de público como Externo e clique em Next.

Selecione o tipo de público como Externo

Complete as informações de contato e clique em NEXT.

Insira o endereço de e-mail de contato do desenvolvedor da tela de consentimento OAuth

Selecione Concordo com a Política de Dados do Usuário dos Serviços de API do Google e clique em CREATE.

Selecione Concordo com a Política de Dados do Usuário dos Serviços de API do Google e clique em CREATE

Passo 4. Vá para a página de Acesso a Dados e clique em ADD OR REMOVE SCOPES.

Adicionar Escopos

Escopo refere-se à extensão das informações e operações da conta que os usuários autorizam o Controller a acessar. Os escopos que precisam ser adicionados são openid e user info.email. Esses dois escopos são não sensíveis e são usados pela autenticação do Google para consultar o identificador único e o e-mail do usuário no Google. O Controller não reterá as informações pessoais do usuário acima. Depois disso, clique em UPDATE para salvar as configurações (na parte inferior da página).

Selecione escopos

Atualizar escopos

Após atualizar os escopos, não se esqueça de salvar as configurações.

Salvar configurações

Passo 5. Crie um ID de cliente OAuth. Na barra lateral, selecione APIs & Services > Credentials, e então escolha OAuth client ID ao criar credenciais.

Criar ID de cliente OAuth

Selecione o tipo de aplicativo como Web application.

Selecione o tipo de aplicativo do ID de cliente OAuth como Aplicação Web

Preencha o Nome e, no campo "Authorized redirect URIs", insira o seguinte URI: https://{Seu nome de domínio}:8843/portal/sociallogin/auth. O cliente web usará este URI para redirecionar de volta ao Controller após concluir o login no Google para finalizar o processo de autenticação subsequente.

Insira o nome do ID do cliente e os URIs de redirecionamento autorizados

Após clicar em Create, o ID do Cliente e o Segredo do Cliente serão exibidos em uma janela pop-up.

Informações do cliente OAuth

Você também pode visualizá-los posteriormente clicando na entrada correspondente na lista de clientes. O ID do Cliente e o Segredo do Cliente são as credenciais da sua API Google OAuth recém-criada. O Controller os usará para realizar a autenticação do Google com sua API.

Página de detalhes do ID e Segredo do Cliente

Passo 7. Vá para OAuth consent screen > Audience e clique em PUBLISH APP.

Publicar Aplicativo

Configurando a autenticação do Google no Controller

Passo 1. Selecione Google na caixa de seleção do tipo de autenticação na página de configurações do Portal. Então, na seção de configurações de autenticação do Google abaixo, preencha o Client ID e o Client Secret da sua API Google OAuth.

Configure a autenticação do Google no Controller

Passo 2. Configure o Certificado HTTPS. Você pode configurar o certificado HTTPS seguindo o link: Como Configurar Certificado HTTPS para Evitar Erro de "Certificado Não Confiável" - Comunidade de Negócios.

Passo 3. Teste de login e adição de endereços isentos de autenticação. Após concluir a configuração da autenticação do Google, use um dispositivo terminal para acessar a página do Portal e testar se o processo de autenticação funciona.

Os endereços de login do Google variam por país e região. Durante o teste de login, você pode enfrentar problemas de acesso. Se isso acontecer, observe os endereços inacessíveis através da barra de endereço do navegador ou das ferramentas de desenvolvedor F12 e adicione-os à lista de isenção.

Adicione um endereço pré-autenticado

Após adicionar o endereço para isenção de autenticação, realize novamente um teste de login para verificar se o processo de login pode prosseguir normalmente.

Conclusão

Acima está toda a introdução e configurações da Autenticação do Google; configure-as de acordo com suas necessidades.

Para obter mais detalhes sobre cada função e configuração, acesse Central de Downloads para baixar o manual do seu produto.

Por favor, avalie este documento

Documentos relacionados