Kết nối Gmail với SoOn bằng Google OAuth¶

SoOn tương thích với OAuth dành cho Gmail của Google. Để gửi email an toàn từ một miền tùy chỉnh, tất cả những gì cần thiết là định cấu hình một số cài đặt trên nền tảng Workspace của Google cũng như ở mặt sau của cơ sở dữ liệu SoOn. Cấu hình này hoạt động bằng cách sử dụng địa chỉ email cá nhân hoặc địa chỉ được tạo bởi miền tùy chỉnh.

Mẹo

Để biết thêm thông tin, hãy truy cập tài liệu của Google về cách thiết lập OAuth.

Xem thêm

Thiết lập trong Google¶

Tạo một dự án mới¶

Để bắt đầu, hãy truy cập Bảng điều khiển API của Google. Đăng nhập bằng tài khoản Google Workspace nếu có, nếu không thì hãy đăng nhập bằng tài khoản Gmail cá nhân của bạn (tài khoản này phải khớp với địa chỉ email bạn muốn định cấu hình trong SoOn).

Sau đó, nhấp vào Tạo dự án, nằm ở phía ngoài cùng bên phải của Màn hình đồng ý OAuth. Nếu một dự án đã được tạo trong tài khoản này thì tùy chọn Dự án mới sẽ nằm ở phía trên bên phải trong trình đơn thả xuống Chọn dự án.

Trên màn hình Dự án mới, đổi tên Tên dự án thành SoOn và duyệt tìm Vị trí. Đặt Vị trí làm tổ chức Google Workspace. Nếu bạn đang sử dụng tài khoản Gmail cá nhân thì hãy để Vị trí là Không có tổ chức.

Bấm vào Tạo để hoàn tất bước này.

Chỉnh sửa đăng ký ứng dụng¶

Tiếp theo chúng ta sẽ cấu hình đăng ký ứng dụng của dự án.

Ở bước Màn hình đồng ý OAuth, trong phần Thông tin ứng dụng, hãy nhập SoOn vào trường Tên ứng dụng. Chọn địa chỉ email của tổ chức trong trường email Hỗ trợ người dùng.

Tiếp theo, trong Miền ứng dụng -> Miền được ủy quyền, nhấp vào Thêm tên miền và nhập soon.com.

Sau đó, trong phần Thông tin liên hệ của nhà phát triển, hãy nhập địa chỉ email của tổ chức. Google sử dụng địa chỉ email này để thông báo cho tổ chức về bất kỳ thay đổi nào đối với dự án của bạn.

Tiếp theo, nhấp vào nút Lưu và tiếp tục. Sau đó, bỏ qua trang Phạm vi bằng cách cuộn xuống cuối và nhấp vào Lưu và tiếp tục.

Nếu tiếp tục ở chế độ thử nghiệm (Bên ngoài), hãy thêm các địa chỉ email đang được định cấu hình trong bước Kiểm tra người dùng, bằng cách nhấp vào Thêm người dùng, sau đó nhấp vào nút Lưu và tiếp tục. Một bản tóm tắt về đăng ký ứng dụng xuất hiện.

Cuối cùng, cuộn xuống phía dưới và nhấp vào Quay lại Bảng điều khiển để hoàn tất việc thiết lập dự án.

Tạo thông tin xác thực¶

Bây giờ dự án đã được thiết lập, thông tin xác thực sẽ được tạo, bao gồm ID khách hàng và Bí mật khách hàng. Đầu tiên, nhấp vào Credentials trong menu thanh bên trái.

Sau đó, nhấp vào Tạo thông tin xác thực trong menu trên cùng và chọn OAuth client ID từ menu thả xuống.

Trong Loại ứng dụng, chọn Ứng dụng web từ menu thả xuống.
Trong trường Tên, nhập SoOn.
Dưới nhãn URI chuyển hướng được ủy quyền, hãy nhấp vào nút ADD URI, sau đó nhập https://yourdbname.odoo.com/google_gmail/confirm vào URI 1 cánh đồng. Đảm bảo thay thế phần yourdbname của URL bằng tên cơ sở dữ liệu SoOn thực tế.
Tiếp theo, nhấp vào Tạo để tạo OAuth Client ID và Client Secret. Cuối cùng, sao chép từng giá trị được tạo để sử dụng sau khi định cấu hình trong SoOn, sau đó điều hướng đến cơ sở dữ liệu SoOn.

ID khách hàng và Bí mật khách hàng cho Google OAuth.

Thiết lập trong SoOn¶

Nhập thông tin xác thực Google¶

Đầu tiên, mở SoOn và điều hướng đến mô-đun Ứng dụng. Sau đó, xóa bộ lọc Ứng dụng khỏi thanh tìm kiếm và nhập Google. Cài đặt mô-đun có tên Google Gmail.

