POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): nhận phản hồi SAML đã ký của identity provider qua form POST.
Endpoint này chỉ được identity provider gọi; phải được đăng ký là ACS URL trong cài đặt của nhà cung cấp (xem `saml/metadata`). Identity provider gửi phản hồi đã ký, mã hóa base64 trong trường biểu mẫu `SAMLResponse`. Khi thành công, Zentor App chuyển hướng trình duyệt trở lại kèm mã dùng một lần trong tham số truy vấn `sso_code`; mã này được đổi thành access token qua `POST /api/auth/sso/exchange`. Nếu phản hồi không hợp lệ hoặc thiếu quy trình đăng nhập liên quan, server chuyển hướng đến trang đăng nhập kèm tham số truy vấn `sso_error`, ví dụ `sso_error=SSO_STATE_MISSING`.
Tổng quan
Lệnh gọi: POST /api/sso/:tenantSlug/saml/acs. Endpoint này thuộc nhóm “Chatbot demo và SSO” trong API của Zentor App. Endpoint này được truy cập công khai và không yêu cầu xác thực. Lệnh gọi không có tính idempotent: mỗi lệnh gọi thành công đều kích hoạt lại hành động. Tham số bắt buộc: tenantSlug (path), SAMLResponse (body). Các trường hợp lỗi được tài liệu hóa: 302 SSO_STATE_MISSING.
Xác thực & bảo mật
Không cần xác thực
Lũy đẳng (idempotent): Không
Tham số
tenantSlug(path, string, bắt buộc)— Định danh (slug) của tài khoản đã thiết lập SSOSAMLResponse(body, string, bắt buộc)— Phản hồi SAML được identity provider ký (XML, mã hóa base64) dưới dạng trường biểu mẫuResponse mẫu
chuyển hướng 302 đến https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (ví dụ khi không có phản hồi SAML hợp lệ)
Mã lỗi
302 SSO_STATE_MISSING — Nếu phản hồi SAML không hợp lệ hoặc thiếu quy trình đăng nhập liên quan, sẽ chuyển hướng đến trang đăng nhập kèm `sso_error`.Hành vi đã được xác minh
Một `SAMLResponse` không hợp lệ sẽ dẫn đến chuyển hướng (302) đến trang đăng nhập kèm `sso_error`.
Chatbot demo và SSO
POST /api/global-chatbot/demoGửi một tin nhắn đến chatbot demo công khai tại zentor-app.de/demo và trả về câu trả lời của nó. Có thể dùng thử demo trong trình duyệt mà không cần đăng ký.GET /api/global-chatbot/demo/historyTải lịch sử tin nhắn trước đó của một cuộc hội thoại demo để nó được giữ lại khi mở lại demo.POST /api/global-chatbot/demo/pollLấy các tin nhắn mới của một cuộc hội thoại demo, chẳng hạn khi một nhân viên Zentor đã tiếp nhận cuộc hội thoại. Trang demo gọi endpoint này theo khoảng thời gian.POST /api/global-chatbot/demo/ratingLưu đánh giá của một cuộc hội thoại demo (có ích hoặc không có ích) kèm bình luận không bắt buộc.POST /api/global-chatbot/demo/trackGhi lại các sự kiện sử dụng ẩn danh trên trang demo cho số liệu thống kê khách truy cập của Zentor.POST /api/global-chatbot/demo/voice-transcribeChuyển đổi một bản ghi âm trên trang demo thành văn bản (nhập giọng nói), nếu tính năng giọng nói của demo được bật.POST /api/global-chatbot/demo/voice-speakChuyển đổi văn bản thành giọng nói (xuất giọng nói trên trang demo), nếu tính năng giọng nói của demo được bật.GET /api/sso/:tenantSlug/statusKiểm tra liệu single sign-on (SAML hoặc OIDC) đã được thiết lập cho một tài khoản hay chưa. Trang đăng nhập sử dụng kết quả này để cung cấp tùy chọn đăng nhập SSO.GET /api/sso/:tenantSlug/oidc/startBắt đầu đăng nhập qua OpenID Connect và chuyển hướng trình duyệt đến identity provider đã được cấu hình.GET /api/sso/:tenantSlug/oidc/callbackNhận chuyển hướng của identity provider sau khi đăng nhập OIDC và chuyển hướng trình duyệt trở lại Zentor App.GET /api/sso/:tenantSlug/saml/startBắt đầu đăng nhập qua SAML và chuyển hướng trình duyệt đến identity provider đã được cấu hình.GET /api/sso/:tenantSlug/saml/metadataTrả về metadata SAML của Zentor App (XML) để nhập vào identity provider của bạn.