Exibir código-fonte para Email Autenticação OAuth2

Passo a passo de como fazer a configuração para provedores de e-mail que utilizam a autenticação OAuth2.

'''Para testar pode-se usar a própria conta com o domínio dataplussistemas.com.br'''

== 1° Passo - Criar conta Outlook para acesso ao Azure ==
[https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?redirect_uri=https%3A%2F%2Fportal.azure.com%2Fsignin%2Findex%2F&response_type=code%20id_token&scope=https%3A%2F%2Fmanagement.core.windows.net%2F%2Fuser_impersonation%20openid%20email%20profile&state=OpenIdConnect.AuthenticationProperties%3Da4iUNLWiSzH5XT__v6Yw_KUhkh27qkJH2SLp9pblsJWup9KKQ9EklKS6oEU0Nd68lMAKEFrBYoD_c1JLG67_vk2-Dn-d9ICTxgiD3-H4-5pxMFHP6prWxNl1m2mwhFYSnGFyyVE-uk__qcm5mIWELpvvdOQXj4KCsHg90uMN6FbIp3leOi7JQ49oMUR3hA3JUVc3zf1VqoqwQrmDs5o-9EPJLJnMkhJdeQl8vuBbbSUv5PnrMi40hus5Aqf_QdjDZUTWqAW-1RWoKvlKZVRce-F-nYMGHirMegBcPbb6-QactAksJyqxr-VFwMGqnq0hh_YtM_5kywXFwI63iJFG9j3NfQzQp5rruHAWumDkSf0wglQIleYrWeo6OZyzMOwgP1-xFlle7JLiNnFtZIY9SXaXvjzZdyiYhyr7pnLPRWwXO3PW1ThLtrsvpSJHP9H3GcLsINTi-_76-wl1c1Jz_2dEY7x034B0LZO65IVB6mVp9qfEVdlD9OHtzl4HTUHJCYDgoTIhOqZ2ivonbb2hDu1zp3NrPJg9yrm-Ju1mKGedPBcpbgtpqdLpiPJ6GDxR&response_mode=form_post&nonce=638902727268198847.YTRlNThlYTYtN2IxMS00OTQ1LWJmMTYtYjdiZDczMDZhZmRkOWNkZWIyOWYtZGYzNy00Y2M3LWE4NmItYTUyMzc2YjQ0MDVh&client_id=c44b4083-3bb0-49c1-b47d-974e53cbdf3c&site_id=501430&instance_aware=true&client-request-id=f734300d-3dd1-413f-8103-d7ebaeb0b146&x-client-SKU=ID_NET472&x-client-ver=8.3.0.0 Outlook]

