Xác minh ứng dụng khách OAuth

Những ứng dụng OAuth của Google yêu cầu một số phạm vi OAuth nhạy cảm 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 cho phép 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 cho những ứng dụng chưa được xác minh và sử dụng những ứng dụng đó, nhưng chỉ sau khi xác nhận rằng họ hiểu rõ 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:

 

Màn hình ứng dụng chưa được xác minh
Hình 1: Màn hình ứng dụng chưa được xác minh
Quy trình uỷ quyền ứng dụng chưa được xác minh
Hình 2: Quy trình uỷ quyền ứng dụng chưa được xác minh

 

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 được tất cả dự án Apps Script sử dụng. Khi xác minh ứng dụng qua 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 gây hại.

Ứng dụng chưa được xác minh

Tiện ích bổ sung, ứng dụng web và các phương thức triển khai khác (chẳng hạn như ứng dụng sử dụng Apps Script API) có thể cần được xác minh.

Khả năng áp dụng

Nếu ứng dụng dùng các 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 tệp 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 phát hành ứng dụng và tài khoản nào đang tìm cách dùng ứng dụng đó. Ví dụ: các ứng dụng được xuất bản 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à tài khoản Google Workspace của khách hàng A Tập lệnh này nằm trong bộ nhớ dùng chung của khách hàng A Nhà xuất bản là 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 không phải là tài khoản Google Workspace không phải là 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

1Bất kỳ tài khoản Gmail nào, 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ế khả năng xảy ra hành vi sai trái. Vui lòng xem bài viết Giới hạn người dùng ứng dụng OAuth để biết thông tin chi tiết.

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 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 quy trình xác minh, bạn phải đáp ứng các yêu cầu sau:

  1. 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 có thể truy cập công khai, trong đó mô tả ứng dụng 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 trang web với Google.

  2. Dự án Google Cloud mà dự án tập lệnh của bạn sử dụng phải là 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 Google Cloud mặc định, thì bạn phải chuyển sang một dự án Google Cloud tiêu 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 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ư trang thông tin trên Google Workspace Marketplace cho các ứng dụng đã phát hành.
  • Biểu trưng ứng dụng. Hình ảnh biểu trưng của ứng dụng JPEG, PNG hoặc BMP để sử dụng trong màn hình đồng ý. Kích thước tệp không được vượt quá 1MB.
  • Email hỗ trợ. Đây là email xuất hiện 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ả cá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 của ứng dụng (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 cấp phép.
  • URL trang chủ ứng dụng. Vị trí của trang chủ mô tả ứng dụng của bạn. 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 cấp phép.

Ngoài các thành phần bắt buộc ở trên, bạn cũng có thể cung cấp URL của điều khoản dịch vụ của ứng dụng trỏ đến một 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

  1. Nếu bạn chưa làm như vậy, hãy xác minh quyền sở hữu tất cả các miền được cấp phép mà bạn sử 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. 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.
  2. Trong dự án Apps Script, hãy nhấp vào biểu tượng Overview (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.
  3. 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 thành phần văn bản và URL bạn đã thu thập.

    1. Liệt kê Các miền được uỷ quyền lưu trữ thông tin của ứng dụng (chẳng hạn như chính sách quyền riêng tư).
    2. Để thêm phạm vi ứng dụng, hãy nhấp vào Thêm hoặc xoá phạm vi. Hộp thoại kết quả sẽ cố gắng tự động phát hiện phạm vi cho các API mà bạn đã bật trong bảng điều khiển Google Cloud (chẳng hạn như dịch vụ nâng cao). Bạn có thể chọn các 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 bạn hoàn tất, hãy nhấp vào Cập nhật.

  4. 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.

  5. Nhấp vào Gửi để xác minh để bắt đầu một yêu cầu xác minh.

Hầu hết các yêu cầu xác minh đều được phản hồi trong vòng từ 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 bằng OAuth. Khi quá trình xác minh ứng dụng OAuth được xác nhận, ứng dụng của bạn sẽ được xác minh.