สร้างโทเค็นการเชื่อมต่อ

เอกสารนี้อธิบายวิธีการสร้างโทเค็นที่จำเป็นสำหรับการเชื่อมต่อ

ข้อมูลโทเค็น

ข้อมูลที่จำเป็นที่ต้องให้กับ Elice เพื่อการเชื่อมต่อคือดังนี้

• ตัวแยกผู้ใช้ (uid) : ค่าที่จำเป็นในการแยกแยะผู้ใช้เฉพาะ (unique) เพื่อระบุผู้ใช้เฉพาะ

  • สามารถใช้สตริงที่เป็นตัวแยกผู้ใช้ที่ใช้ในการเข้าสู่ระบบใน LMS ขององค์กรของคุณได้ เช่น user ID, username, email เป็นต้น

  • หากต้องการให้ Elice ทำการลงทะเบียนเรียนตามคอร์สที่สมัครของ LMS ขององค์กร คุณสามารถตั้งค่าค่า uid โดยรวมข้อมูลของหมายเลขคอร์สใน uid ได้ หากค่า uid ไม่เปลี่ยนแปลง Elice จะทำงานในรูปแบบแก้ไขการลงทะเบียนที่มีอยู่แล้ว ดังนั้นหากต้องการให้มีการลงทะเบียนเรียนใหม่ตามคอร์สที่แตกต่างกันคุณต้องเปลี่ยนค่า uid ที่สอดคล้องกัน เช่นหาก username ของผู้ใช้ใน LMS ของคุณคือ test1 คุณสามารถตั้งค่า uid เป็น test1_20200801 และ test1_20200901 เพื่อให้ Elice จัดการเป็นบัญชีการเชื่อมต่อที่แตกต่างกันได้

• ชื่อผู้ใช้ (fullname) : ค่าที่จำเป็นในการแสดงชื่อของผู้ใช้ที่ระบบ Elice

• ที่อยู่อีเมล (email) : ค่าที่จำเป็นสำหรับการใช้บริการต่าง ๆ ที่เกี่ยวข้องกับอีเมลบนระบบ Elice

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

• เวลาสร้างโทเค็น (ts) : เวลาที่สร้างโทเค็น ใช้เวลาปัจจุบันเป็นหน่วยมิลลิวินาที (epoch) สำหรับป้องกันการนำโทเค็นออกไปใช้ซ้ำ ถ้าเวลาที่สร้างและเวลาที่ใช้ต่างกันมากกว่า 300 วินาที การเชื่อมต่อจะถูกปฏิเสธ

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

• ไอดีวิชา (courseId) : ไอดีของวิชาที่ต้องการลงทะเบียนอัตโนมัติใน Elice ไอดีนี้จะใช้เป็นพื้นฐานตามไอดีวิชาของ Elice

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

• สิทธิของผู้ใช้ (userRole) : ค่าที่จำเป็นในการกำหนดสิทธิของผู้ใช้

  • นักเรียน: 0 / ผู้สอน: 10 / ผู้ดูแลระบบ: 20

  • หากไม่ระบุ จะกำหนดสิทธินักเรียนให้โดยอัตโนมัติ

  • สิทธิของผู้สอนและผู้ดูแลระบบจะมีผลเมื่อใช้รูปแบบการเชื่อมต่อ "การเชื่อมต่อโฮม"

วิธีการสร้างโทเค็น

คุณสามารถสร้างโทเค็นโดยใช้วิธีการเข้ารหัสและซีเรียลไนซ์ข้อมูลโทเค็นที่ถูกจัดลำดับเป็น JSON ด้วยวิธีการเข้ารหัสและซีเรียลไนซ์ต่อไปนี้ สำหรับความสะดวกในการพัฒนาการเชื่อมต่อ เราขอแนะนำให้ใช้วิธี JWT ที่เป็นมาตรฐานเว็บ และหากต้องการความปลอดภัยเพิ่มเติม (ความลับ) คุณสามารถใช้วิธี AES-CBC ได้

JWT การสร้างโทเค็นด้วยวิธีการAES-CBC การสร้างโทเค็นด้วยวิธีการการเข้ารหัสที่แยกต่างหาก