GET/api/sso/:tenantSlug/saml/start
Start het aanmelden via SAML en leidt de browser door naar de ingerichte identity provider.
Roep het endpoint aan via browsernavigatie. Is SAML ingericht, dan antwoordt de server met een doorverwijzing (302) naar de identity provider; het antwoord daarvan gaat vervolgens naar `saml/acs`. Is SAML niet ingericht voor het account, dan antwoordt de server met 404 `SSO_NOT_CONFIGURED` en een JSON-foutmelding.
Overzicht
Aanroep: GET /api/sso/:tenantSlug/saml/start. Dit endpoint hoort bij de groep ‘Demo-chatbot en SSO’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is idempotent: herhaalde aanroepen met dezelfde gegevens leveren hetzelfde resultaat op. Verplichte parameters: tenantSlug (pad). Gedocumenteerde foutgevallen: 404 -.
Auth & beveiliging
Geen authenticatie vereist
Idempotent: Ja
Parameters
tenantSlug(path, string, vereist)— Identificatie (slug) van het account waarvoor SSO is ingerichtVoorbeeld-response
(302-doorverwijzing naar de identity provider als SAML voor het account is ingericht)
Foutcodes
404 - — SAML is niet ingericht voor dit account.Geverifieerd gedrag
Voor een account zonder SAML levert de aanroep 404.
Demo-chatbot en SSO
POST /api/global-chatbot/demoVerzendt een bericht naar de openbare demo-chatbot op zentor-app.de/demo en levert het antwoord daarvan. De demo kan zonder registratie in de browser worden uitgeprobeerd.GET /api/global-chatbot/demo/historyLaadt de bestaande berichtgeschiedenis van een demogesprek, zodat deze behouden blijft bij het opnieuw openen van de demo.POST /api/global-chatbot/demo/pollHaalt nieuwe berichten van een demogesprek op, bijvoorbeeld wanneer een medewerker van Zentor het gesprek heeft overgenomen. De demopagina roept het endpoint met tussenpozen aan.POST /api/global-chatbot/demo/ratingSlaat de beoordeling van een demogesprek op (nuttig of niet nuttig) met een optionele opmerking.POST /api/global-chatbot/demo/trackRegistreert anonieme gebruiksgebeurtenissen van de demopagina voor de bezoekersstatistieken van Zentor.POST /api/global-chatbot/demo/voice-transcribeZet een spraakopname op de demopagina om in tekst (spraakinvoer), als de spraakfunctie van de demo is ingeschakeld.POST /api/global-chatbot/demo/voice-speakZet tekst om in gesproken taal (spraakuitvoer op de demopagina), als de spraakfunctie van de demo is ingeschakeld.GET /api/sso/:tenantSlug/statusControleert of single sign-on (SAML of OIDC) is ingericht voor een account. De aanmeldpagina gebruikt het resultaat om de SSO-aanmelding aan te bieden.GET /api/sso/:tenantSlug/oidc/startStart het aanmelden via OpenID Connect en leidt de browser door naar de ingerichte identity provider.GET /api/sso/:tenantSlug/oidc/callbackOntvangt de doorverwijzing van de identity provider na de OIDC-aanmelding en leidt de browser terug naar Zentor App.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): ontvangt het ondertekende SAML-antwoord van de identity provider via een formulier-POST.GET /api/sso/:tenantSlug/saml/metadataLevert de SAML-metadata van Zentor App (XML) voor import in uw identity provider.