Mudanças do documento Servidor de e-mail (100)

Última modificação por FlowFast em 2025/07/07 17:58
Da versão 2.1
editado por FlowFast
em 2024/05/15 16:22
Comentário da mudança: Não existe comentário para essa versão
Para versão 3.2
editado por FlowFast
em 2024/09/10 08:22
Comentário da mudança: Não existe comentário para essa versão

Resumo

Detalhes

Propriedades da página
Conteúdo
... ... @@ -18,9 +18,77 @@
18 18  
19 19  Pode ser útil também para poder dar um "Nome" para o e-mail, para que quem recebe visualizar esta descrição e não somente o e-mail, utilizando essa sintaxe "Nome<seuemail@dominio.com.br>. ex: FlowFast<contato@xcape.com.br>
20 20  )))
21 +|xcape.mail.reply-to|Define o campo "reply-to"(responder para) do e-mail. Com esse informação quando a pessoa responder este será o e-mail padrão da resposta utilizado.
21 21  
22 -=== Autenticação OAUTH2 ===
23 +== Autenticação OAUTH2 ==
23 23  
25 +
26 +=== Configuração Office 365 ===
27 +
28 +**Licença necessária:** Office 365 ou Exchange Online
29 +
30 +OBS: Atribuir para o usuário da conta de e-mail a licença. (Pode levar ate 30 min para a licença ser efetivamente aplicada ao usuário (aguardar))
31 +
32 +
33 +
34 +1 - Faça o login no portal Azure (https:~/~/portal.azure.com/#home)
35 +2 - Clique em "Microsoft Entra ID"
36 +3 - Selecione "Registro de Aplicativos" no menu a esquerda
37 +4 - Se seu aplicativo não estiver registrado, verifique o procedimento de criação de aplicativos em https:~/~/learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app
38 +5 - Se a aplicação já estiver registrada, selecione "Todos os aplicativos"
39 +6 - Selecione sua aplicação 
40 +7 - Preste atenção nas informações no topo da pagina, você precisará das credenciais do diretório (locatário) e da aplicação:
41 + a) ID do aplicativo (cliente)
42 + b) ID do diretório (locatário)
43 +
44 +8 - Selecione "Permissões de APIs" no menu a esquerda.
45 +9 - Selecione "Adicionar uma permissão"
46 +10 - Na nova janela, selecione "APIs que a minha organização usa"
47 +11 - Digite "Office 365" na barra de pesquisa
48 +12 - Selecione "Office 365 Exchange Online" nos resultados
49 +13 - Selecione "Permissões de aplicativo"
50 +14 - Abra a sessão "Mail" e marque a permissão "Mail.Send"
51 +15 - Abra a sessão "SMTP" e marque a permissão "SMTP. SendAsApp"
52 +16 - Clique em "Adicionar permissões" no final da pagina
53 +17- Clique em "Conceder consentimento do administrador para ..." ao lado de "Adicionar uma permissão"
54 +18 - Selecione "Sim" na nova janela e realize o login com uma conta de administrador se for solicitado
55 +19 - Clique em "Certificados e segredos" no menu da esquerda.
56 +20 - Clique em "Novo Segredo de cliente"
57 +21 - Informe uma descrição e uma data de expiração do segredo (esse segredo deve ser renovado manualmente quando atingir essa data)
58 +22 - Clique em "Adicionar"
59 +23 - Anote o valor da coluna "Valor" do segredo gerado. Essa informação somente está visivel durante um pequeno período de tempo depois da criação.
60 +
61 +===
62 +Configuração do Exchange ===
63 +
64 +Informações do portal necessárias:
65 +
66 +1 - Faça login no portal do azure (https:~/~/portal.azure.com/#home)
67 +2 - Selecione "Microsoft Entra ID"
68 +3 - Selecione "Aplicativos Empresariais" no menu a esquerda
69 +4 - Selecione seu aplicativo
70 +5 - Anote o valor do "ID do Objeto"
71 +
72 +6 - Abra uma janela de comandos "Powershell" como um administrador do computador.
73 +7 - Execute "Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.4.0"
74 +8 - Execute "Set-ExecutionPolicy -ExecutionPolicy RemoteSigned"
75 +9 - Execute "ExchangeOnlineManagement Import-module"
76 +10 -Execute "Connect-ExchangeOnline -Organization [tenantId]" aonde [tenantId] é o valor do "ID do diretório" no azure acima.
77 +11 - Entre com uma conta de administrador na janela que irá abrir.
78 +12 - Execute "New-ServicePrincipal -AppId [appId] -ObjectId [objId]" onde [appId] é o valor de "ID do aplicativo" obtido no portal [objId] é o valor anotado no passo 5.
79 +13 - Execute "Get-ServicePrincipal | fl" para verificar a informação do serviço criado
80 +14 - Anote o valor do "ExchangeObjectId"
81 +15 - Execute "Add-MailboxPermission -Identity "[username]" -User [exchangeId] -AccessRights FullAccess" onde [username] é a conta de email de origem que você deseja enviar os emails e [exchangeId] é o valor anotado no passo 14.
82 +16 - Valide que a permissao foi adicionada com "Get-MailboxPermission -Identity "[username]" e valide que exista um registro com o seu [objId] do passo 5
83 +17 - Execute "Set-TransportConfig -SmtpClientAuthenticationDisabled $false"
84 +
85 +OBS: Este comando pode levar ate 30 minutos para ser efetivado
86 +
87 +18 - Execute "Disconnect-ExchangeOnline"
88 +
89 +
90 +=== Configuração Flowfast ===
91 +
24 24  Para utilizar autenticação OAUTH2 é necessário adicionar a chave **mail.smtp.auth.mechanisms** com o valor **XOAUTH2**, e as seguintes chave de acordo com o servidor
25 25  
26 26  **Microsoft (Office)**
... ... @@ -34,3 +34,7 @@
34 34  |xcape.mail.xoauth2.client_id|Client ID do aplicativo|
35 35  |xcape.mail.xoauth2.client_secret|Client Secret do aplicativo|
36 36  |xcape.mail.xoauth2.scope|[[https:~~/~~/outlook.office.com/.default>>https://outlook.office.com/.default]]|Dado atual para esse campo
105 +
106 +
107 +
108 +