การลงทะเบียนแอป OAuth 2.0

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

การลงทะเบียนแอป OAuth 2.0 ของคุณช่วยให้สามารถเข้าถึงทรัพยากร Roblox ได้หลังจากลงทะเบียน Roblox จะกำหนดรหัสลูกค้าที่ไม่ซ้ำกันและความลับที่คุณสามารถใช้เพื่อรับการอนุญาตจากผู้ใช้เพื่อเข้าถึงข้อมูลและทรัพยากร Roblox ของพวกเขา

ลงทะเบียนแอปของคุณ

เพื่อลงทะเบียนแอป:

  1. ใน แดชบอร์ดผู้สร้าง ไปที่หน้า แอป OAuth 2.0
  2. คลิกที่ปุ่ม สร้างแอป OAuth 2.0 3. ใส่ชื่อแอปพลิเคชันที่ถูกต้องและไม่ซ้ำกันทั่วโลก ชื่อแอปพลิเคชัน 4. อ่านและยอมรับ เงื่อนไขการให้บริการ Roblox และคลิก สร้าง 5. คัดลอกและบันทึก ID ไคลเอนต์ และ ความลับ ในสถานที่ปลอดภัยหลังจากปิดหน้าเว็บแล้ว คุณจะไม่มีสิทธิ์เข้าถึงความลับอีกต่อไปและสามารถสร้างใหม่ได้เท่านั้นหลังจากที่คุณลงทะเบียนแอปเสร็จแล้ว คุณยังสามารถดูและแก้ไขคุณสมบัติอื่นๆ ของแอปได้
  3. คลิก ดำเนินการแก้ไขต่อ เพื่อกำหนดค่าแอปของคุณซึ่งอธิบายไว้ในส่วนต่อไป

กำหนดข้อมูลทั่วไป

เมื่อคุณลงทะเบียนแอปของคุณแล้ว คุณควรกำหนดข้อมูลทั่วไปของแอป รวมถึง:

  • คำอธิบายซึ่งสามารถมองเห็นได้โดยทุกคนในชุมชน Roblox
  • ภาพขนาดย่อสำหรับแอปของคุณ ขนาดไฟล์ที่แนะนำอย่างน้อยคือ 150x150 พิกเซล
  • ลิงค์เข้า เป็นจุดเข้าของแอปของคุณ เช่นหน้าแรกของเว็บไซต์แอป
  • A URL เงื่อนไขความเป็นส่วนตัว และ URL เงื่อนไขการให้บริการ สำหรับผู้ใช้ปลายทางที่จะอ่านก่อนอนุญาตให้แอปของคุณแต่ละ URL ต้องเป็น HTTPS และไม่เกิน 256 ตัวอักษร

เพิ่มสิทธิ์

เพื่อให้แน่ใจว่ามีการควบคุมการเข้าถึงและความปลอดภัยที่เหมาะสมภายในแอปของคุณ คุณต้องเพิ่ม ขอบเขตสิทธิ์ มีสองประเภทของขอบเขตสิทธิ์ที่มีอยู่:

  • ขอบเขตตัวตน สำหรับการตรวจสอบ เช่น openid สำหรับรหัสผู้ใช้และ profile สำหรับโปรไฟล์ทั้งหมดหากคุณเลือกขอบเขต profile คุณต้องเลือก openid ด้วย
  • ขอบเขตสิทธิ์เฉพาะ API เช่น asset:read สำหรับสิทธิ์การอ่านของสินทรัพย์เลือกเฉพาะจำนวนสโคปขั้นต่ำที่คุณต้องการสำหรับแอปของคุณเท่านั้น

เพิ่ม URL เปลี่ยนเส้นทาง

URL เปลี่ยนเส้นทาง เป็นจุดเปลี่ยนเส้นทางของแอปของคุณที่ผู้ใช้ถูกเปลี่ยนเส้นทางไปเมื่อพวกเขาสรุปการอนุญาตแอปของคุณตรวจสอบให้แน่ใจว่า URL เปลี่ยนเส้นทางของคุณตรงตามข้อกำหนดต่อไปนี้:

  • ทุก URL เปลี่ยนเส้นทางจะต้องอยู่ในหนึ่งในรูปแบบต่อไปนี้:
    • HTTPS ธรรมดาเช่น: https://www.example.com .
    • เส้นทางบน localhost ด้วย HTTP หรือ HTTPS (ใบรับรองที่ลงนามโดยตัวเอง) สำหรับการดีบักท้องถิ่นตัวอย่างเช่น:
      • http://localhost:80
      • https://localhost:80
    • แผนการที่กำหนดเองสำหรับแอปพลิเคชันหรือวัตถุประสงค์เฉพาะ, ตัวอย่างเช่น:
      • my-app-scheme:/
      • my-app-scheme://foo/bar/...
      • my-app://action?param1=value1&param2=value2
  • ความยาวสูงสุดของ URL สำหรับการเปลี่ยนเส้นทางคือ 256 ตัวอักษร
  • คุณสามารถเพิ่ม URL เปลี่ยนเส้นทางได้ถึง 10 รายการด้วย URL การเปลี่ยนเส้นทางหลายรายการ คุณสามารถมีสภาพแวดล้อมการทดสอบและอนุญาตให้ผู้ใช้ย้ายระหว่างไซต์สองแห่งโดยไม่มีเวลาหยุดทำงาน

ตรวจสอบ

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

หากต้องการขยายฐานผู้ใช้สำหรับแอปของคุณ ตรวจสอบ:

  1. ไปที่หน้า แอป OAuth 2.0
  2. คลิกปุ่ม แก้ไขและเผยแพร่ สำหรับแอปที่คุณต้องการเผยแพร่
  3. กรอกข้อมูลที่จำเป็นทั้งหมดและคลิกที่ปุ่ม รีวิวและเผยแพร่ ประกาศที่มีข้อจํากัดในสิทธิ์การอนุญาตของแอปของคุณในระหว่างระยะเวลาการตรวจทานรอดำเนินการปรากฏขึ้น
  4. คลิก ส่งเพื่อรีวิว .

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

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

แก้ไขและลบแอปของคุณ

คุณสามารถแก้ไขหรือลบแอปของคุณด้วยขั้นตอนต่อไปนี้หากไม่อยู่ในระหว่างการตรวจสอบ:

  1. ไปที่หน้า แอป OAuth 2.0

  2. คลิก แก้ไข หรือ ลบ สำหรับแอปที่ต้องการ

    • หากคุณเลือกที่จะแก้ไขแอป ให้ทำตามขั้นตอนและข้อกำหนดเดียวกันของการลงทะเบียน
    • หากคุณเลือกที่จะลบแอป คลิก ใช่ ลบ เพื่อยืนยันการลบ หลังจากที่คุณลบแอปแล้ว คุณไม่สามารถกู้คืนได้

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

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