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

Assertion Consumer Service (ACS): nimmt die signierte SAML-Antwort des Identity-Providers per Formular-POST entgegen.

Diesen Endpunkt ruft ausschließlich der Identity-Provider auf; er ist in dessen Einstellungen als ACS-URL einzutragen (siehe `saml/metadata`). Der Identity-Provider sendet die base64-kodierte, signierte Antwort im Formularfeld `SAMLResponse`. Bei Erfolg leitet Zentor App den Browser mit dem Einmalcode im Query-Parameter `sso_code` zurück; dieser Code wird über `POST /api/auth/sso/exchange` gegen ein Zugangstoken getauscht. Ist die Antwort ungültig oder fehlt der zugehörige Anmeldevorgang, leitet der Server zur Anmeldeseite mit dem Query-Parameter `sso_error` weiter, zum Beispiel `sso_error=SSO_STATE_MISSING`.

Überblick

Aufruf: POST /api/sso/:tenantSlug/saml/acs. Der Endpunkt gehört zur Gruppe „Demo-Chatbot und SSO“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist nicht idempotent: Jeder erfolgreiche Aufruf löst die Aktion erneut aus. Pflichtparameter: tenantSlug (Pfad), SAMLResponse (Body). Dokumentierte Fehlerfälle: 302 SSO_STATE_MISSING.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

tenantSlug(path, string, erforderlich)— Kennung (Slug) des Kontos, für das SSO eingerichtet ist
SAMLResponse(body, string, erforderlich)— Vom Identity-Provider signierte SAML-Antwort (XML, base64-kodiert) als Formularfeld

Beispiel-Response

302-Weiterleitung zu https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (Beispiel ohne gültige SAML-Antwort)

Fehlercodes

302 SSO_STATE_MISSING — Weiterleitung zur Anmeldeseite mit `sso_error`, wenn die SAML-Antwort ungültig ist oder der Anmeldevorgang fehlt.

Geprüftes Verhalten

Eine ungültige `SAMLResponse` führt zur Weiterleitung (302) mit `sso_error` zur Anmeldeseite.

Demo-Chatbot und SSO

POST /api/global-chatbot/demoSendet eine Nachricht an den öffentlichen Demo-Chatbot auf zentor-app.de/demo und liefert dessen Antwort. Die Demo lässt sich ohne Registrierung im Browser ausprobieren.GET /api/global-chatbot/demo/historyLädt den bisherigen Nachrichtenverlauf einer Demo-Konversation, damit er beim erneuten Öffnen der Demo erhalten bleibt.POST /api/global-chatbot/demo/pollRuft neue Nachrichten einer Demo-Konversation ab, etwa wenn ein Mitarbeiter von Zentor das Gespräch übernommen hat. Die Demo-Seite ruft den Endpunkt in Abständen auf.POST /api/global-chatbot/demo/ratingSpeichert die Bewertung einer Demo-Konversation (hilfreich oder nicht hilfreich) mit optionalem Kommentar.POST /api/global-chatbot/demo/trackErfasst anonyme Nutzungsereignisse der Demo-Seite für die Besucherstatistik von Zentor.POST /api/global-chatbot/demo/voice-transcribeWandelt eine Sprachaufnahme auf der Demo-Seite in Text um (Spracheingabe), sofern die Sprachfunktion der Demo aktiviert ist.POST /api/global-chatbot/demo/voice-speakWandelt Text in gesprochene Sprache um (Sprachausgabe auf der Demo-Seite), sofern die Sprachfunktion der Demo aktiviert ist.GET /api/sso/:tenantSlug/statusPrüft, ob für ein Konto Single Sign-On (SAML oder OIDC) eingerichtet ist. Die Anmeldeseite nutzt das Ergebnis, um die SSO-Anmeldung anzubieten.GET /api/sso/:tenantSlug/oidc/startStartet die Anmeldung per OpenID Connect und leitet den Browser zum eingerichteten Identity-Provider weiter.GET /api/sso/:tenantSlug/oidc/callbackNimmt die Weiterleitung des Identity-Providers nach der OIDC-Anmeldung entgegen und leitet den Browser zurück zu Zentor App.GET /api/sso/:tenantSlug/saml/startStartet die Anmeldung per SAML und leitet den Browser zum eingerichteten Identity-Provider weiter.GET /api/sso/:tenantSlug/saml/metadataLiefert die SAML-Metadaten von Zentor App (XML) zum Import in Ihren Identity-Provider.

Verwandte Artikel

← Demo-Chatbot und SSO