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

Assertion Consumer Service (ACS): riceve la risposta SAML firmata del provider di identità tramite POST di un modulo.

Questo endpoint viene richiamato esclusivamente dal provider di identità; deve essere inserito come URL ACS nelle sue impostazioni (vedi `saml/metadata`). Il provider di identità invia la risposta firmata, codificata in base64, nel campo del modulo `SAMLResponse`. In caso di successo, Zentor App reindirizza il browser con il codice a uso unico nel parametro di query `sso_code`; questo codice viene scambiato con un token di accesso tramite `POST /api/auth/sso/exchange`. Se la risposta non è valida o manca il relativo processo di login, il server reindirizza alla pagina di login con il parametro di query `sso_error`, ad esempio `sso_error=SSO_STATE_MISSING`.

Panoramica

Chiamata: POST /api/sso/:tenantSlug/saml/acs. Questo endpoint appartiene al gruppo «Chatbot demo e SSO» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata non è idempotente: ogni chiamata riuscita attiva nuovamente l'azione. Parametri obbligatori: tenantSlug (path), SAMLResponse (body). Casi di errore documentati: 302 SSO_STATE_MISSING.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Idempotente: No

Parametri

tenantSlug(path, string, obbligatorio)— Identificativo (slug) dell'account per cui è configurato l'SSO
SAMLResponse(body, string, obbligatorio)— Risposta SAML firmata dal provider di identità (XML, codificata in base64) come campo del modulo

Risposta di esempio

Reindirizzamento 302 a https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (esempio senza risposta SAML valida)

Codici di errore

302 SSO_STATE_MISSING — Reindirizzamento alla pagina di login con `sso_error` se la risposta SAML non è valida o manca il processo di login.

Comportamento verificato

Una `SAMLResponse` non valida comporta un reindirizzamento (302) alla pagina di login con `sso_error`.

Chatbot demo e SSO

POST /api/global-chatbot/demoInvia un messaggio al chatbot demo pubblico su zentor-app.de/demo e restituisce la sua risposta. La demo può essere provata nel browser senza registrazione.GET /api/global-chatbot/demo/historyCarica la cronologia dei messaggi di una conversazione demo in modo che venga conservata quando la demo viene riaperta.POST /api/global-chatbot/demo/pollRecupera i nuovi messaggi di una conversazione demo, ad esempio quando un collaboratore di Zentor ha preso in carico la conversazione. La pagina demo richiama l'endpoint a intervalli.POST /api/global-chatbot/demo/ratingSalva la valutazione di una conversazione demo (utile o non utile) con un commento opzionale.POST /api/global-chatbot/demo/trackRegistra eventi di utilizzo anonimi della pagina demo per le statistiche visitatori di Zentor.POST /api/global-chatbot/demo/voice-transcribeConverte una registrazione vocale sulla pagina demo in testo (input vocale), se la funzione vocale della demo è attivata.POST /api/global-chatbot/demo/voice-speakConverte il testo in voce (output vocale sulla pagina demo), se la funzione vocale della demo è attivata.GET /api/sso/:tenantSlug/statusVerifica se il Single Sign-On (SAML o OIDC) è configurato per un account. La pagina di login utilizza il risultato per offrire il login SSO.GET /api/sso/:tenantSlug/oidc/startAvvia il login tramite OpenID Connect e reindirizza il browser al provider di identità configurato.GET /api/sso/:tenantSlug/oidc/callbackRiceve il reindirizzamento del provider di identità dopo il login OIDC e reindirizza il browser a Zentor App.GET /api/sso/:tenantSlug/saml/startAvvia il login tramite SAML e reindirizza il browser al provider di identità configurato.GET /api/sso/:tenantSlug/saml/metadataRestituisce i metadati SAML di Zentor App (XML) per l'importazione nel vostro provider di identità.

Articoli correlati

← Chatbot demo e SSO