POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): รับการตอบกลับ SAML ที่ลงนามโดย Identity Provider ผ่านฟอร์ม POST
เอนด์พอยต์นี้ถูกเรียกโดย Identity Provider เท่านั้น ต้องลงทะเบียนเป็น ACS URL ในการตั้งค่าของผู้ให้บริการ (ดู `saml/metadata`) Identity Provider จะส่งการตอบกลับที่เข้ารหัส base64 และลงนามแล้วในฟิลด์ฟอร์ม `SAMLResponse` เมื่อสำเร็จ Zentor App จะเปลี่ยนเส้นทางเบราว์เซอร์กลับพร้อมโค้ดใช้ครั้งเดียวในพารามิเตอร์คำค้นหา `sso_code`; โค้ดนี้จะถูกแลกเป็น Access Token ผ่าน `POST /api/auth/sso/exchange` หากการตอบกลับไม่ถูกต้อง หรือไม่มีขั้นตอนการเข้าสู่ระบบที่เกี่ยวข้อง เซิร์ฟเวอร์จะเปลี่ยนเส้นทางไปยังหน้าเข้าสู่ระบบพร้อมพารามิเตอร์คำค้นหา `sso_error` เช่น `sso_error=SSO_STATE_MISSING`
ภาพรวม
การเรียกใช้: POST /api/sso/:tenantSlug/saml/acs เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทบอทสาธิตและ SSO” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: tenantSlug (path), SAMLResponse (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 302 SSO_STATE_MISSING
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
tenantSlug(path, string, จำเป็น)— ตัวระบุ (slug) ของบัญชีที่ตั้งค่า SSO ไว้SAMLResponse(body, string, จำเป็น)— การตอบกลับ SAML ที่ลงนามโดย Identity Provider (XML, เข้ารหัส base64) ในรูปแบบฟิลด์ฟอร์มตัวอย่างการตอบกลับ
การเปลี่ยนเส้นทาง 302 ไปยัง https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (ตัวอย่างเมื่อไม่มีการตอบกลับ SAML ที่ถูกต้อง)
รหัสข้อผิดพลาด
302 SSO_STATE_MISSING — หากการตอบกลับ SAML ไม่ถูกต้อง หรือไม่มีขั้นตอนการเข้าสู่ระบบที่เกี่ยวข้อง จะเปลี่ยนเส้นทางไปยังหน้าเข้าสู่ระบบพร้อม `sso_error`พฤติกรรมที่ตรวจสอบแล้ว
`SAMLResponse` ที่ไม่ถูกต้องจะนำไปสู่การเปลี่ยนเส้นทาง (302) ไปยังหน้าเข้าสู่ระบบพร้อม `sso_error`
แชทบอทสาธิตและ 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 AppGET /api/sso/:tenantSlug/saml/startเริ่มการเข้าสู่ระบบผ่าน SAML และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้GET /api/sso/:tenantSlug/saml/metadataส่งคืนข้อมูลเมตา SAML ของ Zentor App (XML) สำหรับนำเข้าสู่ Identity Provider ของคุณ