GET/api/sso/:tenantSlug/saml/start
Begin die aanmelding per SAML en stuur die blaaier deur na die opgestelde identiteitsverskaffer.
Roep die eindpunt op deur blaaiernavigasie. Is SAML opgestel, antwoord die bediener met 'n omleiding (302) na die identiteitsverskaffer; sy antwoord gaan daarna na `saml/acs`. Is SAML vir die rekening nie opgestel nie, antwoord die bediener met 404 `SSO_NOT_CONFIGURED` en 'n JSON-foutboodskap.
Oorsig
Oproep: GET /api/sso/:tenantSlug/saml/start. 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 idempotent: herhaalde oproepe met dieselfde insette lewer dieselfde resultaat. Verpligte parameters: tenantSlug (pad). Gedokumenteerde foutgevalle: 404 -.
Verifikasie en sekuriteit
Geen verifikasie vereis nie
Idempotent: Ja
Parameters
tenantSlug(path, string, vereis)— Kenning (snitstring) van die rekening waarvoor SSO opgestel isVoorbeeldrespons
(302-omleiding na die identiteitsverskaffer, as SAML vir die rekening opgestel is)
Foutkodes
404 - — SAML is nie vir hierdie rekening opgestel nie.Gekontroleerde gedrag
Vir 'n rekening sonder SAML lewer die oproep 404.
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.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): neem die ondertekende SAML-antwoord van die identiteitsverskaffer per vorm-POST in ontvangs.GET /api/sso/:tenantSlug/saml/metadataLewer die SAML-metadata van Zentor App (XML) vir invoer in u identiteitsverskaffer.