Những ứng dụng OAuth của Google yêu cầu một số phạm vi OAuth nhạy cảm nhất định sẽ phải được Google xác minh.
Nếu bạn không xác minh ứng dụng OAuth của dự án tập lệnh, thì người dùng bên ngoài miền của bạn sẽ thấy màn hình ứng dụng chưa được xác minh khi họ cố gắng cấp quyền cho tập lệnh của bạn. Quy trình uỷ quyền chưa được xác minh cho phép những người dùng này uỷ quyền và sử dụng các ứng dụng chưa được xác minh, nhưng chỉ sau khi xác nhận rằng họ hiểu rõ các rủi ro. Tổng số người dùng ứng dụng chưa được xác minh cũng bị giới hạn.
Để biết thêm thông tin, hãy xem các bài viết sau:
- Ứng dụng chưa được xác minh
- Câu hỏi thường gặp về quy trình Xác minh ứng dụng qua OAuth
- Dịch vụ API của Google: Chính sách dữ liệu người dùng
Thay đổi này áp dụng cho các ứng dụng web OAuth của Google, bao gồm cả những ứng dụng mà tất cả dự án Apps Script sử dụng. Bằng cách xác minh ứng dụng với Google, bạn có thể xoá màn hình ứng dụng chưa được xác minh khỏi quy trình uỷ quyền và giúp người dùng yên tâm rằng ứng dụng của bạn không độc hại.
Ứng dụng chưa được xác minh
Các tiện ích bổ sung, ứng dụng web và hoạt động triển khai khác (chẳng hạn như ứng dụng sử dụng API Apps Script) có thể cần được xác minh.
Khả năng áp dụng
Nếu ứng dụng dùng phạm vi OAuth nhạy cảm, thì màn hình ứng dụng chưa được xác minh có thể xuất hiện trong quy trình uỷ quyền. Sự hiện diện của dịch vụ này (và quy trình uỷ quyền ứng dụng chưa được xác minh) phụ thuộc vào tài khoản mà bạn phát hành ứng dụng và tài khoản nào đang cố gắng dùng ứng dụng. Ví dụ: các ứng dụng được phát hành trong một tổ chức Google Workspace cụ thể sẽ không dẫn đến quy trình uỷ quyền ứng dụng chưa được xác minh cho các tài khoản trong miền đó, ngay cả khi ứng dụng chưa được xác minh.
Bảng sau đây minh hoạ những tình huống dẫn đến quy trình uỷ quyền ứng dụng chưa được xác minh:
| Khách hàng đã được xác minh | Nhà xuất bản là một tài khoản Google Workspace của khách hàng A | Tập lệnh nằm trong bộ nhớ dùng chung của khách hàng A | Nhà xuất bản là một tài khoản Gmail | |
|---|---|---|---|---|
| Người dùng là một tài khoản Google Workspace của khách hàng A | Quy trình xác thực thông thường | Quy trình xác thực thông thường | Quy trình xác thực thông thường | Quy trình xác thực chưa được xác minh |
| Người dùng là tài khoản Google Workspace không phải của khách hàng A | Quy trình xác thực thông thường | Quy trình xác thực chưa được xác minh | Quy trình xác thực chưa được xác minh | Quy trình xác thực chưa được xác minh |
| Người dùng là một tài khoản Gmail1 | Quy trình xác thực thông thường | Quy trình xác thực chưa được xác minh | Quy trình xác thực chưa được xác minh | Quy trình xác thực chưa được xác minh |
1Mọi tài khoản Gmail, bao gồm cả tài khoản dùng để phát hành ứng dụng.
Giới hạn người dùng
Số lượng người dùng có thể uỷ quyền cho một ứng dụng thông qua quy trình ứng dụng chưa được xác minh sẽ được giới hạn để hạn chế hành vi sai trái có thể xảy ra. Xem bài viết Giới hạn về người dùng đối với ứng dụng OAuth để biết thông tin chi tiết.
Đang yêu cầu xác minh
Bạn có thể yêu cầu xác minh ứng dụng OAuth mà ứng dụng của bạn sử dụng và dự án Cloud Platform (GCP) liên kết với ứng dụng đó. Sau khi ứng dụng của bạn được xác minh, người dùng sẽ không còn thấy màn hình ứng dụng chưa được xác minh nữa. Ngoài ra, ứng dụng của bạn sẽ không còn phải tuân theo giới hạn người dùng nữa.
Yêu cầu
Để gửi ứng dụng OAuth cho Google xác minh, bạn phải đáp ứng các yêu cầu sau:
Bạn phải sở hữu một trang web trên một miền. Trang web phải lưu trữ các trang cho phép truy cập công khai, trong đó mô tả ứng dụng của bạn và chính sách quyền riêng tư của ứng dụng. Bạn cũng phải xác minh quyền sở hữu đối với trang web với Google.
Dự án Google Cloud mà dự án tập lệnh của bạn sử dụng phải là một dự án Google Cloud tiêu chuẩn mà bạn có quyền chỉnh sửa. Nếu tập lệnh của bạn đang sử dụng dự án mặc định trên Google Cloud, bạn phải chuyển sang dự án Google Cloud chuẩn.
Ngoài ra, bạn phải có các thành phần bắt buộc sau:
- Tên ứng dụng. Tên của ứng dụng; tên này sẽ hiển thị trên màn hình đồng ý. Tên này phải khớp với tên dùng cho ứng dụng ở các vị trí khác, chẳng hạn như trên trang thông tin trên Google Workspace Marketplace dành cho các ứng dụng đã phát hành.
- Biểu trưng của ứng dụng. Hình ảnh JPEG, PNG hoặc BMP của biểu trưng ứng dụng để sử dụng trong màn hình xin phép. Kích thước tệp không được vượt quá 1MB.
- Email hỗ trợ. Đây là email hiển thị trên màn hình xin phép để người dùng liên hệ nếu cần được hỗ trợ về ứng dụng. Đó có thể là địa chỉ email của bạn hoặc một nhóm trên Google Groups mà bạn sở hữu hoặc quản lý.
- Phạm vi. Danh sách tất cả phạm vi mà ứng dụng của bạn dùng. Bạn có thể xem phạm vi của mình trong trình chỉnh sửa Apps Script.
- Miền được uỷ quyền. Đây là danh sách các miền chứa thông tin về ứng dụng của bạn. Tất cả đường liên kết đến ứng dụng của bạn (chẳng hạn như trang chính sách quyền riêng tư bắt buộc của ứng dụng) phải được lưu trữ trên các miền được uỷ quyền.
- URL trang chủ của ứng dụng. Vị trí của một trang chủ mô tả ứng dụng. Vị trí này phải được lưu trữ trên một miền được uỷ quyền.
- URL chính sách quyền riêng tư của ứng dụng. Vị trí của một trang mô tả chính sách quyền riêng tư của ứng dụng. Vị trí này phải được lưu trữ trên miền được uỷ quyền.
Ngoài các thành phần bắt buộc ở trên, bạn có thể tuỳ ý cung cấp URL Điều khoản dịch vụ của ứng dụng trỏ đến trang mô tả điều khoản dịch vụ của ứng dụng. Nếu được cung cấp, vị trí này phải nằm trong miền được uỷ quyền.
Các bước
- Xác minh quyền sở hữu tất cả các miền được cấp phép mà bạn dùng để lưu trữ chính sách quyền riêng tư của dự án tập lệnh và các thông tin khác nếu bạn chưa thực hiện việc này. Chủ sở hữu đã xác minh của miền phải là người chỉnh sửa hoặc chủ sở hữu của dự án tập lệnh.
- Trong dự án Apps Script, hãy nhấp vào biểu tượng Tổng quan . Trong phần Project OAuth Scopes (Phạm vi OAuth của dự án), hãy sao chép các phạm vi mà dự án tập lệnh của bạn sử dụng.
Hoàn tất màn hình xin phép bằng OAuth cho dự án Google Cloud của ứng dụng bằng cách sử dụng các thành phần văn bản và URL mà bạn đã thu thập.
- Liệt kê Miền được uỷ quyền, nơi lưu trữ thông tin về ứng dụng (chẳng hạn như chính sách quyền riêng tư của ứng dụng).
Để thêm phạm vi ứng dụng, hãy nhấp vào Add or Remove Scopes (Thêm hoặc xoá phạm vi). Hộp thoại xuất hiện sẽ cố gắng tự động phát hiện phạm vi cho những API mà bạn đã bật trong bảng điều khiển Google Cloud (chẳng hạn như các dịch vụ nâng cao). Bạn có thể chọn phạm vi trong danh sách này bằng cách đánh dấu vào các hộp tương ứng.
Danh sách được phát hiện tự động này không phải lúc nào cũng bao gồm các phạm vi mà các dịch vụ tích hợp sẵn của Apps Script sử dụng. Bạn phải nhập các phạm vi này trong phần Thêm phạm vi theo cách thủ công.
Khi hoàn tất, hãy nhấp vào Cập nhật.
Khi bạn đã nhập tất cả các thông tin bắt buộc, hãy nhấp vào Lưu.
Nhấp vào Gửi để xác minh để bắt đầu yêu cầu xác minh.
Hầu hết các yêu cầu xác minh đều sẽ được phản hồi trong vòng 24 đến 72 giờ. Bạn có thể kiểm tra Trạng thái xác minh ở đầu biểu mẫu màn hình xin phép OAuth. Khi xác minh ứng dụng OAuth của bạn được xác nhận, ứng dụng của bạn sẽ được xác minh.