GET/api/sso/:tenantSlug/saml/metadata

Returnerer Zentor Apps SAML-metadata (XML) for import i identitetsleverandøren din.

Metadataene inneholder blant annet entity-ID-en og ACS-URL-en som identitetsleverandøren din trenger for oppsettet. Svaret er et XML-dokument, ikke JSON. Er SAML ikke satt opp for kontoen, svarer serveren med 404 `SSO_NOT_CONFIGURED`.

Oversikt

Kall: GET /api/sso/:tenantSlug/saml/metadata. Endepunktet tilhører gruppen «Demo-chatbot og SSO» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er idempotent: Gjentatte kall med de samme opplysningene gir samme resultat. Obligatoriske parametere: tenantSlug (sti). Dokumenterte feiltilfeller: 404 -.

Autentisering og sikring

Ingen autentisering påkrevd

Idempotent: Ja

Parametere

tenantSlug(path, string, påkrevd)— Identifikator (slug) for kontoen som SSO er satt opp for

Eksempel på svar

(SAML-metadata som XML-dokument, hvis SAML er satt opp for kontoen – ikke JSON)

Feilkoder

404 - — SAML er ikke satt opp for denne kontoen.

Verifisert oppførsel

For en konto uten SAML returnerer oppslaget 404.

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.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): Mottar identitetsleverandørens signerte SAML-svar via formular-POST.

Relaterte artikler

← Demo-chatbot og SSO