Visão Geral

Foi implementado no Protheus um novo modelo de envio de e-mail, permitindo autenticação utilizando:

A implementação contempla:

O objetivo principal é permitir compatibilidade com os novos requisitos de autenticação exigidos por provedores como Google e Microsoft, que estão descontinuando autenticação SMTP tradicional baseada apenas em usuário e senha.


Funcionamento da Integração

Envio de Relatórios

O envio de relatórios utiliza o parâmetro MV_RELACNT:

Nova lógica implementada:


Política de Senha

Nas rotinas relacionadas à política de senha:


Tipos de Autenticação

Basic Authentication

Modelo tradicional baseado em:

Características:


OAuth 2.0

Modelo moderno de autenticação baseado em tokens.

Características:

A implementação suporta dois modos:

OAuth 2.0 com Consentimento

Neste modelo:


OAuth 2.0 sem Consentimento (client_credentials)

Neste modelo:


Dados Necessários para Configuração

Dependendo do modelo utilizado, poderão ser necessários:

InformaçãoBasicOAuth ConsentimentoOAuth Client Credentials
UsuárioSimNãoNão
SenhaSimNãoNão
Client IDNãoSimSim
Client SecretNãoSimSim
Tenant IDNãoNãoMicrosoft
Consentimento do usuárioNãoSimNão



Documentações Oficiais

Microsoft

Registro de Aplicações

Microsoft Entra - Registro de Aplicações

OAuth 2.0 Client Credentials

Microsoft OAuth 2.0 Client Credentials Flow

Microsoft Graph - Envio de E-mail

Microsoft Graph - Send Mail


Google

Configuração OAuth 2.0

Google OAuth 2.0 - uso de apis do google

Google Workspace - console


Rotinas Relacionadas

Cadastro de Provedores

Documentação da rotina responsável pelo cadastro dos provedores de autenticação e parâmetros OAuth.

Documentação pendente.


Cadastro de Contas

Documentação da rotina responsável pelo cadastro das contas de e-mail utilizadas no envio.

Documentação pendente.


Classe TLPP

Documentação técnica da classe TLPP responsável pelo gerenciamento da autenticação e envio dos e-mails.

Documentação pendente.