API xác thực web

Nhà tích hợp phải triển khai một máy chủ web để chuyển hướng người dùng cho mục đích xác thực. Quy trình xác thực này là một phương thức khác, nhưng có cùng mục đích với quy trình xác thực do tính năng xác thực Android cung cấp. Nhà cung cấp dịch vụ lưu trữ web này phải có trang web thân thiện với thiết bị di động.

Nhà cung cấp dịch vụ lưu trữ web phải xác định yêu cầu web dành cho thiết bị di động và yêu cầu web dành cho máy tính dựa trên giá trị tiêu đề tác nhân người dùng. Trang được phân phối theo yêu cầu trên web dành cho thiết bị di động phải thân thiện với web dành cho thiết bị di động trên Android và iOS. Ngoài giá trị tiêu đề tác nhân người dùng, ứng dụng sẽ không cung cấp cho bạn gợi ý nào khác về môi trường mà người dùng này đang đưa ra yêu cầu (máy tính để bàn hoặc web).

Máy chủ phải triển khai giao thức HTTPS bằng phương thức GET. Nhà tích hợp sẽ xác định đường dẫn và máy chủ lưu trữ. Trình tích hợp phải hỗ trợ độ dài URL 2.048 ký tự. Các dữ liệu này bao gồm giao thức, máy chủ lưu trữ, cổng, đường dẫn và tham số.

Tất cả thông số sẽ được mã hoá UTF-8 trước khi mã hoá URL.

Yêu cầu

Khi có yêu cầu, Google cung cấp các tham số URL sau đây:

Các trường
gspMajorVersion int

Số phiên bản lớn của yêu cầu này.

gspAuthenticationRequest AuthenticationRequest

Yêu cầu xác thực.

gspAssociationId string

Nếu có, lớp này chứa một giá trị nhận dạng mà trình tích hợp sử dụng để tra cứu thông tin xác thực cho người dùng được xác thực. Nếu không có mã này, người dùng có thể thay đổi thông tin nhận dạng tài khoản.

gspCallbackUrl string

URL để chuyển hướng người dùng đến nhằm hoàn tất quy trình xác thực trên Google. Giá trị này là URL được mã hoá.

Phản hồi

Sau khi hoàn tất quá trình xác thực, người dùng phải được chuyển hướng đến gspCallbackUrl bằng HTTPS GET. URL này phải có các tham số truy vấn sau:

Các trường
gspResult int

100
Đã xác thực thành công.
201 Người dùng đã huỷ quy trình này theo cách thủ công và quy trình này cần bị huỷ.
202 Không xác thực được vì lý do nghiêm trọng và luồng phải bị huỷ.

gspAuthenticationResponse AuthenticationResponse

Phản hồi xác thực.