POST/api/auth/sso/exchange

Bir SSO oturum açmanın (SAML/OIDC) son adımı: yönlendirmeden gelen tek seferlik kodu bir erişim belirteci ve bir yenileme belirteciyle değiştirir.

Kimlik sağlayıcıda oturum açtıktan sonra Zentor App, tarayıcıyı `sso_code` sorgu parametresindeki tek seferlik bir kodla geri yönlendirir. Bu kodu `code` alanında gönderin. Yanıt, normal bir oturum açmadaki gibi `token` ve `refreshToken` içerir. Her kod yalnızca bir kez ve kısa bir süre için geçerlidir. Zaten kullanılmış, süresi dolmuş veya geçersiz bir kod 400 `SSO_EXCHANGE_INVALID` ile sonuçlanır; kullanıcı daha sonra SSO ile oturum açmayı yeniden başlatır. Bu nedenle çağrı idempotent değildir.

Genel Bakış

Çağrı: POST /api/auth/sso/exchange. Bu uç nokta, Zentor App API'sinin “Kimlik Doğrulama” 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: code (Body). Belgelenmiş hata durumları: 400 SSO_EXCHANGE_INVALID. Aşağıdaki örnek yanıt, JSON formatındaki başarılı bir yanıtın yapısını gösterir.

Kimlik Doğrulama ve Güvenlik

Kimlik doğrulama gerekmez

İdempotent: Hayır

Parametreler

code(body, string, zorunlu)— SSO yönlendirmesinden tek seferlik kod

Örnek İstek

{"code":"<SSO geri arama yönlendirmesinden gelen tek kullanımlık kod>"}

Örnek Yanıt

{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}

Hata Kodları

400 SSO_EXCHANGE_INVALID — Kod geçersiz, zaten kullanılmış veya süresi dolmuş.

Doğrulanmış davranış

Geçersiz bir kod 400 `SSO_EXCHANGE_INVALID` döndürür. Başarı durumu, kurulan kimlik sağlayıcıda eksiksiz bir oturum açmayı gerektirir.

Kimlik Doğrulama

İlgili makaleler

← Kimlik Doğrulama