#Cấu hình Google

This feature is provided by the commercial plugin «Quản lý email», please purchase to use

#Điều kiện tiên quyết

Để người dùng có thể kết nối tài khoản Google Mail của họ với NocoBase, NocoBase phải được triển khai trên một máy chủ có khả năng truy cập các dịch vụ của Google, vì hệ thống backend sẽ gọi API của Google.

#Đăng ký tài khoản

1. Mở https://console.cloud.google.com/welcome để truy cập Google Cloud.
2. Lần đầu truy cập, quý vị cần đồng ý với các điều khoản và điều kiện liên quan.

#Tạo ứng dụng

1. Nhấp vào "Select a project" ở phía trên cùng.

2. Nhấp vào nút "NEW PROJECT" trong cửa sổ bật lên.

3. Điền thông tin dự án.

4. Sau khi dự án được tạo, hãy chọn dự án đó.

#Bật Gmail API

1. Nhấp vào nút "APIs & Services".

2. Truy cập bảng điều khiển APIs & Services.

3. Tìm kiếm "mail".

4. Nhấp vào nút "ENABLE" để bật Gmail API.

#Cấu hình màn hình đồng ý OAuth

1. Nhấp vào menu "OAuth consent screen" ở bên trái.

2. Chọn "External".

3. Điền thông tin dự án (thông tin này sẽ hiển thị trên trang ủy quyền) và nhấp lưu.

4. Điền thông tin liên hệ nhà phát triển (Developer contact information) và nhấp tiếp tục.

5. Nhấp tiếp tục.

6. Thêm người dùng thử nghiệm để kiểm tra trước khi ứng dụng được phát hành.

7. Nhấp tiếp tục.

8. Xem lại thông tin tổng quan và quay lại bảng điều khiển.

#Tạo thông tin xác thực (Credentials)

1. Nhấp vào menu "Credentials" ở bên trái.

2. Nhấp vào nút "CREATE CREDENTIALS" và chọn "OAuth client ID".

3. Chọn "Web application".

4. Điền thông tin ứng dụng.

5. Nhập tên miền triển khai cuối cùng của dự án (ví dụ ở đây là địa chỉ thử nghiệm của NocoBase).

6. Thêm URI chuyển hướng được ủy quyền. URI này phải là tên miền + "/admin/settings/mail/oauth2". Ví dụ: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. Nhấp tạo để xem thông tin OAuth.

8. Sao chép Client ID và Client secret rồi dán vào trang cấu hình email.

9. Nhấp lưu để hoàn tất cấu hình.

#Phát hành ứng dụng

Sau khi hoàn tất quy trình trên và kiểm tra các tính năng như đăng nhập ủy quyền của người dùng thử nghiệm, gửi email, quý vị có thể phát hành ứng dụng.

1. Nhấp vào menu "OAuth consent screen".

2. Nhấp vào nút "EDIT APP", sau đó nhấp vào nút "SAVE AND CONTINUE" ở phía dưới.

3. Nhấp vào nút "ADD OR REMOVE SCOPES" để chọn phạm vi quyền của người dùng.

4. Tìm kiếm "Gmail API", sau đó chọn "Gmail API" (xác nhận giá trị Scope là Gmail API với "https://mail.google.com/").

5. Nhấp vào nút "UPDATE" ở phía dưới để lưu.

6. Nhấp vào nút "SAVE AND CONTINUE" ở cuối mỗi trang, và cuối cùng nhấp vào nút "BACK TO DASHBOARD" để quay lại trang bảng điều khiển.

7. Nhấp vào nút "PUBLISH APP". Một trang xác nhận phát hành sẽ xuất hiện, liệt kê các thông tin cần thiết để phát hành. Sau đó, nhấp vào nút "CONFIRM".

8. Quay lại trang bảng điều khiển, quý vị sẽ thấy trạng thái phát hành là "In production".

9. Nhấp vào nút "PREPARE FOR VERIFICATION", điền các thông tin bắt buộc và nhấp vào nút "SAVE AND CONTINUE" (dữ liệu trong hình chỉ mang tính chất minh họa).

10. Tiếp tục điền các thông tin cần thiết (dữ liệu trong hình chỉ mang tính chất minh họa).

11. Nhấp vào nút "SAVE AND CONTINUE".

12. Nhấp vào nút "SUBMIT FOR VERIFICATION" để gửi yêu cầu xác minh.

13. Chờ kết quả phê duyệt.

14. Trong trường hợp yêu cầu phê duyệt chưa được thông qua, người dùng có thể nhấp vào liên kết không an toàn (unsafe link) để ủy quyền và đăng nhập.