POST/api/sso/:tenantSlug/saml/acs

Assertion Consumer Service(ACS):通过表单 POST 接收身份提供商已签名的 SAML 响应。

此端点仅由身份提供商调用;必须在提供商设置中登记为 ACS URL(参见 `saml/metadata`)。身份提供商会在表单字段 `SAMLResponse` 中发送经 base64 编码的已签名响应。成功时,Zentor App 会以带有一次性代码的查询参数 `sso_code` 重定向浏览器;该代码通过 `POST /api/auth/sso/exchange` 换成访问令牌。 若响应无效或缺少对应的登录流程,服务器会带着查询参数 `sso_error`(例如 `sso_error=SSO_STATE_MISSING`)重定向到登录页面。

概览

调用:POST /api/sso/:tenantSlug/saml/acs。该端点属于 Zentor App API 的“演示聊天机器人与 SSO”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:tenantSlug (路径), SAMLResponse (请求体)。 已记录的错误情况:302 SSO_STATE_MISSING。

身份验证与安全

无需身份验证

幂等: 否

参数

tenantSlug(path, string,必填)— 已配置 SSO 的账户的标识符(slug)
SAMLResponse(body, string,必填)— 身份提供商签名的 SAML 响应(XML,base64 编码),作为表单字段

响应示例

跳转到 https://zentor-app.de/login?sso_error=SSO_STATE_MISSING 的 302 重定向(无有效 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为 Zentor 的访客统计记录演示页面上的匿名使用事件。POST /api/global-chatbot/demo/voice-transcribe若演示的语音功能已启用,将演示页面上的语音录音转换为文本(语音输入)。POST /api/global-chatbot/demo/voice-speak若演示的语音功能已启用,将文本转换为语音(演示页面上的语音输出)。GET /api/sso/:tenantSlug/status检查某个账户是否已配置单一登录(SAML 或 OIDC)。登录页面会使用该结果来提供 SSO 登录选项。GET /api/sso/:tenantSlug/oidc/start启动通过 OpenID Connect 的登录,并将浏览器重定向到已配置的身份提供商。GET /api/sso/:tenantSlug/oidc/callback接收 OIDC 登录后身份提供商的重定向,并将浏览器重定向回 Zentor App。GET /api/sso/:tenantSlug/saml/start启动通过 SAML 的登录,并将浏览器重定向到已配置的身份提供商。GET /api/sso/:tenantSlug/saml/metadata返回用于导入您身份提供商的 Zentor App SAML 元数据(XML)。

相关文章

← 演示聊天机器人与 SSO