AGS'yi uygulamamın önüne koyarsam uygulamada kod değişikliği gerekir mi?

Kısa cevap

Hayır. Giriş sayfası, kimlik doğrulama, MFA ve oturum yönetimi AGS tarafından TR7'de yürütülür; oturumu olmayan istek uygulamaya hiç ulaşmaz. Uygulamanın kullanıcıyı tanıması gerekiyorsa kimlik, uygulamanın zaten desteklediği bir yolla eklenir: Backend SSO Configurations profilindeki Injections ile header, Basic Auth, Bearer Token ya da cookie olarak. Uygulamada /ags-portal ile başlayan bir yol varsa yalnızca AGS Root Path değiştirilir, çünkü bu yoldaki istekler AGS'ye gider.

Nasıl Çalışır?

1. Oturumu olmayan kullanıcı giriş akışına alınır; uygulama bu istekleri görmez.
2. Oturumla gelen istekler Kurum Servisine iletilir. AGS'nin kendi cookie'leri istekten çıkarılır; uygulamanın cookie'leri olduğu gibi kalır.
3. vService'e bir Backend SSO profili bağlıysa enjeksiyonlar oturumu doğrulanmış isteğe eklenir. Aynı adla istemciden gelen header ya da cookie önce silinir; uygulamaya ulaşan kimlik bilgisi yalnızca AGS'den gelir.

Değerler %AGS_USERNAME, %AGS_EMAIL, %AGS_GROUPS, %AGS_USER_ATTR(department) gibi AGS değişkenleri ile oturumdan doldurulur.

TR7'de Uygulamanın Durumuna Göre

Uygulama	AGS tarafında yapılan
Kimlik doğrulaması yok, kullanıcıyı tanıması da gerekmiyor	Yalnızca AGS açılır ve akış kurulur; Backend SSO gerekmez.
Kullanıcıyı bir HTTP header'ından okuyor	Header enjeksiyonu (Header Name, Header Value)
HTTP Basic Auth bekliyor	Basic Auth enjeksiyonu (Username Source, Password Source)
Bearer Token bekliyor	Bearer Token enjeksiyonu
Kimliği bir cookie'den okuyor	Cookie enjeksiyonu (Cookie Name, Cookie Value)
Yalnızca kendi giriş formu var	Kimlik Web Form sağlayıcısıyla uygulamanın kendi formunda doğrulanır

Profil vService'e Flowchart sekmesindeki General Settings penceresinin Backend SSO Config alanında bağlanır. Uygulamanın kendi oturumu düştüğünde ya da kullanıcı uygulamadan çıktığında ne olacağını aynı profildeki Backend Session Lost Strategy ve Backend Logout Condition belirler.

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

• "Uygulama OAuth2 ya da SAML 2.0 desteklemiyorsa AGS bu sağlayıcıları kullanamaz." Dış identity provider (IdP) ile konuşan AGS'dir; uygulama yalnızca Backend SSO ile eklenen kimliği okur ya da hiç okumaz.
• "Header ile aktarılan kimlik istemci tarafından taklit edilebilir." Enjekte edilen header ve cookie adları istemciden geldiğinde önce silinir; uygulamaya ulaşan değer AGS'nin yazdığı değerdir.
• "AGS Root Path yalnızca tam eşleşmede yakalanır." Eşleşme metin önekiyle yapılır; uygulamada aynı önekle başlayan bir yol varsa AGS Root Path değiştirilir (AGS Activation Condition ve AGS Root Path neyi belirler?).

Dokümantasyonda nasıl yapılır

• AGS - AAM · Kimlik aktarımı
• Backend SSO Configurations · Backend SSO Configurations nedir
• Backend SSO Configurations · Injections
• Flowchart · AGS Root Path

İlgili sorular

• Backend SSO nedir; AGS kullanıcının kimliğini uygulamaya nasıl aktarır?
• Kimlik doğrulama nerede yapılır: TR7'de mi, uygulamada mı, identity provider'da mı?
• Web Form, HTTP ve Portal provider'ları ne işe yarar?