GET/api/sso/:tenantSlug/oidc/start
เริ่มการเข้าสู่ระบบผ่าน OpenID Connect และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้
เรียกเอนด์พอยต์นี้ผ่านการนำทางเบราว์เซอร์ ไม่ใช่ผ่านคำขอ JavaScript หากตั้งค่า OIDC ไว้ เซิร์ฟเวอร์จะตอบกลับด้วยการเปลี่ยนเส้นทาง (302) ไปยัง Identity Provider; หลังจากเข้าสู่ระบบที่นั่น เบราว์เซอร์จะกลับมาผ่าน `oidc/callback` หากไม่ได้ตั้งค่า OIDC สำหรับบัญชี เซิร์ฟเวอร์จะตอบกลับด้วย 404 `SSO_NOT_CONFIGURED` และข้อความแสดงข้อผิดพลาดแบบ JSON
ภาพรวม
การเรียกใช้: GET /api/sso/:tenantSlug/oidc/start เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทบอทสาธิตและ SSO” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้เป็นแบบ idempotent: การเรียกซ้ำด้วยข้อมูลเดิมจะได้ผลลัพธ์เดิม พารามิเตอร์ที่จำเป็น: tenantSlug (path) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 404 -
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ใช่
พารามิเตอร์
tenantSlug(path, string, จำเป็น)— ตัวระบุ (slug) ของบัญชีที่ตั้งค่า SSO ไว้ตัวอย่างการตอบกลับ
(การเปลี่ยนเส้นทาง 302 ไปยัง Identity Provider หาก OIDC ได้รับการตั้งค่าสำหรับบัญชี)
รหัสข้อผิดพลาด
404 - — ไม่ได้ตั้งค่า OIDC สำหรับบัญชีนี้พฤติกรรมที่ตรวจสอบแล้ว
สำหรับบัญชีที่ไม่ได้ตั้งค่า OIDC การเรียกจะได้รับ 404
แชทบอทสาธิตและ SSO
POST /api/global-chatbot/demoส่งข้อความไปยังแชทบอทสาธิตสาธารณะที่ zentor-app.de/demo และส่งคืนคำตอบ สามารถทดลองใช้การสาธิตในเบราว์เซอร์ได้โดยไม่ต้องลงทะเบียนGET /api/global-chatbot/demo/historyโหลดประวัติข้อความก่อนหน้าของการสนทนาสาธิต เพื่อให้คงอยู่เมื่อเปิดการสาธิตใหม่POST /api/global-chatbot/demo/pollดึงข้อความใหม่ของการสนทนาสาธิต เช่น เมื่อพนักงานของ Zentor เข้ามารับช่วงการสนทนา หน้าสาธิตจะเรียกเอนด์พอยต์นี้เป็นระยะ ๆPOST /api/global-chatbot/demo/ratingบันทึกการให้คะแนนของการสนทนาสาธิต (มีประโยชน์หรือไม่มีประโยชน์) พร้อมความคิดเห็นที่ไม่บังคับPOST /api/global-chatbot/demo/trackบันทึกเหตุการณ์การใช้งานแบบไม่ระบุตัวตนของหน้าสาธิตสำหรับสถิติผู้เยี่ยมชมของ ZentorPOST /api/global-chatbot/demo/voice-transcribeแปลงการบันทึกเสียงบนหน้าสาธิตเป็นข้อความ (การรับข้อมูลเสียง) หากเปิดใช้งานฟังก์ชันเสียงของการสาธิตPOST /api/global-chatbot/demo/voice-speakแปลงข้อความเป็นเสียงพูด (การส่งออกข้อมูลเสียงบนหน้าสาธิต) หากเปิดใช้งานฟังก์ชันเสียงของการสาธิตGET /api/sso/:tenantSlug/statusตรวจสอบว่ามีการตั้งค่า Single Sign-On (SAML หรือ OIDC) สำหรับบัญชีหรือไม่ หน้าเข้าสู่ระบบจะใช้ผลลัพธ์นี้เพื่อเสนอการเข้าสู่ระบบด้วย SSOGET /api/sso/:tenantSlug/oidc/callbackรับการเปลี่ยนเส้นทางของ Identity Provider หลังจากเข้าสู่ระบบด้วย OIDC และเปลี่ยนเส้นทางเบราว์เซอร์กลับไปยัง Zentor AppGET /api/sso/:tenantSlug/saml/startเริ่มการเข้าสู่ระบบผ่าน SAML และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): รับการตอบกลับ SAML ที่ลงนามโดย Identity Provider ผ่านฟอร์ม POSTGET /api/sso/:tenantSlug/saml/metadataส่งคืนข้อมูลเมตา SAML ของ Zentor App (XML) สำหรับนำเข้าสู่ Identity Provider ของคุณ