เรียนรู้วิธีสร้าง SDK ที่กำหนดเองสำหรับ Logto โดยใช้ `@logto/node`.
ก่อนหน้านี้ใน บทความ นี้ เราได้สร้างเว็บ SDK สำหรับ Logto ในเวลาไม่นาน ตอนนี้ มามุ่งเน้นที่ Node.js แพลตฟอร์มยอดนิยมอีกแห่งสำหรับนักพัฒนา JavaScript
ในคู่มือนี้ เราจะพาคุณผ่านขั้นตอนเพื่อสร้าง SDK ของ Express ที่เรียบง่ายสำหรับ Logto โดยใช้ @logto/node SDK นี้จะนำนิยามการลงชื่อเข้าใช้ และคุณสามารถทำตามขั้นตอนเดียวกันนี้เพื่อสร้าง SDK สำหรับแพลตฟอร์มที่ใช้ Node.js อื่น ๆ อย่าง Koa, Next.js, NestJS เป็นต้น
ก่อนที่เราจะเริ่ม มาทบทวนกระบวนการลงชื่อเข้าใช้ใน Logto กระบวนการลงชื่อเข้าใช้ประกอบด้วยขั้นตอนดังต่อไปนี้:
@logto/nodeคล้ายกับ @logto/browser แพ็กเกจ @logto/node จะเปิดเผยคลาส LogtoClient ที่ให้ฟังก์ชันหลักของ Logto รวมถึงวิธีการสำหรับกระบวนการลงชื่อเข้าใช้:
signIn(): สร้าง URL การตรวจสอบสิทธิ์ OIDC และเปลี่ยนเส้นทางไปยัง URLhandleSignInCallback(): ตรวจสอบและวิเคราะห์ URL การตอบกลับและสกัดรหัสยินยอม จากนั้นแลกรหัสเพื่อโทเค็นโดยเรียกจุดสิ้นสุดของโทเค็นgetContext(): รับบริบทของคำขอปัจจุบันตามคุกกี้เซสชัน รวมถึงสถานะการตรวจสอบสิทธิ์และข้อมูลผู้ใช้ใน SDK เราจะให้ตัวจัดการเส้นทางสองตัว (/sign-in และ /sign-in-callback) พร้อมกับมิดเดิลแวร์ withLogto:
/sign-in: ตัวจัดการเส้นทางที่กระตุ้นกระบวนการลงชื่อเข้าใช้ด้วยการตอบสนองที่เปลี่ยนเส้นทางไปยัง URL การตรวจสอบสิทธิ์ OIDC/sign-in-callback: ตัวจัดการเส้นทางที่ประมวลผล URL การตอบกลับ แลกรหัสยินยอมเป็นโทเค็น จัดเก็บโทเค็น และทำให้กระบวนการลงชื่อเข้าใช้เสร็จสิ้นwithLogto middleware: มิดเดิลแวร์ที่เรียก getContext() เพื่อดึงบริบทของคำขอปัจจุบัน รวมถึงสถานะการตรวจสอบสิทธิ์และข้อมูลผู้ใช้ในการใช้ SDK คุณสามารถเพิ่มมิดเดิลแวร์ในแอพ Express ของคุณเพื่อปกป้องเส้นทาง และใช้ตัวจัดการเส้นทางเพื่อกระตุ้นกระบวนการลงชื่อเข้าใช้และจัดการการตอบกลับ
ก่อนอื่น ติดตั้งแพ็กเกจ @logto/node โดยใช้ npm หรือผู้จัดการแพ็กเกจอื่น ๆ:
ต้องใช้ตัวแปลงที่เก็บข้อมูลในการเริ่มต้นใช้งานอินสแตนซ์ LogtoClient
สมมติว่าผู้ใช้ SDK ได้ตั้งค่า Express session แล้ว เราสามารถ implement คลาส Storage ได้โดยการสร้างไฟล์ใหม่ storage.ts:
คำขอ HTTP นั้นไม่มีสถานะ ดังนั้นเราต้องเริ่มต้นคลาส client สำหรับคำขอแต่ละคำขอ เตรียมฟังก์ชันตัวช่วยเพื่อสร้างอินสแตนซ์ client:
ในฟังก์ชันนี้ เราจะ implement ตัวแปลง navigate พร้อมกับตัวแปลง ExpressStorage ตัวแปลง navigate ถูกใช้เพื่อเปลี่ยนเส้นทางผู้ใช้ไปยัง URL ลงชื่อเข้าใช้
ถัดไป มาดูที่การ implement ตัวจัดการเส้นทาง ห่อในฟังก์ชัน handleAuthRoutes:
/auth/sign-in กระตุ้นกระบวนการลงชื่อเข้าใช้โดยการเรียก signIn() สถานะการลงชื่อเข้าใช้จะถูกเก็บใน session และจะถูกใช้โดยตัวจัดการเส้นทาง /auth/sign-in-callback/auth/sign-in-callback จะจัดการ URL การตอบกลับและแลกรหัสยินยอมเป็นโทเค็นโดยการเรียก handleSignInCallback() โทเค็นจะถูกเก็บใน session โดยตัวแปลง ExpressStorage หลังจากเสร็จสิ้นแล้ว ผู้ใช้จะถูกเปลี่ยนเส้นทางกลับไปยังหน้าแรกมิดเดิลแวร์ withLogto ถูกใช้เพื่อปกป้องเส้นทาง มันจะเรียก getContext() เพื่อรับบริบทของคำขอปัจจุบัน รวมถึงสถานะการตรวจสอบสิทธิ์และข้อมูลผู้ใช้
ฟังก์ชัน getContext ใช้ตัวแปลงที่เก็บข้อมูลเพื่อรับโทเค็นจาก session
ตอนนี้คุณได้สร้าง Express SDK สำหรับ Logto แล้ว คุณสามารถใช้มันในแอพของคุณโดยการเพิ่มมิดเดิลแวร์เพื่อปกป้องเส้นทางและใช้ตัวจัดการเส้นทางเพื่อกระตุ้นกระบวนการลงชื่อเข้าใช้และจัดการการตอบกลับ
นี่คือตัวอย่างง่าย ๆ ของการใช้ SDK ในแอพ Express ของคุณ:
ในตัวอย่างนี้ เราใช้มิดเดิลแวร์ withLogto เพื่อตรวจสอบสถานะการตรวจสอบสิทธิ์ และเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าลงชื่อเข้าใช้หากพวกเขายังไม่ได้รับการตรวจสอบสิทธิ์ มิฉะนั้นจะแสดงข้อความต้อนรับ
คุณสามารถตรวจสอบโครงการตัวอย่าง Express อย่างเป็นทางการ ที่นี่.
ในคู่มือนี้ เราได้พาคุณผ่านขั้นตอนเพื่อสร้าง Express SDK สำหรับ Logto ที่ดำเนินกระบวนการรับรองความถูกต้องเบื้องต้น SDK ที่ให้มานี้เป็นตัวอย่างพื้นฐาน คุณสามารถขยายมันได้ด้วยการเพิ่มวิธีการและฟังก์ชันเพิ่มเติมเพื่อตอบสนองความต้องการของแอพของคุณ
คุณสามารถทำตามขั้นตอนเดียวกันนี้เพื่อสร้าง SDK สำหรับแพลตฟอร์มอื่นใดที่ใช้ JavaScript และทำงานใน Node.js
แหล่งข้อมูล: