Thiết lập OAuth cho ứng dụng Android

Home API sử dụng OAuth 2.0 để cấp quyền truy cập vào các thiết bị trong cấu trúc. OAuth cho phép người dùng cấp quyền cho một ứng dụng hoặc dịch vụ mà không cần tiết lộ thông tin đăng nhập.

Nếu đã có một ứng dụng OAuth đã xác minh (ví dụ: từ một ứng dụng đã phát hành), bạn có thể sử dụng ứng dụng đó để kiểm thử Home API mà không cần thiết lập ứng dụng mới. Để biết thêm thông tin, hãy xem phần Nếu bạn có một ứng dụng OAuth hiện có.

Ký ứng dụng

Trước tiên, hãy tạo chứng chỉ gỡ lỗi bằng cách chạy ứng dụng trong Android Studio. Khi bạn chạy hoặc gỡ lỗi một ứng dụng trong Android Studio, ứng dụng này sẽ tự động tạo một chứng chỉ gỡ lỗi dành cho quá trình phát triển và gỡ lỗi. Hãy xem bài viết Android Studio: Sign your debug build để biết thông tin giải thích đầy đủ.

Sau khi ứng dụng đang chạy:

1. Kết nối thiết bị di động với máy cục bộ. Android Studio sẽ liệt kê các thiết bị đã kết nối theo số kiểu. Chọn thiết bị của bạn trong danh sách, sau đó nhấp vào Chạy dự án. Thao tác này sẽ tạo và cài đặt Ứng dụng mẫu trên thiết bị di động của bạn.

   Để biết hướng dẫn chi tiết hơn, hãy xem bài viết Chạy ứng dụng trên thiết bị phần cứng trên trang web Android Developers.

2. Dừng ứng dụng đang chạy.

3. Lấy dấu vân tay SHA-1 của chứng chỉ gỡ lỗi bằng cách làm theo hướng dẫn chi tiết trong phần Thiết lập OAuth 2.0 / Ứng dụng gốc/ Android trên trang web Trợ giúp của Google Cloud Console.

Thiết lập màn hình xin phép bằng OAuth

1. Trong bảng điều khiển Cloud, hãy chuyển đến trang tổng quan về bộ chọn dự án rồi chọn dự án mà bạn muốn dùng để tạo thông tin xác thực OAuth.
2. Chuyển đến trang APIs and Services (API và Dịch vụ), rồi nhấp vào Credentials (Thông tin xác thực) trong trình đơn điều hướng.

3. Nếu bạn chưa định cấu hình màn hình xin phép cho dự án Google Cloud này, thì nút Configure consent screen (Định cấu hình màn hình xin phép) sẽ xuất hiện. Trong trường hợp đó, hãy định cấu hình màn hình xin phép bằng quy trình sau. Nếu không, hãy chuyển sang phần tiếp theo.

   1. Nhấp vào Configure consent screen (Định cấu hình màn hình xin phép). Trang OAuth consent screen (Màn hình xin phép bằng OAuth) sẽ xuất hiện.
   2. Tuỳ thuộc vào trường hợp sử dụng, hãy chọn Internal (Nội bộ) hoặc External (Bên ngoài), rồi nhấp vào Create (Tạo). Ngăn OAuth consent screen (Màn hình xin phép bằng OAuth) sẽ xuất hiện.
   3. Nhập thông tin trên App information page (Trang thông tin ứng dụng) theo hướng dẫn trên màn hình, rồi nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Scopes (Phạm vi) sẽ xuất hiện.
   4. Bạn không cần thêm phạm vi nào, vì vậy, hãy nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Test users (Người dùng thử nghiệm) sẽ xuất hiện.
   5. Nhấp vào Audience (Đối tượng) rồi nhấp vào nút + ADD USERS (+ THÊM NGƯỜI DÙNG).
   6. Nhập địa chỉ email của người dùng thử nghiệm rồi nhấp vào nút SAVE (LƯU).
   7. Nhấp vào Save and continue (Lưu và tiếp tục). Ngăn Summary (Tóm tắt) sẽ xuất hiện.
   8. Xem lại thông tin về màn hình xin phép bằng OAuth, rồi nhấp vào Back to dashboard (Quay lại trang tổng quan).

Hãy xem bài viết Thiết lập màn hình xin phép bằng OAuth screen trên trang web Trợ giúp của Google Cloud Console để biết thông tin chi tiết đầy đủ.

Đăng ký ứng dụng và tạo thông tin xác thực

Để đăng ký ứng dụng cho OAuth 2.0 và tạo thông tin xác thực OAuth, hãy làm theo các hướng dẫn được cung cấp trong Thiết lập OAuth 2.0. Bạn cần cho biết loại ứng dụng là native/Android app (ứng dụng gốc/ứng dụng Android).

Thêm dấu vân tay SHA-1 mà bạn nhận được khi ký ứng dụng vào ứng dụng OAuth mà bạn thiết lập trên bảng điều khiển Cloud bằng cách làm theo hướng dẫn trong Thiết lập OAuth 2.0 / Ứng dụng gốc trên trang web Trợ giúp của Google Cloud Console.

Khi thiết bị di động của bạn được kết nối với máy cục bộ, hãy chọn thiết bị của bạn trong danh sách, sau đó nhấp vào Run project (Chạy dự án) một lần nữa để chạy. Để biết hướng dẫn chi tiết hơn, hãy xem Chạy ứng dụng trên thiết bị phần cứng trên trang web Android Developers.

Nếu bạn có một ứng dụng OAuth hiện có

Nếu đã có một ứng dụng OAuth đã xác minh cho một ứng dụng đã phát hành, bạn có thể sử dụng ứng dụng OAuth hiện có để kiểm thử Home API.

Bạn không cần đăng ký Google Home Developer Console để kiểm thử và sử dụng Home API. Tuy nhiên, bạn vẫn cần đăng ký Developer Console đã được phê duyệt để phát hành ứng dụng, ngay cả khi bạn có một ứng dụng OAuth đã xác minh từ một quy trình tích hợp khác.

Bạn cần lưu ý những điều sau:

• Có giới hạn 100 người dùng khi sử dụng một ứng dụng OAuth hiện có. Để biết thông tin về cách thêm người dùng thử nghiệm, hãy tham khảo bài viết Thiết lập màn hình xin phép bằng OAuth screen. Không phụ thuộc vào quy trình xác minh OAuth, Home API áp đặt giới hạn 100 người dùng có thể cấp quyền cho ứng dụng của bạn. Giới hạn này sẽ được gỡ bỏ sau khi bạn hoàn tất quy trình đăng ký Developer Console.

• Developer Console đăng ký nên được gửi đi để phê duyệt khi bạn đã sẵn sàng hạn chế các quyền cấp loại thiết bị thông qua OAuth để chuẩn bị cập nhật ứng dụng bằng Home API.

Đối với các ứng dụng Google Cloud vẫn đang chờ xác minh OAuth, người dùng không thể hoàn tất quy trình OAuth cho đến khi quá trình xác minh hoàn tất. Các nỗ lực cấp quyền sẽ không thành công và gặp lỗi sau:

Access blocked: <Project Name> has not completed the Google verification process.