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)。