GET/api/sso/:tenantSlug/oidc/callback
Hupokea uelekezaji wa mtoa huduma wa utambulisho baada ya kuingia kwa OIDC na kurudisha kivinjari kwa Zentor App.
Njia hii inafikiwa pekee na mtoa huduma wa utambulisho kupitia uelekezaji wa kivinjari; inapaswa kuingizwa katika mipangilio yake kama redirect-URI. Ikifanikiwa, Zentor App hurudisha kivinjari pamoja na msimbo wa mara moja katika query-parameter `sso_code`; msimbo huu hubadilishwa kwa tokeni ya ufikiaji kupitia `POST /api/auth/sso/exchange`. Ikiwa kuna hitilafu – kwa mfano ikiwa query-parameter ya usalama `state` haipo au si sahihi – seva huelekeza kwenye ukurasa wa kuingia na query-parameter `sso_error`, kwa mfano `sso_error=SSO_STATE_MISSING`. Anzisheni kuingia upya.
Muhtasari
Mwito: GET /api/sso/:tenantSlug/oidc/callback. Endpoint hii ni sehemu ya kundi la “Chatbot ya demo na SSO” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: tenantSlug (path). Hali za hitilafu zilizoandikwa: 302 SSO_STATE_MISSING.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Hapana
Vigezo
tenantSlug(path, string, inahitajika)— Kitambulisho (slug) cha akaunti ambayo SSO imewekwaMfano wa jibu (response)
Uelekezaji wa 302 kwa https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (mfano bila `state` sahihi)
Misimbo ya hitilafu
302 SSO_STATE_MISSING — Uelekezaji kwenye ukurasa wa kuingia na `sso_error`, ikiwa `state` haipo au si sahihi.Tabia iliyoangaliwa
Bila `state` sahihi, seva huelekeza kwa 302 na `sso_error=SSO_STATE_MISSING` kwenye ukurasa wa kuingia.
Chatbot ya demo na SSO
POST /api/global-chatbot/demoHutuma ujumbe kwa boti ya onyesho ya umma kwenye zentor-app.de/demo na hutoa jibu lake. Onyesho linaweza kujaribiwa bila kujisajili kwenye kivinjari.GET /api/global-chatbot/demo/historyHupakia historia ya awali ya ujumbe wa mazungumzo ya onyesho ili ihifadhiwe wakati onyesho linapofunguliwa tena.POST /api/global-chatbot/demo/pollHupata ujumbe mpya wa mazungumzo ya onyesho, kwa mfano wakati mfanyakazi wa Zentor amechukua mazungumzo. Ukurasa wa onyesho huita kituo kwa vipindi.POST /api/global-chatbot/demo/ratingHuhifadhi tathmini ya mazungumzo ya onyesho (ya manufaa au si ya manufaa) na maoni ya hiari.POST /api/global-chatbot/demo/trackHurekodi matukio ya matumizi yasiyojulikana ya ukurasa wa onyesho kwa takwimu za wageni wa Zentor.POST /api/global-chatbot/demo/voice-transcribeHubadilisha rekodi ya sauti kwenye ukurasa wa onyesho kuwa maandishi (ingizo la sauti), ikiwa kipengele cha sauti cha onyesho kimewezeshwa.POST /api/global-chatbot/demo/voice-speakHubadilisha maandishi kuwa sauti inayosemwa (matamshi kwenye ukurasa wa demo), ikiwa kipengele cha sauti cha demo kimewezeshwa.GET /api/sso/:tenantSlug/statusHuangalia kama kuingia mara moja (SAML au OIDC) kumewekwa kwa akaunti. Ukurasa wa kuingia hutumia matokeo kutoa kuingia kwa SSO.GET /api/sso/:tenantSlug/oidc/startHuanzisha kuingia kupitia OpenID Connect na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.GET /api/sso/:tenantSlug/saml/startHuanzisha kuingia kupitia SAML na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): hupokea jibu la SAML lililotiwa saini kutoka mtoa huduma wa utambulisho kwa fomu ya POST.GET /api/sso/:tenantSlug/saml/metadataHutoa metadata ya SAML ya Zentor App (XML) kwa kuingiza kwenye mtoa huduma wenu wa utambulisho.