API การตรวจสอบสิทธิ์ผ่านเว็บ

ตัวรวมต้องใช้โฮสต์เว็บในการเปลี่ยนเส้นทางผู้ใช้เพื่อวัตถุประสงค์ในการตรวจสอบสิทธิ์ การตรวจสอบสิทธิ์นี้แตกต่างกัน แต่มีวัตถุประสงค์เดียวกับการตรวจสอบสิทธิ์ที่การตรวจสอบสิทธิ์ของ Android มีให้ โฮสต์เว็บนี้ต้องมีเว็บไซต์ที่เหมาะกับอุปกรณ์เคลื่อนที่

โฮสต์เว็บต้องกำหนดคำขอเว็บบนอุปกรณ์เคลื่อนที่เทียบกับคำขอเว็บบนเดสก์ท็อปตามค่าส่วนหัว User Agent หน้าที่แสดงในคำขอเว็บบนอุปกรณ์เคลื่อนที่ต้องเหมาะกับอุปกรณ์เคลื่อนที่ทั้งบน Android และ iOS นอกจากค่าส่วนหัว User Agent แล้ว ไคลเอ็นต์จะไม่ให้คำแนะนำอื่นเกี่ยวกับสภาพแวดล้อมที่ผู้ใช้รายนี้ส่งคำขอ (เดสก์ท็อปหรือเว็บ)

เซิร์ฟเวอร์ต้องใช้โปรโตคอล HTTPS โดยใช้ GET ผู้ผสานการทำงานเป็นผู้กำหนดเส้นทางและโฮสต์ ผู้ผสานการทำงานต้องรองรับ URL ที่มีความยาว 2,048 อักขระ ซึ่งรวมถึงสคีม โฮสต์ พอร์ต เส้นทาง และพารามิเตอร์

พารามิเตอร์ทั้งหมดจะได้รับการเข้ารหัส UTF-8 ก่อนที่จะเข้ารหัส URL

ส่งคำขอ

เมื่อร้องขอ Google จะให้พารามิเตอร์ต่อไปนี้เป็นพารามิเตอร์ของ URL

ช่อง
gspMajorVersion	int หมายเลขเวอร์ชันหลักสำหรับคำขอนี้
gspAuthenticationRequest	AuthenticationRequest คำขอตรวจสอบสิทธิ์
gspAssociationId	string หากมี ข้อมูลนี้จะมีตัวระบุที่ผู้ผสานการทำงานระบบใช้เพื่อค้นหาข้อมูลเข้าสู่ระบบสำหรับผู้ใช้ที่ทดสอบ หากไม่เห็นส่วนนี้ ผู้ใช้จะมีตัวเลือกในการเปลี่ยนการระบุบัญชี
gspCallbackUrl	string URL ที่จะเปลี่ยนเส้นทางผู้ใช้ไป เพื่อดำเนินการตามขั้นตอนการตรวจสอบสิทธิ์ให้เสร็จสมบูรณ์ใน Google ค่านี้มีการเข้ารหัส URL

คำตอบ

เมื่อการตรวจสอบสิทธิ์เสร็จสมบูรณ์แล้ว จะต้องเปลี่ยนเส้นทางผู้ใช้ไปยัง gspCallbackUrl โดยใช้ HTTPS GET URL นี้ต้องมีพารามิเตอร์การค้นหาต่อไปนี้

ช่อง
gspResult	int 100 การตรวจสอบสิทธิ์สำเร็จ 201 ผู้ใช้ยกเลิกการโฟลว์ด้วยตนเองและควรล้มเลิกกระบวนการดังกล่าว 202 การตรวจสอบสิทธิ์ล้มเหลวด้วยเหตุผลที่ร้ายแรงและควรล้มเลิกกระบวนการดังกล่าว
gspAuthenticationResponse	AuthenticationResponse การตอบกลับการตรวจสอบสิทธิ์