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
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 Emai
Dicas de cadastro:
Caso ao final do processo tome algum erro 403, tente realizar o processo de ajuste citado nessa doc:
https://forum.casadodesenvolvedor.com.br/topic/48934-acesso-bloqueado-o-app-n%C3%A3o-concluiu-o-processo-de-verifica%C3%A7%C3%A3o-do-google/#comment-53248
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;
1 - Usuário: ID do cliente liberado no processo;
2- Senha: Chave secreta liberada no processo;
3 - Tenant ID: ID do locatário coletado ao finalizar o processo;
4- 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!
Observações do fluxo de Hotmail:
O que fazer caso eu receba o erro "Campo Autenticacao microsoft: AADSTS65001: The user or administrator has not consented to use the application with ID '*******' named 'EmailPB'. Send an interactive authorization request for this user and resource."?
Siga essas instruções:
Acesse o Microsoft Entra admin center.
- Vá em Entra ID → Enterprise applications → All applications.
- Localize o app (pelo nome ou pelo Application (client) ID da mensagem).
- Abra o app e vá em Security → Permissions.
- Execute Grant admin consent (consentimento para toda a organização/tenant).
Comentários
0 comentário
Por favor, entre para comentar.