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:
- Passo a passo: criando credenciais OAuth com Gmail
- Passo a passo: criando credenciais OAuth com Outlook
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
- Método para obter AuthCode informando o parâmetro URLRedirection, irá retornar a URL para fazer a captura do Code
- 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
Comentários
0 comentário
Por favor, entre para comentar.