Conectați Microsoft Outlook 365 la Odoo utilizând Azure OAuth¶
Odoo este compatibil cu Azure OAuth pentru Microsoft 365. Pentru a trimite și primi e-mailuri securizate de la un domeniu personalizat, tot ce este necesar este să configurați câteva setări pe platforma Azure și pe partea de spate a bazei de date Odoo. Această configurare funcționează cu orice adresă de e-mail personală sau creată de un domeniu personalizat.
Configurare în portalul Microsoft Azure¶
Creați o aplicație nouă¶
To get started, go to Microsoft’s Azure Portal. Log in with the Microsoft Outlook Office 365 account if there is one, otherwise log in with the personal Microsoft account. A user with administrative access to the Azure Settings will need to connect and perform the following configuration. Next, navigate to the section labeled Manage Microsoft Entra ID (formally Azure Active Directory).
Now, click on Add (+), located in the top menu, and then select App
registration. On the Register an application screen, rename the Name to
Odoo
or something recognizable. Under the Supported account types section select
Accounts in any organizational directory (Any Microsoft Entra ID directory - Multitenant)
and personal Microsoft accounts (e.g. Skype, Xbox).
Sub secțiunea Redirect URL, selectați Web ca platformă și apoi introduceți https://<odoo base url>/microsoft_outlook/confirm
în câmpul URL. URL-ul de bază Odoo este domeniul canonical la care instanța Odoo poate fi accesată în câmpul URL.
Example
mydatabase.odoo.com, unde mydatabase este prefixul actual al subdomeniului bazei de date, presupunând că este găzduit pe Odoo.com
După ce URL-ul a fost adăugat în câmp, Register aplicația astfel încât să fie creată.
Permisiuni API¶
The API permissions should be set next. Odoo will need specific API permissions to be able to read (IMAP) and send (SMTP) emails in the Microsoft 365 setup. First, click the API permissions link, located in the left menu bar. Next, click on the (+) Add a Permission button and select Microsoft Graph under Commonly Used Microsoft APIs. After, select the Delegated Permissions option.
In the search bar, search for the following Delegated permissions and click Add permissions for each one:
SMTP.Send
IMAP.AccessAsUser.All
Notă
The User.Read permission will be added by default.
Atribuie utilizatori și grupuri¶
După ce ați adăugat permisiunile API, navigați înapoi la Overview al Application în partea de sus a meniului din bara laterală stângă.
Acum, adăugați utilizatori la această aplicație. Sub Essentials tabelul de prezentare, faceți clic pe link-ul denumit Managed Application in Local Directory, sau ultima opțiune din partea dreaptă jos a tabelului.
În meniul din bara laterală stângă, selectați Users and Groups. În continuare, faceți clic pe (+) Add User/Group. În funcție de cont, fie un Group și un User pot fi adăugați, sau doar Users. Conturile personale vor permite doar adăugarea Users.
Sub Users sau Groups, faceți clic pe None Selected și adăugați utilizatorii sau grupul de utilizatori care vor trimite e-mailuri de la Microsoft account în Odoo. Add utilizatorii/grupurile, faceți clic pe Select, și apoi Assign lor la aplicație.
Creați credențiale¶
Acum, aplicația Microsoft Azure este configurată, credențialele trebuie create pentru configurarea Odoo. Acestea includ Client ID și Client Secret. Pentru a începe, Client ID poate fi
În continuare, Client Secret Value trebuie să fie recuperat.Pentru a obține această valoare, faceți clic pe Certificates & Secrets în meniul din bara laterală stângă. Apoi, un Client Secret trebuie să fie produs. Pentru a face acest lucru, faceți clic pe butonul (+) New Client Secret.
O fereastră din dreapta se va popula cu un buton denumit Add a client secret. Sub Description, tastați Odoo Fetchmail
sau ceva ce poate fi recunoscut, și apoi setați expiration date.
Important
Un nou Client Secret trebuie să fie produs și configurat dacă primul expiră. În acest caz, ar putea fi o întrerupere a serviciului, astfel încât data de expirare trebuie să fie notată și setată la cea mai îndepărtată posibilă.
În continuare, faceți clic pe Add atunci când aceste două valori sunt introduse. Un Client Secret Value și Secret ID vor fi create. Este important să copiați Value sau Client Secret Value într-un notepad, deoarece va deveni criptat după părăsirea acestei pagini. Secret ID nu este necesar.
După aceste pași, următoarele elemente ar trebui să fie gata pentru a fi configurate în Odoo:
Un client ID (Client ID sau Application ID)
Un secret client (Value sau Client Secret Value)
Aceasta încheie configurarea de pe partea Microsoft Azure Portal.
Setare în Odoo¶
Introduceți credențialele Microsoft Outlook¶
În primul rând, deschideți baza de date Odoo și navigați către modulul Aplicații. Apoi, eliminați filtrul Aplicații din bara de căutare și tastați Outlook
. După aceea, instalați modulul numit Microsoft Outlook.
În continuare, navigați către Discuții, asigurați-vă că caseta pentru Custom Email Servers este bifată. Aceasta populează o nouă opțiune pentru Outlook Credentials.
, și sub secțiuneaSalvați progresul.
Apoi, copiați și lipiți Client ID (Application ID) și Client Secret (Client Secret Value) în câmpurile respective și Salvați setările.
Configurați serverul de e-mail de ieșire¶
Pe pagina Setări generale, sub setarea Custom Email Servers, faceți clic pe link-ul Outgoing Email Servers pentru a configura contul Microsoft.
Apoi, creați un nou server de e-mail și bifați caseta pentru Outlook. În continuare, completați Nume (poate fi orice) și e-mail-ul Microsoft Outlook Username.
If the From Filter field is empty, enter either a domain or email address.
Then, click on Connect your Outlook account.
O nouă fereastră de la Microsoft se deschide pentru a completa procesul de autorizare. Selectați adresa de e-mail potrivită care este configurată în Odoo.
Apoi, permiteți Odoo să acceseze contul Microsoft făcând clic pe Da. După aceasta, pagina se va naviga înapoi la Outgoing Mail Server nou configurat în Odoo. Configurarea încarcă automat token în Odoo, și o etichetă care spune Outlook Token Valid apare în verde.
În cele din urmă, faceți clic pe Test Connection. Un mesaj de confirmare ar trebui să apară. Baza de date Odoo poate acum trimite e-mailuri sigure și securizate prin Microsoft Outlook folosind autentificarea OAuth.
Configuration with a single outgoing mail server¶
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 FROM Filtering on the server.
This address must also match the {mail.default.from}@{mail.catchall.domain}
key combination in the
system parameters.
Vedeți și
For more information on the from filter visit: Utilizați o adresă de e-mail implicită „From”.
Notă
The System Parameters can be accessed by activating Modul dezvoltator (modul de depanare) in the 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:
Example
Single outgoing mail server configuration:
Outgoing mail server username (login) =
notifications@example.com
Outgoing mail server 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 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.
Configurare¶
Each user should have a separate email server set up. The 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 FROM Filtering is able to use this server.
Vedeți și
For more information on the from filter visit: Utilizați o adresă de e-mail implicită „From”.
A fallback server must be setup to allow for the sending of
notifications. The FROM Filtering for this server should have the value of
the {mail.default.from}@{mail.catchall.domain}
.
Notă
The System Parameters can be accessed by activating Modul dezvoltator (modul de depanare) in the menu.
Important
The configuration for this transactional email server can work alongside an outgoing mass-mailing email server. The 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.
Vedeți și
For more information on setting the mass-mailing email server visit Set up different dedicated servers for transactional and mass emails.
Example
Multiple user outgoing mail server configuration:
- User #1 mailbox
Outgoing mail server #1 username (login) =
john@example.com
Outgoing mail server #1 FROM Filtering =
john@example.com
- User #2 mailbox
Outgoing mail server #2 username (login) =
jane@example.com
Outgoing mail server #2 FROM Filtering =
jane@example.com
- Notifications mailbox
Outgoing mail server #3 username (login) =
notifications@example.com
Outgoing mail server #3 FROM Filtering =
notifications@example.com
- Parametri sistem
mail.catchall.domain
in system parameters =example.com
mail.default.from
in system parameters =notifications
Configurați serverul de e-mail de intrare¶
Contul de intrare ar trebui să fie configurat într-un mod similar cu contul de e-mail de ieșire. Navigați la Incoming Mail Servers în Technical Menu și Create o nouă configurare. Verificați sau selectați butonul lângă Outlook Oauth Authentication și introduceți Microsoft Outlook username. Faceți clic pe Connect your Outlook account. Odoo va afișa: Outlook Token Valid Acum Test and Confirm contul. Contul ar trebui să fie gata să primească e-mailuri în baza de date Odoo.