SAML 2.0 nedir?

Kısa cevap

SAML 2.0 (Security Assertion Markup Language), kullanıcının kimliğini IdP (Identity Provider) ile uygulama, yani SP (Service Provider) arasında imzalı XML mesajlarıyla taşıyan OASIS standardıdır ve kurumsal SSO'nun yaygın temelidir (OASIS SAML 2.0). Kullanıcı uygulamaya geldiğinde IdP'ye yönlendirilir ve parolasını orada girer; IdP kullanıcının kim olduğunu bildiren imzalı bir yanıtla onu uygulamaya geri gönderir. TR7'de AGS bu akışta SP'dir: SAML 2.0 türündeki Authentication Provider kullanıcıyı IdP Single Sign-on URL adresine yönlendirir, dönen yanıtın imzasını IdP Signing Certificate ile doğrular ve kullanıcı bilgilerini yanıttaki assertion'dan okur. Microsoft Entra ID, ADFS, Keycloak ve Okta gibi SAML 2.0 destekleyen IdP'ler bu türle kullanılır.

TR7'de Nerede Kullanılır

Nerede	Alan / etiket	Ne için
AGS → Authentication → Authentication Providers	Provider Type = SAML 2.0	Kurumsal IdP ile SSO
AGS → Authentication → Authentication Providers	IdP Single Sign-on URL, IdP Entity ID (issuer), IdP Signing Certificate, Import Metadata	IdP'ye ait adres, kimlik ve signing certificate
AGS → Authentication → Authentication Providers	SP Entity ID, Assertion Consumer Service URL (varsayılan değeri /ags-portal/saml/acs)	IdP'deki uygulama kaydına yazılan TR7 bilgileri
AGS → Authentication → Authentication Providers	Require Signed Assertions (varsayılan açık), Require Signed Response (varsayılan kapalı), Clock Skew Tolerance (varsayılan değeri 5 dakika)	IdP yanıtının nasıl doğrulanacağı
AGS → Authentication → Authentication Providers	NameID Format, Force Re-Authentication, Authentication Request Binding	IdP'ye gönderilen kimlik doğrulama isteğinin içeriği ve iletim biçimi
AGS etkin vService → Flowchart	Authentication Provider adımı	SAML 2.0 sağlayıcısının erişim akışına eklenmesi

Sık Karıştırılan Noktalar

• "SAML'da parola TR7'ye gelir." Kullanıcı parolasını IdP'nin sayfasında girer; TR7 yalnızca IdP'nin imzalı yanıtını alır ve doğrular.
• "SAML ile OpenID Connect aynı şeydir." İkisi de SSO sağlar; SAML imzalı XML assertion, OpenID Connect ise JSON tabanlı ve imzalı ID token kullanır (OpenID Connect (OIDC) nedir?).
• "IdP signing certificate bir kez girilir, bir daha değişmez." IdP sertifikasını yenilediğinde TR7'deki sertifika da güncellenir; aksi hâlde yanıtların imzası doğrulanamaz ve giriş başarısız olur. Yeni metadata Import Metadata ile yeniden alınabilir.
• "Saat farkı önemsizdir." Assertion'ların geçerlilik zamanı denetlenir; TR7 ile IdP arasındaki fark Clock Skew Tolerance değerini aşarsa yanıt reddedilir (NTP nedir; TR7'de saat senkronizasyonu neden önemlidir?).

Dokümantasyonda nasıl yapılır

• SAML 2.0 · SAML 2.0 Nedir?
• SAML 2.0 · Import Metadata
• Authentication Providers · Provider Type Seçenekleri

İlgili sorular

• IdP (Identity Provider) ile SP (Service Provider) arasındaki fark nedir?
• SAML assertion nedir?
• SAML metadata nedir?
• SSO (Single Sign-On) nedir?