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

Assertion Consumer Service (ACS): neem die ondertekende SAML-antwoord van die identiteitsverskaffer per vorm-POST in ontvangs.

Hierdie eindpunt word uitsluitlik deur die identiteitsverskaffer opgeroep; dit moet in sy instellings as ACS-URL ingevoer word (sien `saml/metadata`). Die identiteitsverskaffer stuur die base64-geënkodeerde, ondertekende antwoord in die vormveld `SAMLResponse`. By sukses lei Zentor App die blaaier terug met die eenmalige kode in die navraagparameter `sso_code`; hierdie kode word via `POST /api/auth/sso/exchange` vir 'n toegangstoken verruil. Is die antwoord ongeldig of ontbreek die bybehorende aanmeldproses, lei die bediener na die aanmeldbladsy met die navraagparameter `sso_error`, byvoorbeeld `sso_error=SSO_STATE_MISSING`.

Oorsig

Oproep: POST /api/sso/:tenantSlug/saml/acs. Hierdie eindpunt behoort tot die groep “Demo-kletsbot en SSO” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: tenantSlug (pad), SAMLResponse (body). Gedokumenteerde foutgevalle: 302 SSO_STATE_MISSING.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Idempotent: Nee

Parameters

tenantSlug(path, string, vereis)— Kenning (snitstring) van die rekening waarvoor SSO opgestel is
SAMLResponse(body, string, vereis)— Deur die identiteitsverskaffer ondertekende SAML-antwoord (XML, base64-geënkodeer) as vormveld

Voorbeeldrespons

302-omleiding na https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (voorbeeld sonder geldige SAML-antwoord)

Foutkodes

302 SSO_STATE_MISSING — Omleiding na die aanmeldbladsy met `sso_error`, as die SAML-antwoord ongeldig is of die bybehorende aanmeldproses ontbreek.

Gekontroleerde gedrag

'n Ongeldige `SAMLResponse` lei tot die omleiding (302) met `sso_error` na die aanmeldbladsy.

Demo-kletsbot en SSO

POST /api/global-chatbot/demoStuur 'n boodskap aan die openbare demo-kletsbot op zentor-app.de/demo en lewer sy antwoord. Die demo kan sonder registrasie in die blaaier probeer word.GET /api/global-chatbot/demo/historyLaai die vorige boodskapgeskiedenis van 'n demo-gesprek sodat dit behoue bly wanneer die demo weer oopgemaak word.POST /api/global-chatbot/demo/pollHaal nuwe boodskappe van 'n demo-gesprek op, byvoorbeeld wanneer 'n personeellid van Zentor die gesprek oorgeneem het. Die demo-blad roep die eindpunt op gereelde tussenposes aan.POST /api/global-chatbot/demo/ratingStoor die beoordeling van 'n demo-gesprek (nuttig of nie nuttig nie) met opsionele kommentaar.POST /api/global-chatbot/demo/trackRegistreer anonieme gebruiksgebeure van die demo-blad vir Zentor se besoekerstatistieke.POST /api/global-chatbot/demo/voice-transcribeOmskep 'n klankopname op die demo-blad na teks (spraakinvoer), indien die spraakfunksie van die demo geaktiveer is.POST /api/global-chatbot/demo/voice-speakVerander teks in gesproke taal (spraakuitvoer op die demobladsy), mits die spraakfunksie van die demo geaktiveer is.GET /api/sso/:tenantSlug/statusKyk of enkelaanmelding (SAML of OIDC) vir 'n rekening opgestel is. Die aanmeldbladsy gebruik die resultaat om die SSO-aanmelding aan te bied.GET /api/sso/:tenantSlug/oidc/startBegin die aanmelding per OpenID Connect en stuur die blaaier deur na die opgestelde identiteitsverskaffer.GET /api/sso/:tenantSlug/oidc/callbackNeem die omleiding van die identiteitsverskaffer ná die OIDC-aanmelding in ontvangs en stuur die blaaier terug na Zentor App.GET /api/sso/:tenantSlug/saml/startBegin die aanmelding per SAML en stuur die blaaier deur na die opgestelde identiteitsverskaffer.GET /api/sso/:tenantSlug/saml/metadataLewer die SAML-metadata van Zentor App (XML) vir invoer in u identiteitsverskaffer.

Verwante artikels

← Demo-kletsbot en SSO