== 2° Passo - Acessar portal de E-mails ==
Acesse: [https://admin.microsoft.com/Adminportal/Home?#/users Gerenciador de E-mail]

Nessa etapa é preciso realizar a marcação da '''Autenticação SMTP''' para os usuários que irão realizar o envio de e-mails.

[[Arquivo:E-mail OAuth2 Gerenciador.png|centro|E-mail OAuth2 Gerenciador]]
<br><br>
[[Arquivo:E-mail OAuth2 SMTP Autenticação.png|centro|E-mail OAuth2 SMTP Autenticação]]

== 3° Passo - Criar aplicativo ==
Acesse: [https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade Registro de Aplicativo]

[[Arquivo:E-mail OAuth2 Registro de aplicativo.png|centro|E-mail OAuth2 Registro de aplicativo]]<br>

As credenciais apontadas na imagem serão informadas nas configurações gerais do ERP:
[[Arquivo:E-mail OAuth2 Credenciais Cliend ID e ID Organização.png|centro|E-mail OAuth2 Credenciais Cliend ID e ID Organização]]<br>

É preciso realizar a criação do segredo que é o Client-Secret que será informado no ERP:
[[Arquivo:E-mail OAuth2 Criação do segredo.png|centro|E-mail OAuth2 Criação do segredo]]<br>

[[Arquivo:E-mail OAuth2 Valor Segredo.png|centro|E-mail OAuth2 Valor Segredo]]<br>

Para que tenha o funcionamento adequado é preciso selecionar algumas permissões para a API (Mail.Send e SMTP.SendAsApp)
[[Arquivo:E-mail OAuth2 Permissões da API.png|centro|E-mail OAuth2 Permissões da API]]<br>

[[Arquivo:E-mail OAuth2 Mail.Send Mail.SendAsApp.png|centro|E-mail OAuth2 Mail.Send Mail.SendAsApp]]<br>

Após as permissões terem sido adicionadas, é preciso realizar o consentimento de administrador para elas:
[[Arquivo:E-mail OAuth2 Consentimento Usuário.png|centro|E-mail OAuth2 Consentimento Usuário]]<br>

[[Arquivo:E-mail OAuth2 Confirmação Consentimento Usuário.png|centro|E-mail OAuth2 Confirmação Consentimento Usuário]]<br>

== 4° Passo - Realizar a liberação dos usuários para envio do e-mail ==
Abra o '''PowerShell''' no modo administrador. Esse processo deve ser realizado pelo administrador do domínio:

1° - '''Install-Module ExchangeOnlineManagement -Force'''<br>
 - O comando instala o módulo oficial do PowerShell necessário para administrar o Exchange Online. O parâmetro -Force força a instalação mesmo que o módulo já exista ou esteja desatualizado.

2° - '''Import-Module ExchangeOnlineManagement'''<br>
 - O comando carrega esse módulo na sessão atual do PowerShell, tornando os cmdlets do Exchange disponíveis para uso.

3° - '''Connect-ExchangeOnline'''<br>
 - O comando inicia a conexão com o ambiente Exchange Online da Microsoft. Ao executá-lo, você será solicitado a informar suas credenciais administrativas.

4° A - '''Set-TransportConfig -SmtpClientAuthenticationDisabled $false''' (Ativação global)<br>
 - O comando habilita globalmente o suporte à autenticação SMTP no seu tenant Microsoft 365. Isso permite que os usuários usem login (senha ou OAuth2) para enviar e-mails via SMTP, por exemplo, usando smtp.office365.com.

OU

4° B - '''Set-CASMailbox -Identity "usuario@email.com.br" -SmtpClientAuthenticationDisabled $false''' (Ativação individual)<br>
 - O comando ativa explicitamente a autenticação SMTP para esse usuário específico. Isso é útil caso você queira ativar SMTP apenas para alguns usuários, mesmo que a configuração global esteja desativada.

5° - '''Get-ManagementRoleAssignment -Role "Role Management"'''
 - O comando verifica se sua conta tem atribuição para o papel “Role Management”, necessário para criar service principals e modificar permissões avançadas.

6° - '''New-ServicePrincipal -AppId <client_id> -ObjectId <object_id>'''<br>
 - O comando registra um service principal (aplicativo Azure AD) no Exchange Online, vinculando seu App registrado no Entra ID (Azure AD) ao Exchange. Isso é essencial para que o app possa acessar caixas de correio via OAuth2 (SMTP, IMAP, etc.).

7° - '''Get-ServicePrincipal'''<br>
 - O comando lista todos os service principals já registrados no Exchange Online, permitindo verificar se o seu foi criado corretamente.

8° - '''Add-MailboxPermission -Identity "usuario@email.com.br" -User <object_id> -AccessRights FullAccess'''
 - O comando concede ao seu app (identificado pelo ObjectId do service principal) acesso completo à caixa de correio do usuário especificado. Isso permite que o app leia ou envie mensagens.

9° - '''Add-RecipientPermission -Identity "usuario@email.com.br" -Trustee <object_id> -AccessRights SendAs'''
O comando autoriza o app a enviar e-mails como se fosse o próprio usuário (SendAs). Esse passo é obrigatório para que o envio via SMTP OAuth funcione corretamente com o endereço do usuário como remetente.