Neste documento, você será instruído a ter acesso as credenciais de autenticação para os provedores, Gmail e Hotmail, permitindo que realize o cadastro de E-mails em nosso produto, utilizando o modelo de autenticação OAuth 2.0.

 

* Autenticação com Gmail

* Autenticação com Hotmail 

 

Autenticação com Gmail

Para iniciarmos a criação dos tokens referente ao Google, precisamos acessar o Google Cloud; 

Inicialmente, caso apareça a tela referente aos termos, aceite e prossiga. 

Passo 1. - Criar projeto

Assim que acessar o ambiente, localize o botão CRIAR PROJETO

Na etapa de configurações, siga o modelo de preenchimento na imagem abaixo.

Após a criação do seu projeto precisamos habilitar a API do Gmail, para isso, localize o botão Biblioteca >  "Ativar APIs e serviços"

 

Logo após, localize a opção Gmail API

 

Passo 2. - Criando as credenciais

Para que possamos criar as credenciais de autenticação, será necessário criar uma tela de consentimentos, para isso, siga os passos abaixo;

Defina o User Type como externo, siga com a confirmação sem alterar os dados padrões, até que seja visualizado o botão Voltar ao Painel. Publique o aplicativo, seguindo as opções: Status de publicação > Publicar Aplicativo > confirmar

Após criar a tela de autorizações, vá até a opção Credenciais > Criar Credenciais, selecione o tipo ID do cliente OAuth. Assim que que abrir o modal, selecione o tipo de aplicativo "Aplicativo da Web"e um nome de sua preferencia

Na opção, URIs de redirecionamento autorizados, adicione a seguinte URL

 https://plugboleto.com.br/api/v1/email/callback

 

Assim que finalizar, será retornado as seguintes credenciais, ClienteID e Chave secreta do cliente, que deve ser cadastrado em nosso ambiente de e-mail no seguintes campos.

Usuario = ClienteID

Senha = Chave secreta do cliente

Caso perca os dados, não se preocupe, apenas acesse a credencial criada, e lá estará seus dados

 

Agora que possuí todos os dados necessários, você pode seguir com nosso próximo passo: Cadastrar um Email.

 

 

Autenticação com Hotmail

Será necessário possuir uma conta corporativa com um plano contratado, isso ira permitir realizar os envios de e-mail via SMTP.

Para iniciarmos a criação das credenciais referente ao Hotmail / Outlook, precisamos cadastrar uma aplicação no portal Azure da microsoft, portanto, acesse o link para que possamos seguir.

 

No menu a esquerda, localize a opção Microsoft Entra ID.

Neste momento, iremos criar nossa aplicação, para isso, no menu lateral, identifique a opção Registro de aplicativos, assim que acessar, selecione o botão Novo Registro.

 

Na tela de configurações, siga os passos abaixo 

Assim que for finalizado, teremos acesso a algumas chaves importantes, Client ID e Tenant ID ( ID do locatário ).Guarde estas informações, pois será uns dos dados necessários para realizar o cadastro de E-mail em nossa aplicação.

Agora precisamos criar nosso Client Secret, esta será a chave final para que possamos utilizar a OAuth 2.0 da microsoft.

Para isso, localize no menu lateral, a opção, Certificados e segredos em seguida selecione a opção, Novo segredo do cliente.

 

No meno de configurações, defina sua descrição e um prazo de expiração de suas credenciais

Finalizando este passo, salve o valor gerado, pois, caso saia desta página, o valor não estará mais disponível para ser copiado.

Como cadastrar na API: 




Campos:

E-mail Remetente: e-mail Remetente;
Usuário: ID do cliente liberado no processo

Senha: Chave secreta liberada no processo 
Token: Após cadastrar Usuário e Senha, clique no botão "Gerar token" que seja direcionado para o login do G-mail e preenchido o token pelo callback cadastrado.

Feito esse processo basta clicar em "Testar e Salvar" 

Muito bem, finalizamos todo o processo de criação e cadastro das informações!