Configuração componentes para Autenticação oAuth2 – Central de Atendimento

Para iniciar as configurações do novo método de validação de envio de emails siga o passo a passo abaixo:

1. Ative sua conta para liberar a validação oAuth do seu provedor de email:

2. Com o client_secret, client_id e o *TenantID (*apenas Microsoft necessita) em mãos, configure no arquivo de configuração do componente e inicie a chamada do método para gerar o token.

Propriedades config.ini para configurar autenticação oAuth2 no componente

Propriedade	Valor	Descrição
UseOAuth2	0-1	Habilita ou desabilita o uso do OAuth2 como método de autenticação no envio de e-mail
ProvedorOAuth	hotmail/outlook/gmail	tipo do provedor de autenticação OAuth2. Se vazio, indica que não usará OAuth2.
ClientID	obter na plataforma	identificador do cliente da plataforma
ClientSecret	obter na plataforma	chave secreta fornecida pela plataforma
RefreshToken	obter pelo método do componente caso não tenha obtido por meio de requisição na plataforma	token usado para regerar o AccessToken. É um token mais duradouro (meses). Gerado somente mediante autenticação manual da conta do usuário (navegador).
AccessToken	obter pelo método do componente caso não tenha obtido por meio de requisição na plataforma	token de acesso, de fato o usado para as operações de email. É um token com validade curta (tipicamente de 1h), gerado automaticamente sempre que necessário, sem intervenção do usuário.
ExpireIn	11/12/2024 17:25:15	data/hora de validade do token de acesso, normalmente 1h após a última atualização. gerado pelo Método
TenantId		#Id do locatário(Tenant) do app exclusivo para utilização OAuth2 com azure.

Propriedades devem ficar seção [MAIL]

[MAIL]

UseOAuth2=1
ProvedorOAuth=outlook
EmailRemetente=seuemail.@outlook.com.br
ClientID=zM8Q~G2pHJ4Xg.RaFtZXn.foqFeaZ-i8bqhC123
ClientSecret=vzM8Q~G2pHJ4Xg.RaFtZXn.foqFeaZ-i8b123
RefreshToken=1.AWEBXtsyZ-onk0-b_7AccMdy-HBfjV8LxFBNoHRfbABgnxNhAexhAQ.AgABAwEAAADW6jl31mB3T7ugrWTT8pFeAwDs_wUA9P_46O
AccessToken=eyJ0eXAiOiJKV1QiLCJub25jZSI6Ik16YXpZTmtTVk1FRjhBM0ViMWg1WTZhcDJUN2hDTWNINElZeVFiNHlRS1EiLCJhbGciOiJSUzI1NiIsIng1dCI6InoxcnNZSEhKOS04bWdndDRIc1p1OEJLa0JQdyIsImtpZCI6InoxcnNZSEhKOS04bWdndDRIc1p1OEJLa0JQdyJ9.eyJhdW
ExpireIn=11/12/2024 17:25:15
TenantId=6732db5e-27ea-4f93-9bff-b01c70c77123

Obter os TOKENS

A geração dos tokens pode ser feito em 1 Passo usando o método:
- Método para obter AuthCode (sem informar o parâmetro URLRedirection)
Ou em 2 passos caso queira personalizar ou ter maior controle sobre a pagina HTML de captura o Authorization Code
1. Método para obter AuthCode informando o parâmetro URLRedirection, irá retornar a URL para fazer a captura do Code
2. Chamar o Metodo para obter AcessToken, RefreshToken

Após concluir as configurações, podem estar enviando o email normalmente através do método de envio de email do seu respectivo componente.

Obs: A configuração do token é realizada uma única vez, após essa configuração o componente irá regerar o token conforme a data de expiração do campo ExpireIn

Artigos relacionados