POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): recebe a resposta SAML assinada do fornecedor de identidade através de um POST de formulário.
Este endpoint só é chamado pelo fornecedor de identidade; deve ser introduzido como URL de ACS nas suas definições (ver `saml/metadata`). O fornecedor de identidade envia a resposta assinada, codificada em base64, no campo de formulário `SAMLResponse`. Em caso de sucesso, a Zentor App redireciona o navegador de volta com o código de utilização única no parâmetro de consulta `sso_code`; este código é trocado por um token de acesso através de `POST /api/auth/sso/exchange`. Se a resposta for inválida ou faltar o processo de autenticação associado, o servidor redireciona para a página de autenticação com o parâmetro de consulta `sso_error`, por exemplo `sso_error=SSO_STATE_MISSING`.
Visão geral
Chamada: POST /api/sso/:tenantSlug/saml/acs. Este endpoint pertence ao grupo «Chatbot de demonstração e SSO» da API da Zentor App. É de acesso público e não requer autenticação. A chamada não é idempotente: cada chamada bem-sucedida volta a desencadear a ação. Parâmetros obrigatórios: tenantSlug (caminho), SAMLResponse (body). Casos de erro documentados: 302 SSO_STATE_MISSING.
Autenticação e segurança
Não é necessária autenticação
Idempotente: Não
Parâmetros
tenantSlug(path, string, obrigatório)— Identificador (slug) da conta para a qual o SSO está configuradoSAMLResponse(body, string, obrigatório)— Resposta SAML assinada pelo fornecedor de identidade (XML, codificada em base64) como campo de formulárioResposta de exemplo
Redirecionamento 302 para https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (exemplo sem resposta SAML válida)
Códigos de erro
302 SSO_STATE_MISSING — Redirecionamento para a página de autenticação com `sso_error` se a resposta SAML for inválida ou faltar o processo de autenticação.Comportamento verificado
Uma `SAMLResponse` inválida conduz a um redirecionamento (302) para a página de autenticação com `sso_error`.
Chatbot de demonstração e SSO
POST /api/global-chatbot/demoEnvia uma mensagem para o chatbot de demonstração público em zentor-app.de/demo e devolve a sua resposta. A demonstração pode ser testada no navegador sem registo.GET /api/global-chatbot/demo/historyCarrega o histórico de mensagens de uma conversa de demonstração para que seja preservado ao reabrir a demonstração.POST /api/global-chatbot/demo/pollObtém novas mensagens de uma conversa de demonstração, por exemplo quando um colaborador da Zentor assumiu a conversa. A página de demonstração chama o endpoint em intervalos.POST /api/global-chatbot/demo/ratingGuarda a avaliação de uma conversa de demonstração (útil ou não útil) com um comentário opcional.POST /api/global-chatbot/demo/trackRegista eventos de utilização anónimos da página de demonstração para as estatísticas de visitantes da Zentor.POST /api/global-chatbot/demo/voice-transcribeConverte uma gravação de voz na página de demonstração em texto (entrada de voz), se a funcionalidade de voz da demonstração estiver ativada.POST /api/global-chatbot/demo/voice-speakConverte texto em voz (saída de voz na página de demonstração), se a funcionalidade de voz da demonstração estiver ativada.GET /api/sso/:tenantSlug/statusVerifica se o início de sessão único (SAML ou OIDC) está configurado para uma conta. A página de autenticação utiliza o resultado para oferecer o início de sessão SSO.GET /api/sso/:tenantSlug/oidc/startInicia o início de sessão via OpenID Connect e redireciona o navegador para o fornecedor de identidade configurado.GET /api/sso/:tenantSlug/oidc/callbackRecebe o redirecionamento do fornecedor de identidade após o início de sessão OIDC e redireciona o navegador de volta para a Zentor App.GET /api/sso/:tenantSlug/saml/startInicia o início de sessão via SAML e redireciona o navegador para o fornecedor de identidade configurado.GET /api/sso/:tenantSlug/saml/metadataDevolve os metadados SAML da Zentor App (XML) para importação no seu fornecedor de identidade.