GET/api/sso/:tenantSlug/oidc/callback
OIDC girişinden sonra kimlik sağlayıcının yönlendirmesini alır ve tarayıcıyı Zentor App'e geri yönlendirir.
Bu uç nokta yalnızca kimlik sağlayıcı tarafından tarayıcı yönlendirmesiyle çağrılır; onun ayarlarında yönlendirme URI'si (redirect URI) olarak girilmelidir. Başarılı olursa, Zentor App tarayıcıyı sorgu parametresi `sso_code`'daki tek kullanımlık kodla geri yönlendirir; bu kod `POST /api/auth/sso/exchange` üzerinden bir erişim belirteciyle değiştirilir. Bir hata durumunda – örneğin güvenlik parametresi `state` eksik veya geçersizse – sunucu, `sso_error` sorgu parametresiyle giriş sayfasına yönlendirir, örneğin `sso_error=SSO_STATE_MISSING`. Bu durumda girişi yeniden başlatın.
Genel Bakış
Çağrı: GET /api/sso/:tenantSlug/oidc/callback. Bu uç nokta, Zentor App API'sinin “Demo Sohbet Botu ve SSO” grubuna aittir. Herkese açıktır ve kimlik doğrulama gerektirmez. Çağrı idempotent değildir: Her başarılı çağrı işlemi yeniden tetikler. Zorunlu parametreler: tenantSlug (Path). Belgelenmiş hata durumları: 302 SSO_STATE_MISSING.
Kimlik Doğrulama ve Güvenlik
Kimlik doğrulama gerekmez
İdempotent: Hayır
Parametreler
tenantSlug(path, string, zorunlu)— SSO'nun kurulu olduğu hesabın kimliği (slug)Örnek Yanıt
https://zentor-app.de/login?sso_error=SSO_STATE_MISSING adresine 302 yönlendirme (geçerli bir `state` olmadan örnek)
Hata Kodları
302 SSO_STATE_MISSING — `state` eksikse veya geçersizse giriş sayfasına `sso_error` ile yönlendirme.Doğrulanmış davranış
Geçerli bir `state` olmadan, sunucu 302 ve `sso_error=SSO_STATE_MISSING` ile giriş sayfasına yönlendirir.
Demo Sohbet Botu ve SSO
POST /api/global-chatbot/demozentor-app.de/demo adresindeki genel demo sohbet botuna bir mesaj gönderir ve onun yanıtını döndürür. Demo, tarayıcıda kayıt olmadan denenebilir.GET /api/global-chatbot/demo/historyDemo tekrar açıldığında korunması için bir demo konuşmasının mevcut mesaj geçmişini yükler.POST /api/global-chatbot/demo/pollBir demo konuşmasının yeni mesajlarını alır, örneğin bir Zentor çalışanı görüşmeyi devraldığında. Demo sayfası uç noktayı belirli aralıklarla çağırır.POST /api/global-chatbot/demo/ratingBir demo konuşmasının değerlendirmesini (yararlı veya yararlı değil) isteğe bağlı bir yorumla kaydeder.POST /api/global-chatbot/demo/trackZentor'un ziyaretçi istatistiği için demo sayfasının anonim kullanım olaylarını kaydeder.POST /api/global-chatbot/demo/voice-transcribeDemo sayfasındaki bir ses kaydını metne dönüştürür (sesli giriş), demo'nun ses özelliği etkinleştirilmişse.POST /api/global-chatbot/demo/voice-speakMetni konuşmaya dönüştürür (demo sayfasında sesli çıkış), demo'nun ses özelliği etkinleştirilmişse.GET /api/sso/:tenantSlug/statusBir hesap için tek oturum açmanın (SAML veya OIDC) kurulu olup olmadığını kontrol eder. Giriş sayfası, SSO girişini sunmak için sonucu kullanır.GET /api/sso/:tenantSlug/oidc/startOpenID Connect ile girişi başlatır ve tarayıcıyı kurulu kimlik sağlayıcıya yönlendirir.GET /api/sso/:tenantSlug/saml/startSAML ile girişi başlatır ve tarayıcıyı kurulu kimlik sağlayıcıya yönlendirir.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): kimlik sağlayıcının imzalı SAML yanıtını form POST ile alır.GET /api/sso/:tenantSlug/saml/metadataKimlik sağlayıcınıza içe aktarmak için Zentor App'in SAML meta verilerini (XML) sunar.