Đăng nhập bằng tài khoản được liên kết

Tính năng Liên kết Tài khoản Google giúp chủ sở hữu Tài khoản Google kết nối nhanh chóng, liền mạch và an toàn với các dịch vụ của bạn, đồng thời chia sẻ dữ liệu với Google.

Tính năng Đăng nhập bằng tài khoản được liên kết cho phép Đăng nhập bằng một lần chạm bằng Google đối với những người dùng đã liên kết Tài khoản Google của họ với dịch vụ của bạn. Điều này giúp cải thiện trải nghiệm cho người dùng vì họ có thể đăng nhập chỉ bằng một lần nhấp mà không cần nhập lại tên người dùng và mật khẩu. Điều này cũng làm giảm khả năng người dùng tạo tài khoản trùng lặp trên dịch vụ của bạn.

Yêu cầu

Để triển khai tính năng Đăng nhập bằng tài khoản được liên kết, bạn phải đáp ứng các yêu cầu sau:

• Bạn đã triển khai tính năng Liên kết OAuth với Tài khoản Google hỗ trợ quy trình mã uỷ quyền OAuth 2.0. Quá trình triển khai OAuth của bạn phải bao gồm các điểm cuối sau:
  • điểm cuối uỷ quyền để xử lý các yêu cầu uỷ quyền.
  • điểm cuối mã thông báo để xử lý yêu cầu cấp quyền truy cập và làm mới mã thông báo.
  • điểm cuối userinfo để truy xuất thông tin tài khoản cơ bản về người dùng được liên kết. Thông tin này sẽ hiển thị cho người dùng trong quá trình Đăng nhập bằng tài khoản được liên kết.
• Bạn có một ứng dụng Android.

Cách hoạt động

Điều kiện tiên quyết : Người dùng đã liên kết Tài khoản Google của họ với tài khoản trên dịch vụ của bạn.

1. Bạn chọn hiển thị các tài khoản được liên kết trong quy trình Đăng nhập một lần chạm.
2. Người dùng sẽ thấy lời nhắc Đăng nhập một lần chạm cùng với lựa chọn đăng nhập vào dịch vụ của bạn bằng tài khoản đã liên kết.
3. Nếu người dùng chọn tiếp tục bằng tài khoản đã liên kết, Google sẽ gửi một yêu cầu đến điểm cuối mã thông báo của bạn để lưu mã uỷ quyền. Yêu cầu này chứa mã truy cập của người dùng do dịch vụ của bạn phát hành và mã uỷ quyền của Google.
4. Bạn trao đổi mã uỷ quyền của Google để lấy mã thông báo mã nhận dạng của Google chứa thông tin về Tài khoản Google của người dùng.
5. Ứng dụng của bạn cũng nhận được mã thông báo nhận dạng khi quy trình này kết thúc và bạn so khớp mã thông báo này với giá trị nhận dạng người dùng trong mã thông báo nhận dạng mà máy chủ của bạn đã nhận được để đăng nhập người dùng vào ứng dụng.

Triển khai tính năng Đăng nhập bằng tài khoản được liên kết trong ứng dụng Android

Để hỗ trợ tính năng Đăng nhập bằng tài khoản được liên kết trên ứng dụng Android, hãy làm theo hướng dẫn trong Hướng dẫn triển khai trên Android.

Xử lý các yêu cầu mã uỷ quyền của Google

Google gửi một yêu cầu POST đến điểm cuối mã thông báo của bạn để lưu mã uỷ quyền mà bạn trao đổi cho mã thông báo nhận dạng của người dùng. Yêu cầu này chứa mã truy cập của người dùng và mã uỷ quyền OAuth2 do Google phát hành.

Trước khi lưu mã uỷ quyền, bạn phải xác minh mã truy cập mà bạn đã cấp cho Google, được xác định bằng client_id.

Yêu cầu HTTP

Yêu cầu mẫu

POST /token HTTP/1.1
Host: server.example.com
Content-Type: application/x-www-form-urlencoded

code=GOOGLE_AUTHORIZATION_CODE
&grant_type=urn:ietf:params:oauth:grant-type:reciprocal
&client_id=CLIENT_ID
&client_secret=CLIENT_SECRET
&access_token=ACCESS_TOKEN

Điểm cuối trao đổi mã thông báo của bạn phải có khả năng xử lý các tham số yêu cầu sau:

Điểm cuối trao đổi mã thông báo của bạn sẽ phản hồi yêu cầu POST bằng cách làm như sau:

• Xác minh access_token đã được cấp cho Google do client_id xác định.
• Phản hồi bằng phản hồi HTTP 200 (OK) nếu yêu cầu hợp lệ và mã xác thực được trao đổi thành công cho mã thông báo nhận dạng của Google hoặc mã lỗi HTTP nếu yêu cầu không hợp lệ.

Phản hồi HTTP

Thành công

Trả về mã trạng thái HTTP 200 OK

Mẫu phản hồi thành công

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache
{}

Lỗi

Trong trường hợp yêu cầu HTTP không hợp lệ, hãy phản hồi bằng một trong các mã lỗi HTTP sau:

Phản hồi lỗi phải chứa các trường sau :

Phản hồi mẫu về lỗi 400

HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
  "error": "invalid_request",
  "error_description": "Request was missing the 'access_token' parameter."
}

Trao đổi mã uỷ quyền cho mã thông báo nhận dạng

Bạn sẽ cần trao đổi mã uỷ quyền mà bạn nhận được để lấy mã thông báo mã nhận dạng Google chứa thông tin về Tài khoản Google của người dùng.

Để trao đổi mã uỷ quyền lấy mã thông báo mã nhận dạng Google, hãy gọi điểm cuối https://oauth2.googleapis.com/token và đặt các tham số sau:

Yêu cầu mẫu

POST /oauth2/v4/token HTTP/1.1
Host: www.googleapis.com
Content-Type: application/x-www-form-urlencoded

code=GOOGLE_AUTHORIZATION_CODE
&grant_type=authorization_code
&client_id=GOOGLE_CLIENT_ID
&client_secret=GOOGLE_CLIENT_SECRET

Google phản hồi yêu cầu này bằng cách trả về một đối tượng JSON chứa mã truy cập có thời hạn ngắn và mã làm mới.

Phản hồi chứa các trường sau:

Nội dung phản hồi mẫu

HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8

{
  "access_token": "Google-access-token",
  "id_token": "Google-ID-token",
  "expires_in": 3599,
  "token_type": "Bearer",
  "scope": "openid",
  "refresh_token": "Google-refresh-token"
}


POST /oauth2/v4/token HTTP/1.1
Host: www.googleapis.com
Content-Type: application/x-www-form-urlencoded

code=Google authorization code
&grant_type=authorization_code
&client_id=Google client id
&client_secret=Google client secret

Xác thực phản hồi Mã thông báo nhận dạng