Kết nối Microsoft Outlook 365 với Odoo bằng Azure OAuth¶
Odoo tương thích với Azure OAuth của Microsoft dành cho Microsoft 365. Để gửi và nhận email an toàn từ một tên miền tùy chỉnh, tất cả những gì cần thiết là cấu hình một vài cài đặt trên nền tảng Azure và ở phần cuối của cơ sở dữ liệu Odoo. Cấu hình này hoạt động với địa chỉ email cá nhân hoặc địa chỉ do tên miền tùy chỉnh tạo ra.
Xem thêm
`Microsoft Learn: Đăng ký ứng dụng với nền tảng nhận dạng của Microsoft<https://learn.microsoft.com/azure/active-directory/develop/quickstart-register-app> `_
Thiết lập trong Microsoft Azure Portal¶
Tạo một ứng dụng mới¶
Để bắt đầu, hãy truy cập Cổng thông tin Azure của Microsoft<https://portal.azure.com/> `_. Đăng nhập bằng tài khoản :guilabel:`Microsoft Outlook Office 365 nếu có, nếu không, hãy đăng nhập bằng tài khoản cá nhân Microsoft. Người dùng có quyền truy cập quản trị vào Azure Settings sẽ cần kết nối và thực hiện cấu hình sau. Tiếp theo, điều hướng đến phần có nhãn Manage Microsoft Entra ID (trước đây là Azure Active Directory).
Bây giờ, hãy nhấp vào Thêm (+), nằm ở menu trên cùng, sau đó chọn Đăng ký ứng dụng. Trên màn hình Đăng ký ứng dụng, hãy đổi tên Tên thành Odoo hoặc tên nào đó dễ nhận biết. Trong phần Các loại tài khoản được hỗ trợ, hãy chọn Tài khoản trong bất kỳ thư mục tổ chức nào (Bất kỳ thư mục ID Microsoft Entra nào - Nhiều người thuê) và tài khoản Microsoft cá nhân (ví dụ: Skype, Xbox).
Trong phần URL chuyển hướng, hãy chọn Web làm nền tảng, sau đó nhập https://<web base url> /microsoft_outlook/confirm trong trường URL. web.base.url có thể thay đổi tùy thuộc vào URL được sử dụng để đăng nhập vào cơ sở dữ liệu.
Ghi chú
Tài liệu về :ref:`web.base.url<domain-name/web-base-url> ` giải thích cách đóng băng một URL duy nhất. Bạn cũng có thể thêm các URL chuyển hướng khác nhau trên ứng dụng Microsoft.
Sau khi URL đã được thêm vào trường, Đăng ký ứng dụng để ứng dụng được tạo.
Quyền API¶
Tiếp theo, bạn nên thiết lập Quyền API. Odoo sẽ cần các quyền API cụ thể để có thể đọc (IMAP) và gửi (SMTP) email trong thiết lập Microsoft 365. Trước tiên, hãy nhấp vào liên kết Quyền API, nằm ở thanh menu bên trái. Tiếp theo, hãy nhấp vào nút (+) Thêm Quyền và chọn Microsoft Graph trong Các API Microsoft thường dùng. Sau đó, hãy chọn tùy chọn Quyền được ủy quyền.
Trong thanh tìm kiếm, hãy tìm kiếm Quyền được ủy quyền sau đây và nhấp vào Thêm quyền cho từng quyền:
SMTP.Send
IMAP.AccessAsUser.All
Ghi chú
Quyền User.Read sẽ được thêm vào theo mặc định.
Chỉ định người dùng và nhóm¶
Sau khi thêm quyền API, hãy quay lại Tổng quan của Ứng dụng ở đầu menu thanh bên trái.
Bây giờ, hãy thêm người dùng vào ứng dụng này. Trong bảng tổng quan Essentials, hãy nhấp vào liên kết có nhãn Managed Application in Local Directory hoặc tùy chọn cuối cùng ở phía dưới bên phải của bảng.
Trong menu thanh bên trái, chọn Users and Groups. Tiếp theo, nhấp vào (+) Add User/Group. Tùy thuộc vào tài khoản, có thể thêm Group và Users hoặc chỉ thêm Users. Tài khoản cá nhân sẽ chỉ cho phép thêm Users.
Trong Users hoặc Groups, nhấp vào None Selected và thêm người dùng hoặc nhóm người dùng sẽ gửi email từ Tài khoản Microsoft trong Odoo. Thêm người dùng/nhóm, nhấp vào Chọn, sau đó Gán họ cho ứng dụng.
Tạo thông tin xác thực¶
Bây giờ ứng dụng Microsoft Azure đã được thiết lập, thông tin xác thực cần được tạo cho thiết lập Odoo. Những thông tin này bao gồm Client ID và Client Secret. Để bắt đầu, Client ID có thể được sao chép từ trang Overview của ứng dụng. Client ID hoặc Application ID nằm trong Display Name trong phần tổng quan Essentials của ứng dụng.
Tiếp theo, cần phải lấy Client Secret Value. Để lấy giá trị này, hãy nhấp vào Certificates amp; Secrets trong menu thanh bên trái. Sau đó, cần phải tạo Client Secret. Để thực hiện việc này, hãy nhấp vào nút (+) New Client Secret.
Một cửa sổ bên phải sẽ hiện ra với một nút có nhãn Thêm bí mật của khách hàng. Trong Mô tả, nhập Odoo Fetchmail hoặc một cái gì đó dễ nhận biết, sau đó đặt ngày hết hạn.
Quan trọng
Một Client Secret mới sẽ cần được tạo và cấu hình nếu cái đầu tiên hết hạn. Trong trường hợp này, có thể có sự gián đoạn dịch vụ, vì vậy ngày hết hạn nên được ghi chú và đặt thành ngày xa nhất có thể.
Tiếp theo, nhấp vào Add khi hai giá trị này được nhập. Client Secret Value và Secret ID sẽ được tạo. Điều quan trọng là phải sao chép Value hoặc Client Secret Value vào sổ tay vì nó sẽ được mã hóa sau khi rời khỏi trang này. Secret ID không cần thiết.
Sau các bước này, các mục sau đây sẽ sẵn sàng để thiết lập trong Odoo:
ID khách hàng (ID khách hàng hoặc ID ứng dụng)
Bí mật của khách hàng (Giá trị hoặc Giá trị bí mật của khách hàng)
Như vậy là hoàn tất quá trình thiết lập ở phía Microsoft Azure Portal.
Thiết lập trong Odoo¶
Nhập thông tin đăng nhập Microsoft Outlook¶
Đầu tiên, mở cơ sở dữ liệu Odoo và điều hướng đến module Apps. Sau đó, xóa bộ lọc Apps khỏi thanh tìm kiếm và nhập Outlook. Sau đó, cài đặt module có tên là Microsoft Outlook.
Tiếp theo, điều hướng đến , và trong phần Discuss, hãy đảm bảo rằng hộp kiểm cho Custom Email Servers được chọn. Thao tác này sẽ điền một tùy chọn mới cho Outlook Credentials.
Lưu tiến trình.
Sau đó, sao chép và dán Client ID (ID ứng dụng) và Client Secret (Giá trị bí mật của khách hàng) vào các trường tương ứng và Lưu các thiết lập.
Cấu hình máy chủ email gửi đi¶
Trên trang Cài đặt chung, bên dưới cài đặt Máy chủ email tùy chỉnh, hãy nhấp vào liên kết Máy chủ email gửi đi để cấu hình tài khoản Microsoft.
Sau đó, tạo một máy chủ email mới và đánh dấu vào ô Outlook. Tiếp theo, điền Tên (có thể là bất kỳ) và email Microsoft Outlook Tên người dùng.
Nếu trường From Filter trống, hãy nhập :ref:`tên miền hoặc địa chỉ email<email-outbound-unique-address> `.
Sau đó, nhấp vào Kết nối tài khoản Outlook của bạn.
Một cửa sổ mới từ Microsoft mở ra để hoàn tất quá trình authorization process. Chọn địa chỉ email phù hợp đang được cấu hình trong Odoo.
Sau đó, cho phép Odoo truy cập tài khoản Microsoft bằng cách nhấp vào Yes. Sau đó, trang sẽ điều hướng trở lại Outgoing Mail Server mới được cấu hình trong Odoo. Cấu hình tự động tải token trong Odoo và một thẻ ghi Outlook Token Valid xuất hiện màu xanh lá cây.
Cuối cùng, nhấp vào Kiểm tra kết nối. Một thông báo xác nhận sẽ xuất hiện. Cơ sở dữ liệu Odoo hiện có thể gửi email an toàn, bảo mật thông qua Microsoft Outlook bằng xác thực OAuth.
Cấu hình với một máy chủ thư đi duy nhất¶
Cấu hình một máy chủ gửi duy nhất là cấu hình đơn giản nhất hiện có cho Microsoft Azure và không yêu cầu quyền truy cập mở rộng cho người dùng trong cơ sở dữ liệu.
Một địa chỉ email chung sẽ được sử dụng để gửi email cho tất cả người dùng trong cơ sở dữ liệu. Ví dụ, nó có thể được cấu trúc với bí danh notifications (notifications@example.com) hoặc bí danh contact (contact@example.com). Địa chỉ này phải được đặt là FROM Filtering trên máy chủ. Địa chỉ này cũng phải khớp với tổ hợp phím {mail.default.from}@{mail.catchall.domain} trong các tham số hệ thống.
Xem thêm
Truy cập :ref:`Từ tài liệu Lọc<email-outbound-different-servers-personalized-from-filtering> ` để biết thêm thông tin.
Ghi chú
Có thể truy cập System Parameters bằng cách kích hoạt Chế độ nhà phát triển (chế độ gỡ lỗi) trong menu .
Khi sử dụng cấu hình này, mọi email được gửi từ cơ sở dữ liệu sẽ sử dụng địa chỉ của hộp thư notification đã cấu hình. Tuy nhiên, cần lưu ý rằng tên người gửi sẽ xuất hiện nhưng địa chỉ email của họ sẽ thay đổi:
Example
Cấu hình máy chủ thư đi duy nhất:
Máy chủ thư đi tên người dùng (đăng nhập) =
notifications@example.comMáy chủ thư đi FROM Filtering =
notifications@example.commail.catchall.domaintrong tham số hệ thống =example.commail.default.fromtrong tham số hệ thống =notifications
Cấu hình dành riêng cho người dùng (nhiều người dùng)¶
Ngoài máy chủ email chung, có thể thiết lập máy chủ email riêng cho người dùng trong cơ sở dữ liệu. Các địa chỉ email này phải được đặt là FROM Filtering trên mỗi máy chủ riêng lẻ để cấu hình này hoạt động.
Cấu hình này khó hơn trong hai cấu hình Microsoft Azure vì nó yêu cầu tất cả người dùng được cấu hình với máy chủ email phải có quyền truy cập vào các thiết lập để thiết lập kết nối với máy chủ email.
Thiết lập¶
Mỗi người dùng nên thiết lập một máy chủ email riêng. FROM Filtering nên được thiết lập sao cho chỉ có email của người dùng được gửi từ máy chủ đó. Nói cách khác, chỉ người dùng có địa chỉ email khớp với FROM Filtering mới có thể sử dụng máy chủ này.
Xem thêm
Truy cập :ref:`Từ tài liệu Lọc<email-outbound-different-servers-personalized-from-filtering> ` để biết thêm thông tin.
A máy chủ dự phòng<azure_oauth/notifications> ` phải được thiết lập để cho phép gửi :guilabel:`notifications. FROM Filtering cho máy chủ này phải có giá trị là {mail.default.from}@{mail.catchall.domain}.
Ghi chú
Có thể truy cập System Parameters bằng cách kích hoạt Chế độ nhà phát triển (chế độ gỡ lỗi) trong menu .
Quan trọng
Cấu hình cho máy chủ email giao dịch này có thể hoạt động cùng với máy chủ email gửi hàng loạt. FROM Filtering cho máy chủ email gửi hàng loạt có thể để trống, nhưng cần phải thêm vào cài đặt của ứng dụng Email Marketing.
Xem thêm
Để biết thêm thông tin về cách thiết lập máy chủ email gửi thư hàng loạt, hãy truy cập Gửi email với máy chủ SMTP bên ngoài.
Example
Cấu hình máy chủ thư đi cho nhiều người dùng:
- Hộp thư người dùng số 1
Máy chủ thư đi #1 tên người dùng (đăng nhập) =
john@example.comMáy chủ thư đi #1 FROM Filtering =
john@example.com
- Hộp thư người dùng số 2
Máy chủ thư đi #2 tên người dùng (đăng nhập) =
jane@example.comMáy chủ thư đi #2 FROM Filtering =
jane@example.com
- Hộp thư thông báo
Máy chủ thư đi #3 tên người dùng (đăng nhập) =
notifications@example.comMáy chủ thư đi #3 FROM Filtering =
notifications@example.com
- Thông số hệ thống
mail.catchall.domaintrong tham số hệ thống =example.commail.default.fromtrong tham số hệ thống =notifications
Cấu hình máy chủ email đến¶
Tài khoản đến phải được cấu hình theo cách tương tự như tài khoản email đi. Điều hướng đến Máy chủ thư đến trong Menu kỹ thuật và Tạo cấu hình mới. Kiểm tra hoặc Chọn nút bên cạnh Xác thực Oauth Outlook và nhập Tên người dùng Microsoft Outlook. Nhấp vào Kết nối tài khoản Outlook. Odoo sẽ thông báo: Mã thông báo Outlook hợp lệ Bây giờ Kiểm tra và xác nhận tài khoản. Tài khoản sẽ sẵn sàng nhận email đến cơ sở dữ liệu Odoo.