Base de Conhecimento

Voltar ao Winconnection

Como faço para configurar a autenticação tipo OAuth2, no Google Workspace, para servidor de e-mails do Winconnection ?

Data de criação: 30/08/2024

Última alteração: 21/10/2024

O Winconnection X versão 66-3 ou superior suporta autenticação tipo OAuth2 do Google Workspace para o envio de e-mails via Servidor SMTP e recebimento via Mapeador POP.

De forma diversa a outros tipos de autenticação, o OAuth2 requer que as credenciais dos usuários sejam confirmadas remotamente pelo próprio usuário via Web, no site de autenticação do Google Workspace, através de uma aplicação (app) criada somente para isto.

Os passos para se autenticar usando o OAuth são os seguintes:

  • Ter uma conta Google Workspace com Domínio Próprio;
  • Criar um APP de autenticação nesta conta;
  • Configurar o Mapeador POP para aceitar o OAuth;
  • Autorizar cada usuário nesta autenticação OAuth.

Como este procedimento depende de várias configurações em diferentes lugares, vamos explicar passo a passo cada etapa de configuração.

Criando um APP na conta Google Workspace

Acesse o Console do Google Cloud:

  1. Logado em uma conta com poderes de administrador, vá para o Google Cloud Console e faça login com sua conta Google Workspace.

  2. Crie um Novo Projeto:
    • Clique no menu suspenso no canto superior esquerdo (ao lado do nome do projeto atual) e selecione "Novo Projeto".
    • Insira um nome para o seu projeto - por exemplo Winco Firewall 65 Beta - e selecione a organização apropriada.
    • Clique em "Criar" e aguarde uns 2 minutos para a criação do projeto. Abaixo uma tela de como criar o projeto para a sua empresa.

Habilitar APIs necessárias 

 

a) No menu de acesso rápido, clique em "APIs e Serviços":

b) Configure a Tela de permissão OAuth, que é feita como do tipo INTERNO para uso somente da sua conta conforme a tela abaixo e clique em Create - ou Criar se estiver em português:

c) Na próxima tela, complete as informações necessárias como "Nome do app", "E-mail para suporte do usuário" e o endereço de e-mail do responsável em "Dados de contato do desenvolvedor".

Para finalizar a alteração, clique no botão "Salvar e Continuar”.

Criar credenciais:

 

a) Vá para "APIs e Serviços" > "Credenciais".

b) Clique em "+ Criar Credenciais" e selecione "ID do Cliente OAuth".

c) Em "Tipo de aplicativo" selecione "Aplicativo da Web" ou outro tipo de aplicativo conforme o caso.

d) Coloque o nome do aplicativo - WinconnectionX

e) Em "URLs de redirecionamento autorizados", clique no botão "+ Adicionar URL" e insira a URL abaixo: 

https://auth.winco.com.br/v5/auth-proxy.php

f) Clique em "Criar". Veja abaixo as configurações necessárias nesta tela:

g) Anote as Credenciais: Salve o ID do Cliente, a Chave secreta do cliente em um local seguro e clique no botão Download JSON conforme indicado abaixo. Você precisará desses dados para autenticação.

Configurando no Winconnection X

 

Através do serviço Mapeador POP, você deverá fazer o upload do arquivo .JSON para realizar a conexão OAuth2 com Google Workspace.

  • No painel de administrador do Winconnection, clique em Serviços > E-mail > Mapeador POP;
  • Clique na guia “Avançado”;
  • Em “APP credentials (json)” clique em “Escolher arquivo”, localize o arquivo .JSON que foi baixado no computador e em seguida clique em “Upload”. Ao final, clique em “Salvar”;

  • Se estiver tudo ok, o “Status” irá exibir “O Auth2 já está configurado”.

Adicione e configure as contas de e-mails dos usuários através do Mapeador POP. É muito importante que verifique as configurações como: endereço do servidor POP e a porta de comunicação.

Em cada conta Google cadastrada, não será necessário digitar a senha da conta de e-mail. Portanto, você deve marcar a opção "Usar OAUTH2" e clicar em “Salvar”:

Após esta configuração, é necessário autorizar a autenticação de cada usuário. Para isso, o usuário deve acessar através do seu próprio computador o CPanel (Painel de Controle do usuário) do Winconnection como por exemplo:

http://192.168.0.1/cpanel

OBS.: O IP deve ser do servidor do Winconnection seguido da porta padrão do Servidor WWW. 

Para que o usuário consiga realizar o login, o mesmo deve informar as suas credenciais de acordo com o cadastro da base local de usuários do Winconnection X.

Após realizar o login, ir até a aba "Autenticar no Gmail" e clicar no botão em verde "Autenticar no Gmail".

O usuário será redirecionado a página do Google para selecionar a conta de e-mail e permitir que seja feita esta sincronização. 

Caso esteja tudo certo, no Painel de controle de usuário (CPanel) será exibida a mensagem "Autenticação realizada com sucesso!".

A partir deste momento, as contas de e-mails estão sincronizadas entre Winconnection X e Google Workspace.

Top