Smarter by Design.Simpler for Business
TR7Enterprise Application Delivery & Security Platform
SAML metadata nedir?
Kısa cevap
SAML metadata, bir IdP'nin ya da SP'nin SAML için gereken bilgilerini tek bir XML belgesinde tanımlar: entity ID, SSO ve logout adresleri ile binding'leri, signing certificate ve desteklenen NameID biçimleri (OASIS SAML 2.0 Metadata). Taraflar birbirinin metadata'sını içe aktararak bu bilgileri elle yazmadan eşleşir. TR7 AGS'de SAML 2.0 formundaki Import Metadata butonu açılan pencerenin Metadata XML alanına yapıştırılan IdP metadata'sından IdP Single Sign-on URL, IdP Entity ID (issuer), IdP Signing Certificate ve listedeki biçimlerden biriyse NameID Format alanlarını doldurur. XML tarayıcıda ayrıştırılır; TR7 metadata'yı IdP'den kendisi indirmez. TR7'nin SP bilgileri (SP Entity ID ve Assertion Consumer Service URL) IdP'deki uygulama kaydına elle yazılır.
TR7'de Nerede Kullanılır
| Nerede | Alan / etiket | Ne için |
|---|---|---|
| AGS → Authentication → Authentication Providers (SAML 2.0) | Import Metadata → Import Identity Provider Metadata penceresi → Metadata XML | IdP bilgilerinin metadata'dan doldurulması |
| Aynı form | IdP Single Sign-on URL, IdP Entity ID (issuer), IdP Signing Certificate, NameID Format | Metadata'dan dolan alanlar; elle de girilebilir |
| Aynı form | SP Entity ID, Assertion Consumer Service URL | IdP'deki uygulama kaydına yazılan TR7 bilgileri |
Metadata'dan Hangi Bilgi Alınır?
| Metadata öğesi | Doldurulan TR7 alanı |
|---|---|
| IDPSSODescriptor içindeki SingleSignOnService (önce HTTP-Redirect binding'i, yoksa HTTP-POST, o da yoksa ilk kayıt) | IdP Single Sign-on URL |
EntityDescriptor'daki entityID | IdP Entity ID (issuer) |
| Signing (ya da kullanım türü belirtilmemiş) KeyDescriptor'lardaki X.509 sertifikaları, PEM biçiminde | IdP Signing Certificate |
| İlk NameIDFormat; Unspecified, Email Address, Persistent ya da Transient'tan biriyse | NameID format |
SSO adresi ya da signing certificate bulunamazsa içe aktarma başarısız olur ve pencere açık kalır. Authentication Request Binding alanı metadata'dan değişmez.
Sık Karıştırılan Noktalar
- "Metadata gizli bir belgedir." Metadata yalnızca paylaşılması gereken bilgileri (adresler, public sertifika) içerir; private key taşımaz.
- "Metadata bir kez içe aktarılınca güncel kalır." TR7 metadata'yı yalnızca içe aktarıldığı anda okur; IdP sertifikasını ya da adreslerini değiştirdiğinde güncel metadata yeniden içe aktarılır ya da alanlar elle güncellenir.
- "Metadata içe aktarmak SP tarafını da yapılandırır." Import Metadata yalnızca IdP alanlarını doldurur; IdP'de TR7 için uygulama kaydı ayrıca oluşturulur.
Dokümantasyonda nasıl yapılır
