ข้ามไปที่เนื้อหา

เริ่มต้น

การเข้าสู่ระบบผ่านเว็บ เป็นฟีเจอร์ที่อนุญาตให้ผู้ใช้เข้าสู่ระบบไปยัง IdP ผ่านเว็บ โปรดดูที่ IdP ที่รองรับการเข้าสู่ระบบผ่านเว็บ.

โดยใช้ API Web Login ผู้ใช้สามารถใช้งานการเข้าสู่ระบบ IdP บนเว็บไซต์ภายนอก (เช่น เว็บไซต์ชุมชนที่ดำเนินการโดยนักพัฒนาเกม) แทนแอปพลิเคชัน ขณะนี้ API Web Login ได้รวม Web Login v1 และ Web Login v2 ที่มีอยู่แล้ว

Warning
  • วิธีการเรียกใช้ Web Login API รุ่น v2 และ v1 แยกกันในขณะนี้ไม่ได้รับการสนับสนุน หากต้องการรับการสนับสนุนอย่างต่อเนื่อง คุณต้องใช้ Web Login API แบบรวม
  • Web Login API แบบรวมไม่แยกแยะระหว่างรุ่นต่างๆ
Note

เพื่อใช้ API การเข้าสู่ระบบทางเว็บ คุณต้องทำการตั้งค่าที่เกี่ยวข้องในคอนโซล Hive สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ IdP ที่รองรับการเข้าสู่ระบบทางเว็บ ในคู่มือคอนโซลภายใต้ การรับรองความถูกต้อง > การตั้งค่าการเข้าสู่ระบบ.

วิธีการใช้ Web Login API

API การเข้าสู่ระบบเว็บจะแตกต่างกันไปตามการใช้งานขึ้นอยู่กับวัตถุประสงค์ของ 'web login AppID'

เมื่อวัตถุประสงค์ของ 'Web Login AppID' คือ 'ชุมชน' หรือ 'เว็บไซต์'

หากคุณเลือกวัตถุประสงค์ของ 'Web Login AppID' เป็นชุมชนหรือเว็บไซต์ใน App Center > AppID Management > ลงทะเบียน Web Login AppID ของ Hive console นักพัฒนาเกมจะใช้ Web Login API ดังนี้

  1. เรียกดูหน้าเข้าสู่ระบบ
  2. ใช้ค่าการตอบกลับของ API การตรวจสอบผู้ใช้และการดึงข้อมูลผู้ใช้ โดยเฉพาะ ตัวระบุ IdP (idp_index, idp_user_id) เป็นตัวระบุบัญชีผู้ใช้และเก็บไว้ในฐานข้อมูลของนักพัฒนา

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

อย่างไรก็ตาม เมื่อผู้ใช้เข้าถึงแอปเกมและเข้าสู่ระบบ จะมีการสร้าง PlayerID ซึ่งเป็นตัวระบุผู้ใช้เกม ดังนั้นจึงสามารถใช้เป็นตัวระบุบัญชีผู้ใช้ โดยแยกแยะออกจาก PlayerID ในค่าการตอบกลับของ API Verify and User Information Retrieval ใน user_info หรือ PlayerID ในค่าการตอบกลับของ API User Information Retrieval by Authentication API

Note

เกิดความขัดแย้งของบัญชีในสถานการณ์เช่นต่อไปนี้

  1. เข้าสู่ระบบด้วยการเข้าสู่ระบบเว็บเพื่อสร้าง IdP และ PlayerID เบื้องต้น
  2. หลังจากเข้าสู่ระบบเกมโดยใช้ Hive SDK ให้เชื่อมต่อการรวม IdP เพิ่มเติมในโปรไฟล์เกม
  3. เกิดความขัดแย้งของบัญชีเนื่องจาก PlayerID ได้ถูกสร้างขึ้นแล้วด้วยการเข้าสู่ระบบเว็บ ทำให้ผู้ใช้ต้องเลือกบัญชี

วัตถุประสงค์ของการใช้ 'Web Login AppID' คือสำหรับ 'Blockchain'

ในคอนโซล Hive เมื่อเลือก 'Blockchain' เป็นวัตถุประสงค์ของ 'Web Login AppID' ใน App Center > AppID Management > Web Login AppID Registration นักพัฒนาเกมจะใช้ Web Login API ดังนี้

  1. หน้าเข้าสู่ระบบ การเรียก API
  2. การตรวจสอบการเข้าสู่ระบบและการดึงข้อมูลผู้ใช้ การเรียก API และค่าผลลัพธ์ PlayerID ช่วยในการระบุบัญชีผู้ใช้ (ไม่จำเป็นต้องได้รับและจัดการตัวระบุแยกต่างหากเช่นตัวระบุ IdP)

ในกรณีของบล็อกเชน การเรียกใช้ API หน้าเข้าสู่ระบบ และ API การตรวจสอบการเข้าสู่ระบบและการดึงข้อมูลผู้ใช้ จะสร้าง PlayerID ขึ้นมา ดังนั้นจึงไม่จำเป็นต้องใช้ตัวระบุ IdP แยกต่างหาก เช่น ชุมชนหรือเว็บไซต์