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

启动通过 SAML 的登录,并将浏览器重定向到已配置的身份提供商。

请通过浏览器导航调用该端点。若已配置 SAML,服务器会以跳转到身份提供商的重定向(302)响应;该提供商的响应随后发送到 `saml/acs`。若账户未配置 SAML,服务器会以 404 `SSO_NOT_CONFIGURED` 及 JSON 错误信息响应。

概览

调用:GET /api/sso/:tenantSlug/saml/start。该端点属于 Zentor App API 的“演示聊天机器人与 SSO”分组。 该端点可公开访问,无需身份验证。 该调用是幂等的:使用相同输入重复调用将返回相同结果。 必填参数:tenantSlug (路径)。 已记录的错误情况:404 -。

身份验证与安全

无需身份验证

幂等: 是

参数

tenantSlug(path, string,必填)— 已配置 SSO 的账户的标识符(slug)

响应示例

(如果账户已配置 SAML,则为跳转到身份提供商的 302 重定向)

错误代码

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为 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。POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service(ACS):通过表单 POST 接收身份提供商已签名的 SAML 响应。GET /api/sso/:tenantSlug/saml/metadata返回用于导入您身份提供商的 Zentor App SAML 元数据(XML)。

相关文章

← 演示聊天机器人与 SSO