POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): Mottar identitetsleverandørens signerte SAML-svar via formular-POST.
Dette endepunktet kalles utelukkende av identitetsleverandøren; det må angis i leverandørens innstillinger som ACS-URL (se `saml/metadata`). Identitetsleverandøren sender det base64-kodede, signerte svaret i formularfeltet `SAMLResponse`. Ved suksess omdirigerer Zentor App nettleseren tilbake med engangskoden i forespørselsparameteren `sso_code`; denne koden byttes mot et tilgangstoken via `POST /api/auth/sso/exchange`. Er svaret ugyldig, eller mangler den tilhørende innloggingsprosessen, omdirigerer serveren til innloggingssiden med forespørselsparameteren `sso_error`, for eksempel `sso_error=SSO_STATE_MISSING`.
Oversikt
Kall: POST /api/sso/:tenantSlug/saml/acs. Endepunktet tilhører gruppen «Demo-chatbot og SSO» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er ikke idempotent: Hvert vellykket kall utløser handlingen på nytt. Obligatoriske parametere: tenantSlug (sti), SAMLResponse (body). Dokumenterte feiltilfeller: 302 SSO_STATE_MISSING.
Autentisering og sikring
Ingen autentisering påkrevd
Idempotent: Nei
Parametere
tenantSlug(path, string, påkrevd)— Identifikator (slug) for kontoen som SSO er satt opp forSAMLResponse(body, string, påkrevd)— SAML-svar signert av identitetsleverandøren (XML, base64-kodet) som formularfeltEksempel på svar
302-omdirigering til https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (eksempel uten gyldig SAML-svar)
Feilkoder
302 SSO_STATE_MISSING — Omdirigering til innloggingssiden med `sso_error`, hvis SAML-svaret er ugyldig eller innloggingsprosessen mangler.Verifisert oppførsel
En ugyldig `SAMLResponse` resulterer i en omdirigering (302) med `sso_error` til innloggingssiden.
Demo-chatbot og SSO
POST /api/global-chatbot/demoSender en melding til den offentlige demo-chatboten på zentor-app.de/demo og returnerer svaret. Demoen kan prøves i nettleseren uten registrering.GET /api/global-chatbot/demo/historyLaster inn den tidligere meldingshistorikken til en demosamtale, slik at den bevares når demoen åpnes på nytt.POST /api/global-chatbot/demo/pollHenter nye meldinger fra en demosamtale, for eksempel når en Zentor-ansatt har overtatt samtalen. Demosiden kaller endepunktet med jevne mellomrom.POST /api/global-chatbot/demo/ratingLagrer vurderingen av en demosamtale (nyttig eller ikke nyttig) med valgfri kommentar.POST /api/global-chatbot/demo/trackRegistrerer anonyme brukshendelser på demosiden for Zentors besøksstatistikk.POST /api/global-chatbot/demo/voice-transcribeKonverterer en taleopptak på demosiden til tekst (taleinnmating), hvis demoens talefunksjon er aktivert.POST /api/global-chatbot/demo/voice-speakKonverterer tekst til tale (taleutgang på demosiden), hvis demoens talefunksjon er aktivert.GET /api/sso/:tenantSlug/statusKontrollerer om enkelt pålogging (SAML eller OIDC) er satt opp for en konto. Innloggingssiden bruker resultatet til å tilby SSO-innlogging.GET /api/sso/:tenantSlug/oidc/startStarter innlogging via OpenID Connect og omdirigerer nettleseren til den oppsatte identitetsleverandøren.GET /api/sso/:tenantSlug/oidc/callbackMottar identitetsleverandørens omdirigering etter OIDC-innlogging og omdirigerer nettleseren tilbake til Zentor App.GET /api/sso/:tenantSlug/saml/startStarter innlogging via SAML og omdirigerer nettleseren til den oppsatte identitetsleverandøren.GET /api/sso/:tenantSlug/saml/metadataReturnerer Zentor Apps SAML-metadata (XML) for import i identitetsleverandøren din.