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

Assertion Consumer Service (ACS): tar emot identitetsleverantörens signerade SAML-svar via formulär-POST.

Denna slutpunkt anropas uteslutande av identitetsleverantören; den måste anges i dennes inställningar som ACS-URL (se `saml/metadata`). Identitetsleverantören skickar det base64-kodade, signerade svaret i formulärfältet `SAMLResponse`. Vid framgång omdirigerar Zentor App webbläsaren tillbaka med engångskoden i frågeparametern `sso_code`; denna kod byts mot en åtkomsttoken via `POST /api/auth/sso/exchange`. Är svaret ogiltigt eller saknas den tillhörande inloggningsprocessen, omdirigerar servern till inloggningssidan med frågeparametern `sso_error`, till exempel `sso_error=SSO_STATE_MISSING`.

Översikt

Anrop: POST /api/sso/:tenantSlug/saml/acs. Endpointen tillhör gruppen ”Demo-chattbot och SSO” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: tenantSlug (sökväg), SAMLResponse (body). Dokumenterade felfall: 302 SSO_STATE_MISSING.

Autentisering & säkerhet

Ingen autentisering krävs

Idempotent: Nej

Parametrar

tenantSlug(path, string, obligatorisk)— Identifierare (slug) för kontot som SSO är konfigurerat för
SAMLResponse(body, string, obligatorisk)— SAML-svar signerat av identitetsleverantören (XML, base64-kodat) som formulärfält

Exempel på response

302-omdirigering till https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (exempel utan giltigt SAML-svar)

Felkoder

302 SSO_STATE_MISSING — Omdirigering till inloggningssidan med `sso_error`, om SAML-svaret är ogiltigt eller inloggningsprocessen saknas.

Verifierat beteende

En ogiltig `SAMLResponse` resulterar i en omdirigering (302) med `sso_error` till inloggningssidan.

Demo-chattbot och SSO

POST /api/global-chatbot/demoSkickar ett meddelande till den offentliga demo-chattboten på zentor-app.de/demo och returnerar dess svar. Demon kan testas i webbläsaren utan registrering.GET /api/global-chatbot/demo/historyLaddar den tidigare meddelandehistoriken för ett demosamtal, så att den bevaras när demon öppnas igen.POST /api/global-chatbot/demo/pollHämtar nya meddelanden från ett demosamtal, till exempel när en Zentor-medarbetare har tagit över samtalet. Demosidan anropar slutpunkten med jämna mellanrum.POST /api/global-chatbot/demo/ratingSparar bedömningen av ett demosamtal (hjälpsamt eller inte hjälpsamt) med valfri kommentar.POST /api/global-chatbot/demo/trackRegistrerar anonyma användningshändelser på demosidan för Zentors besöksstatistik.POST /api/global-chatbot/demo/voice-transcribeOmvandlar en röstinspelning på demosidan till text (röstinmatning), om demons röstfunktion är aktiverad.POST /api/global-chatbot/demo/voice-speakOmvandlar text till tal (röstutmatning på demosidan), om demons röstfunktion är aktiverad.GET /api/sso/:tenantSlug/statusKontrollerar om enkel inloggning (SAML eller OIDC) är konfigurerad för ett konto. Inloggningssidan använder resultatet för att erbjuda SSO-inloggning.GET /api/sso/:tenantSlug/oidc/startStartar inloggning via OpenID Connect och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.GET /api/sso/:tenantSlug/oidc/callbackTar emot identitetsleverantörens omdirigering efter OIDC-inloggning och omdirigerar webbläsaren tillbaka till Zentor App.GET /api/sso/:tenantSlug/saml/startStartar inloggning via SAML och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.GET /api/sso/:tenantSlug/saml/metadataReturnerar Zentor Apps SAML-metadata (XML) för import i din identitetsleverantör.

Relaterade artiklar

← Demo-chattbot och SSO