Tiếp theo, điều hướng đến Cài đặt ‣ Cài đặt chung, và trong phần Discuss, đảm bảo rằng hộp kiểm cho Máy chủ email tùy chỉnh hoặc Máy chủ email bên ngoài là đã kiểm tra. Thao tác này sẽ đưa ra một tùy chọn mới cho Thông tin xác thực Gmail hoặc Sử dụng Máy chủ Gmail. Sau đó, sao chép và dán các giá trị tương ứng vào các trường Client ID và Client Secret và Lưu cài đặt.

Cấu hình máy chủ email đi¶

Để định cấu hình tài khoản Gmail bên ngoài, hãy quay lại đầu cài đặt Máy chủ email tùy chỉnh rồi nhấp vào liên kết Máy chủ email đi.

Định cấu hình máy chủ email gửi đi trong SoOn.

Sau đó, nhấp vào Mới hoặc Tạo để tạo một máy chủ email mới và điền Tên, Description và email :guilabel:`Username `(nếu cần).

Tiếp theo, nhấp vào Xác thực Gmail OAuth hoặc Gmail (trong phần Xác thực bằng hoặc Connection). Cuối cùng, nhấp vào Kết nối tài khoản Gmail của bạn.

Một cửa sổ mới có nhãn Google mở ra để hoàn tất quy trình ủy quyền. Chọn địa chỉ email thích hợp đang được cấu hình trong SoOn.

Nếu địa chỉ email là tài khoản cá nhân thì một bước bổ sung sẽ xuất hiện, vì vậy hãy nhấp vào Tiếp tục để cho phép xác minh và kết nối tài khoản Gmail với SoOn.

Sau đó, cho phép SoOn truy cập tài khoản Google bằng cách nhấp vào Continue hoặc Cho phép. Sau đó, trang sẽ điều hướng trở lại máy chủ email gửi đi mới được cấu hình trong SoOn. Cấu hình tự động tải mã thông báo trong SoOn và thẻ ghi Gmail Token Valid xuất hiện màu xanh lục.

Cuối cùng, 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 SoOn hiện có thể gửi email an toàn, bảo mật thông qua Google bằng xác thực OAuth.

Câu hỏi thường gặp về Google OAuth¶

Trạng thái xuất bản VS thử nghiệm sản xuất¶

Chọn Production làm Trạng thái xuất bản (thay vì Testing) sẽ hiển thị thông báo cảnh báo sau:

OAuth được giới hạn ở 100 lần đăng nhập trong phạm vi nhạy cảm.

Để khắc phục cảnh báo này, hãy điều hướng đến Nền tảng API của Google. Nếu Trạng thái xuất bản là Đang sản xuất, hãy nhấp vào Quay lại thử nghiệm để khắc phục sự cố.

Không có người dùng thử nghiệm nào được thêm vào¶

Nếu không có người dùng thử nghiệm nào được thêm vào màn hình đồng ý OAuth thì lỗi truy cập 403 bị từ chối sẽ xuất hiện.

Để sửa lỗi này, hãy quay lại Màn hình đồng ý OAuth trong APIs & Services và thêm (những) người dùng thử nghiệm vào ứng dụng. Thêm email mà bạn đang định cấu hình trong SoOn.

Mô-đun Gmail chưa được cập nhật¶

Nếu mô-đun Google Gmail trong SoOn chưa được cập nhật lên phiên bản mới nhất thì thông báo lỗi Forbidden sẽ xuất hiện.

Bị cấm bạn không có quyền truy cập vào tài nguyên được yêu cầu.

Để sửa lỗi này, hãy đi tới mô-đun Ứng dụng và xóa các cụm từ tìm kiếm. Sau đó, tìm kiếm Gmail hoặc Google và nâng cấp mô-đun Google Gmail. Cuối cùng, nhấp vào ba dấu chấm ở phía trên bên phải của mô-đun và chọn Upgrade.

Loại ứng dụng¶

Khi tạo thông tin xác thực (OAuth ID khách hàng và Bí mật khách hàng), nếu Desktop App được chọn cho Loại ứng dụng, thì Lỗi ủy quyền sẽ xuất hiện.

Để sửa lỗi này, hãy xóa thông tin xác thực đã tạo và tạo thông tin xác thực mới, chọn Web Application cho Ứng dụngType. Sau đó, trong URI chuyển hướng được ủy quyền, hãy nhấp vào ADD URI và nhập: https://yourdbname.odoo.com/google_gmail/confirm vào trường, nhớ thay thế yourdbname trong URL có tên cơ sở dữ liệu SoOn.