From efbf84fdb6d4f8f8fb637c0109a6c98d146ce5e1 Mon Sep 17 00:00:00 2001 From: bve-odoo Date: Mon, 25 Sep 2023 15:41:11 +0200 Subject: [PATCH] [FIX] azure_oauth: configuration mail server Outlook. Results of seeing a lot of wrong and missing configuration on consultancy project for Outlook accounts. The Multi outgoing mail server is harder to maintain than having a unique mail server with an Odoo db correctly configured. Insisting on the mail.default.from (ICP) and the From Filtering parameters that NEEDS TO BE set up. task-3512379 [FIX] Maintain: Azure_oauth: configuration mail server Outlook Co-author-by: tiku-odoo Co-author-by: jqu-odoo Results of seeing a lot of wrong and missing configuration on consultancy project for Outlook accounts. The Multi outgoing mail server is harder to maintain than having a unique mail server with an Odoo db correctly configured. Insisting on the mail.default.from (ICP) and the From Filtering parameters that NEEDS TO BE set up. task-3512379 closes odoo/documentation#6032 X-original-commit: 41b9ba63835511fa5b20c48746b165a886296057 Signed-off-by: Zachary Straub (zst) --- .../administration/maintain/azure_oauth.rst | 99 +++++++++++++++--- .../maintain/azure_oauth/from-name-remain.png | Bin 0 -> 2913 bytes 2 files changed, 86 insertions(+), 13 deletions(-) create mode 100644 content/administration/maintain/azure_oauth/from-name-remain.png diff --git a/content/administration/maintain/azure_oauth.rst b/content/administration/maintain/azure_oauth.rst index c9094e3cb..3a4157cef 100644 --- a/content/administration/maintain/azure_oauth.rst +++ b/content/administration/maintain/azure_oauth.rst @@ -188,23 +188,96 @@ configuration automatically loads the :guilabel:`token` in Odoo, and a tag stati Finally, click :guilabel:`Test Connection`. A confirmation message should appear. The Odoo database can now send safe, secure emails through Microsoft Outlook using OAuth authentication. -Multiple user configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. _azure_oauth/notifications: -Each user should have a separate server set up. The :guilabel:`from-filter` should be set so that -only the user's email is sent from that server. In other words, only a user with an email address -that matches the set :guilabel:`from-filter` is able to use this server. +Configuration with a single outgoing mail server +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -After setting the :guilabel:`from-filter`, set up a fallback email account to allow for the sending -of :guilabel:`notifications`. The fallback email must be configured as a :guilabel:`general -transactional server`. The :guilabel:`mail.default.from` system parameter must be set to the -:guilabel:`username` of the general transactional server account. For more information see -:ref:`Use a default email address `. +Configuring a single outgoing server is the simplest configuration available for Microsoft Azure +and it doesn't require extensive access rights for the users in the database. + +A generic email address would be used to send emails for all users within the database. For example +it could be structured with a `notifications` alias (`notifications@example.com`) or `contact` alias +(`contact@example.com`). This address must be set as the :guilabel:`FROM Filtering` on the server. +This address must also match the `{mail.default.from}@{mail.catchall.domain}` key combination in the +system parameters. + +.. seealso:: + For more information on the from filter visit: :ref:`email_communication/default`. .. note:: - The :guilabel:`System Parameters` can be accessed by activating - :doc:`../../applications/general/developer_mode` in the :menuselection:`Settings --> Technical - --> Parameters --> System Parameters` menu. + The :guilabel:`System Parameters` can be accessed by activating :ref:`developer-mode` in the + :menuselection:`Settings --> Technical --> Parameters --> System Parameters` menu. + +When using this configuration, every email that is sent from the database will use the address of +the configured `notification` mailbox. However it should be noted that the name of the sender will +appear but their email address will change: + +.. image:: azure_oauth/from-name-remain.png + :align: center + :alt: Name from real sender with static email. + +.. example:: + Single outgoing mail server configuration: + + - Outgoing mail server **username** (login) = `notifications@example.com` + - Outgoing mail server :guilabel:`FROM Filtering` = `notifications@example.com` + - `mail.catchall.domain` in system parameters = `example.com` + - `mail.default.from` in system parameters = `notifications` + +User-specific (multiple user) configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In addition to a generic email server, individual email servers can be set up for users in a +database. These email addresses must be set as the :guilabel:`FROM Filtering` on each individual +server for this configuration to work. + +This configuration is the more difficult of the two Microsoft Azure configurations, in that it +requires all users configured with email servers to have access rights to settings in order to +establish a connection to the email server. + +Setup +***** + +Each user should have a separate email server set up. The :guilabel:`FROM Filtering` should be set +so that only the user's email is sent from that server. In other words, only a user with an email +address that matches the set :guilabel:`FROM Filtering` is able to use this server. + +.. seealso:: + For more information on the from filter visit: :ref:`email_communication/default`. + +A :ref:`fallback server ` must be setup to allow for the sending of +:guilabel:`notifications`. The :guilabel:`FROM Filtering` for this server should have the value of +the `{mail.default.from}@{mail.catchall.domain}`. + +.. note:: + The :guilabel:`System Parameters` can be accessed by activating :ref:`developer-mode` in the + :menuselection:`Settings --> Technical --> Parameters --> System Parameters` menu. + +.. important:: + The configuration for this transactional email server can work alongside an outgoing mass-mailing + email server. The :guilabel:`FROM Filtering` for the mass-mailing email server can remain empty, + but it's require to be added in the settings of the *Email Marketing* application. + + .. seealso:: + For more information on setting the mass-mailing email server visit + :ref:`email_communication/mass_mails`. + +.. example:: + Multiple user outgoing mail server configuration: + + - User #1 mailbox + - Outgoing mail server #1 **username** (login) = `john@example.com` + - Outgoing mail server #1 :guilabel:`FROM Filtering` = `john@example.com` + - User #2 mailbox + - Outgoing mail server #2 **username** (login) = `jane@example.com` + - Outgoing mail server #2 :guilabel:`FROM Filtering` = `jane@example.com` + - Notifications mailbox + - Outgoing mail server #3 **username** (login) = `notifications@example.com` + - Outgoing mail server #3 :guilabel:`FROM Filtering` = `notifications@example.com` + - System Parameters + - `mail.catchall.domain` in system parameters = `example.com` + - `mail.default.from` in system parameters = `notifications` Configure incoming email server ------------------------------- diff --git a/content/administration/maintain/azure_oauth/from-name-remain.png b/content/administration/maintain/azure_oauth/from-name-remain.png new file mode 100644 index 0000000000000000000000000000000000000000..3aa3052e4b38bb86b8f62d79b77073f8960a3186 GIT binary patch literal 2913 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 LNkvXXu0mjf#h1yp literal 0 HcmV?d00001