Backend SSO nedir; AGS kullanıcının kimliğini uygulamaya nasıl aktarır?

Kısa cevap

Backend SSO, AGS'nin doğruladığı kullanıcının kimliğini Kurum Servisine giden isteğe ekleyerek aktarmasıdır; uygulama kullanıcıdan ikinci kez giriş istemez. TR7'de bu iş Backend SSO Configurations profiliyle yapılır: profildeki Injections, oturumu doğrulanmış her isteğe kimliği Header, Basic Auth, Bearer Token ya da Cookie olarak ekler; değerler AGS Variables (ör. AGS username, AGS user groups) ile oturumdan üretilir. Profil, vService'in AGS ayarlarındaki Backend SSO Config alanında seçilir; her vService tek profil kullanır ve alan boşken kimlik aktarılmaz.

Nasıl Çalışır?

1. Kullanıcı erişim akışında (Flowchart) doğrulanır; kullanıcı adı, e-posta, gruplar ve Assign User Attributes adımıyla eklenen öznitelikler oturuma yazılır.
2. Oturumu geçerli kullanıcının Kurum Servisine giden her isteğine enjeksiyonlar eklenir. Enjeksiyona Condition verilmişse yalnız koşula uyan isteklere eklenir; oturumu olmayan isteklere hiçbir zaman eklenmez.
3. İstemcinin kendi gönderdiği aynı adlı header ve cookie her istekte önce silinir; Basic Auth ve Bearer Token enjeksiyonlarında yazılan header (varsayılan Authorization) da silinir. Kimlik bilgisini yalnızca TR7 yazar.
4. AGS'nin kendi oturum cookie'leri Kurum Servisine iletilmeden istekten çıkarılır.

Type	Kurum Servisine giden	Tipik kullanım
Header	Header name ve Header value ile tanımlanan header (ör. X-Remote-User)	Kimliği bir header'dan okuyan uygulamalar
Basic Auth	Authorization: Basic …; Username source ve Password source değerlerinden üretilir	HTTP Basic kimlik doğrulaması bekleyen uygulamalar
Bearer Token	Authorization: Bearer …; header adı Header Name Override ile değiştirilir	Token bekleyen API'ler
Cookie	Cookie name ve Cookie value ile tanımlanan cookie	Oturumu cookie ile tanıyan uygulamalar

Kurum Servisi Oturumunun İzlenmesi

Profil, Kurum Servisinin yanıtını da izleyebilir; iki koşul da Conditions kayıtlarından istek ve yanıt tarafı koşullarıyla kurulur:

• Backend Logout Condition: Kurum Servisinin kendi çıkışını gösteren yanıt eşleştiğinde AGS oturumu da kapatılır ve kullanıcı Redirect after Logout adresine yönlendirilir; alan boşsa / kullanılır. Yönlendirme biçimi Redirect Modes ile seçilir: HTTP 302 redirect (varsayılan) ve/veya Custom header.
• Backend Session Lost Condition: Kurum Servisinin oturumu düşürdüğünü gösteren yanıt eşleştiğinde Backend Session Lost Strategy uygulanır. Log the user out (varsayılan) kullanıcıyı AGS'nin oturum kaybı sayfasına yönlendirir. Re-sync, Flowchart'taki Backend SSO (Re)Sync kutusunun bağlandığı adımı çalıştırarak Kurum Servisi oturumunu yeniden kurar; Max Auto Retries (varsayılan 2, 0–10) kullanıcıdan etkileşim istenmeden yapılacak deneme sayısıdır. Bu stratejide yeni açılan her AGS oturumunun ilk isteğinde de aynı adım çalışır.

İki koşul aynı yanıtta eşleşirse çıkış önceliklidir.

TR7'de Backend SSO

Nerede	Alan	Ne belirler
AGS → Integrations → Backend SSO Configurations	Injections, Backend Session Lost Condition, Backend Logout Condition ve bağlı alanlar	Kimliğin hangi biçimde aktarılacağı ve Kurum Servisi oturumunun nasıl izleneceği
AGS etkin vService → Flowchart → General Settings → Backend SSO	Backend SSO Config	vService'in kullandığı profil
AGS etkin vService → Flowchart	Backend SSO (Re)Sync kutusu	Re-sync stratejisinde çalışacak adım; yalnızca strateji Re-sync iken görünür
AGS etkin vService → AGS Management	Corporate service sign-on kutusu	Seçili profilin salt okunur özeti

Kurum Servisi tarafında kod değişikliği gerekmez; uygulama, enjekte edilen header ya da cookie'yi kullanıcı kimliği olarak okuyacak şekilde ayarlanır ve yalnızca TR7 üzerinden erişilebilir tutulur.

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

• "Backend SSO bir IdP bağlantısıdır." Profil kullanıcıyı doğrulamaz; erişim akışında zaten doğrulanmış kimliği Kurum Servisinin beklediği biçimde isteğe ekler. IdP bağlantısı Authentication Providers ile kurulur.
• "İstemci kendi X-Remote-User header'ını gönderirse uygulamaya ulaşır." Profildeki header ve cookie adları istemciden geldiğinde her istekte silinir; değeri yalnızca TR7 yazar.
• "Redirect after Logout, oturum kaybında da kullanılır." Bu adres yalnız Backend Logout Condition eşleşmesinde kullanılır; Log the user out stratejisi kullanıcıyı AGS'nin oturum kaybı sayfasına götürür.
• "Re-sync için profil yeterlidir." Re-sync seçildiğinde Flowchart'ta Backend SSO (Re)Sync kutusunun bir adıma bağlanması gerekir.

Dokümantasyonda nasıl yapılır

• Backend SSO Configurations · Nedir?
• Backend SSO Configurations · Çalışma Mekanizması
• Variables · AGS Variables
• Flowchart · Backend SSO Config

İlgili sorular

• AGS'yi uygulamamın önüne koyarsam uygulamada kod değişikliği gerekir mi?
• AGS bir SSO çözümü müdür; identity provider (IdP) olarak kullanılabilir mi?
• SSO (Single Sign-On) nedir?
• Bearer Token nedir?