GET/api/sso/:tenantSlug/oidc/start
Startar inloggning via OpenID Connect och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.
Anropa slutpunkten via webbläsarnavigering, inte via en JavaScript-förfrågan. Är OIDC konfigurerat svarar servern med en omdirigering (302) till identitetsleverantören; efter inloggning där återvänder webbläsaren via `oidc/callback`. Är OIDC inte konfigurerat för kontot svarar servern med 404 `SSO_NOT_CONFIGURED` och ett JSON-felmeddelande.
Översikt
Anrop: GET /api/sso/:tenantSlug/oidc/start. Endpointen tillhör gruppen ”Demo-chattbot och SSO” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är idempotent: Upprepade anrop med samma uppgifter ger samma resultat. Obligatoriska parametrar: tenantSlug (sökväg). Dokumenterade felfall: 404 -.
Autentisering & säkerhet
Ingen autentisering krävs
Idempotent: Ja
Parametrar
tenantSlug(path, string, obligatorisk)— Identifierare (slug) för kontot som SSO är konfigurerat förExempel på response
(302-omdirigering till identitetsleverantören, om OIDC är konfigurerat för kontot)
Felkoder
404 - — OIDC är inte konfigurerat för detta konto.Verifierat beteende
För ett konto utan OIDC returnerar anropet 404.
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/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.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): tar emot identitetsleverantörens signerade SAML-svar via formulär-POST.GET /api/sso/:tenantSlug/saml/metadataReturnerar Zentor Apps SAML-metadata (XML) för import i din identitetsleverantör.