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

Assertion Consumer Service (ACS): pranon përgjigjen e nënshkruar SAML të ofruesit të identitetit përmes formularit POST.

Ky endpoint thirret ekskluzivisht nga ofruesi i identitetit; duhet të vendoset në cilësimet e tij si ACS-URL (shih `saml/metadata`). Ofruesi i identitetit dërgon përgjigjen e koduar base64, të nënshkruar, në fushën e formularit `SAMLResponse`. 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ëse përgjigja është e pavlefshme ose mungon procesi përkatës i hyrjes, serveri ridrejton te faqja e hyrjes me parametrin e kërkesës `sso_error`, për shembull `sso_error=SSO_STATE_MISSING`.

Përmbledhje

Thirrja: POST /api/sso/:tenantSlug/saml/acs. 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), SAMLResponse (body). 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
SAMLResponse(body, string, i detyrueshëm)— Përgjigja SAML e nënshkruar nga ofruesi i identitetit (XML, e koduar base64) si fushë formulari

Shembull response-i

Ridrejtim 302 te https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (shembull pa përgjigje SAML të vlefshme)

Kodet e gabimeve

302 SSO_STATE_MISSING — Ridrejtim te faqja e hyrjes me `sso_error`, nëse përgjigja SAML është e pavlefshme ose mungon procesi i hyrjes.

Sjellja e verifikuar

Një `SAMLResponse` i pavlefshëm çon në ridrejtim (302) me `sso_error` 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/oidc/callbackPranon ridrejtimin e ofruesit të identitetit pas hyrjes OIDC dhe ridrejton shfletuesin përsëri te Zentor App.GET /api/sso/:tenantSlug/saml/startNis identifikimin përmes SAML dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.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