GET/api/sso/:tenantSlug/oidc/callback

Pranon ridrejtimin e ofruesit të identitetit pas hyrjes OIDC dhe ridrejton shfletuesin përsëri te Zentor App.

Ky endpoint thirret ekskluzivisht nga ofruesi i identitetit përmes ridrejtimit të shfletuesit; duhet të vendoset në cilësimet e tij si Redirect-URI. Në rast suksesi, Zentor App ridrejton shfletuesin me kodin një-herësh në parametrin e kërkesës `sso_code`; ky kod shkëmbehet me një token aksesi përmes `POST /api/auth/sso/exchange`. Në rast gabimi – p.sh. nëse parametri i sigurisë `state` mungon ose është i pavlefshëm – serveri ridrejton te faqja e hyrjes me parametrin e kërkesës `sso_error`, për shembull `sso_error=SSO_STATE_MISSING`. Nisni përsëri hyrjen.

Përmbledhje

Thirrja: GET /api/sso/:tenantSlug/oidc/callback. Ky endpoint i përket grupit “Demo-chatbot dhe SSO” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: tenantSlug (path). Rastet e dokumentuara të gabimeve: 302 SSO_STATE_MISSING.

Autentifikimi dhe siguria

Nuk kërkohet autentifikim

Idempotent: Jo

Parametrat

tenantSlug(path, string, i detyrueshëm)— Identifikuesi (slug) i llogarisë për të cilën është konfiguruar SSO

Shembull response-i

Ridrejtim 302 te https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (shembull pa `state` të vlefshëm)

Kodet e gabimeve

302 SSO_STATE_MISSING — Ridrejtim te faqja e hyrjes me `sso_error`, nëse `state` mungon ose është i pavlefshëm.

Sjellja e verifikuar

Pa `state` të vlefshëm, serveri ridrejton me 302 dhe `sso_error=SSO_STATE_MISSING` te faqja e hyrjes.

Demo-chatbot dhe SSO

POST /api/global-chatbot/demoDërgon një mesazh te chatbot-i publik demo në zentor-app.de/demo dhe kthen përgjigjen e tij. Demo-ja mund të provohet në shfletues pa regjistrim.GET /api/global-chatbot/demo/historyNgarkon historinë e mëparshme të mesazheve të një bisede demo, që të ruhet kur demo-ja hapet përsëri.POST /api/global-chatbot/demo/pollMerr mesazhet e reja të një bisede demo, për shembull kur një punonjës i Zentor e ka marrë përsipër bisedën. Faqja demo e thërret endpoint-in në intervale.POST /api/global-chatbot/demo/ratingRuaj vlerësimin e një bisede demo (e dobishme ose jo e dobishme) me koment opsional.POST /api/global-chatbot/demo/trackRegjistron ngjarje anonime të përdorimit të faqes demo për statistikat e vizitorëve të Zentor.POST /api/global-chatbot/demo/voice-transcribeKonverton një regjistrim zanor në faqen demo në tekst (hyrje me zë), nëse funksioni i zërit i demo-s është i aktivizuar.POST /api/global-chatbot/demo/voice-speakKonverton tekstin në të folur (prodhim zanor në faqen demo), nëse funksioni i zërit i demo-s është i aktivizuar.GET /api/sso/:tenantSlug/statusKontrollon nëse për një llogari është konfiguruar hyrja e njëhershme (SAML ose OIDC). Faqja e hyrjes e përdor rezultatin për të ofruar hyrjen SSO.GET /api/sso/:tenantSlug/oidc/startNis identifikimin përmes OpenID Connect dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.GET /api/sso/:tenantSlug/saml/startNis identifikimin përmes SAML dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): pranon përgjigjen e nënshkruar SAML të ofruesit të identitetit përmes formularit POST.GET /api/sso/:tenantSlug/saml/metadataKthen metadatat SAML të Zentor App (XML) për importim në ofruesin tuaj të identitetit.

Artikuj të lidhur

← Demo-chatbot dhe SSO