GET/api/sso/:tenantSlug/saml/start

เริ่มการเข้าสู่ระบบผ่าน SAML และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้

เรียกเอนด์พอยต์นี้ผ่านการนำทางเบราว์เซอร์ หากตั้งค่า SAML ไว้ เซิร์ฟเวอร์จะตอบกลับด้วยการเปลี่ยนเส้นทาง (302) ไปยัง Identity Provider; การตอบกลับของผู้ให้บริการนั้นจะถูกส่งไปยัง `saml/acs` ต่อไป หากไม่ได้ตั้งค่า SAML สำหรับบัญชี เซิร์ฟเวอร์จะตอบกลับด้วย 404 `SSO_NOT_CONFIGURED` และข้อความแสดงข้อผิดพลาดแบบ JSON

ภาพรวม

การเรียกใช้: GET /api/sso/:tenantSlug/saml/start เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทบอทสาธิตและ SSO” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้เป็นแบบ idempotent: การเรียกซ้ำด้วยข้อมูลเดิมจะได้ผลลัพธ์เดิม พารามิเตอร์ที่จำเป็น: tenantSlug (path) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 404 -

การยืนยันตัวตนและความปลอดภัย

ไม่ต้องยืนยันตัวตน

Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ใช่

พารามิเตอร์

tenantSlug(path, string, จำเป็น)— ตัวระบุ (slug) ของบัญชีที่ตั้งค่า SSO ไว้

ตัวอย่างการตอบกลับ

(การเปลี่ยนเส้นทาง 302 ไปยัง Identity Provider หาก SAML ได้รับการตั้งค่าสำหรับบัญชี)

รหัสข้อผิดพลาด

404 - — ไม่ได้ตั้งค่า SAML สำหรับบัญชีนี้

พฤติกรรมที่ตรวจสอบแล้ว

สำหรับบัญชีที่ไม่ได้ตั้งค่า SAML การเรียกจะได้รับ 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/startเริ่มการเข้าสู่ระบบผ่าน OpenID Connect และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้GET /api/sso/:tenantSlug/oidc/callbackรับการเปลี่ยนเส้นทางของ Identity Provider หลังจากเข้าสู่ระบบด้วย OIDC และเปลี่ยนเส้นทางเบราว์เซอร์กลับไปยัง Zentor AppPOST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): รับการตอบกลับ SAML ที่ลงนามโดย Identity Provider ผ่านฟอร์ม POSTGET /api/sso/:tenantSlug/saml/metadataส่งคืนข้อมูลเมตา SAML ของ Zentor App (XML) สำหรับนำเข้าสู่ Identity Provider ของคุณ

บทความที่เกี่ยวข้อง

← แชทบอทสาธิตและ SSO