Portal Application

Portal Application Nedir?

Portal Application modunda vService kendi giriş sayfalarını sunmaz; kullanıcının oturumunu Trusted Portals listesinde seçilen Portal modundaki vService'lerden devralır. Oturumu olmayan ziyaretçi güvenilen portala yönlendirilir, portalda giriş yaptıktan sonra oturumuyla uygulamaya döner ve yeniden giriş yapmadan uygulamayı kullanır.

Bu mod, bir portalın Portal Applications listesinde yayımlanan uygulamanın vService'inde seçilir. Portal oturum çerezinin uygulama adresine ulaşmadığı durumlarda (uygulama adresinin portalın Cookie Domain değeri dışında kalması) oturum, portalın aktarım adresi üzerinden bu vService'e taşınır.

Kendi giriş akışıyla çalışan uygulamalar için Standalone Application modu kullanılır. Portal Application modunda vService'in Flowchart sekmesinde Start kutusu bulunmaz.

4 Alan

Gateway Mode Bölümü

Gateway Mode · Cookie Domain · Cookie Name Prefix · Trusted Portals

Start Yok

Giriş Akışı

Oturum portaldan gelir; Start kutusu bulunmaz

302

Oturumsuz İstek

Portal URL değeri tanımlı ilk güvenilen portalın aktarım adresine yönlendirilir

401

Aktarım Belirteci

Belirteç yoksa, imzası geçersizse ya da süresi dolmuşsa aktarım reddedilir

Portaldan

Çerez Öneki

Automatic konumunda önek tanımlı ilk güvenilen portalın öneki kullanılır

Kurum Servisi

Varsayılan Hedef

Oturumlu, aksiyonla eşleşmeyen istekler varsayılan Kurum Servisine gider

Portal Application Nasıl Çalışır?

vService'e gelen istek trafik motorunda değerlendirilir:

1. Oturumu olmayan istek: AGS Root Path dışındaki bir adrese oturumsuz gelen ziyaretçi, Trusted Portals listesinde Portal URL değeri tanımlı ilk portalın aktarım adresine (ör. https://portal.company.com/ags-portal/handoff) HTTP 302 ile yönlendirilir. Yönlendirmeye bu vService'in kimliği ve ziyaretçinin ilk istediği adres eklenir. Liste sırası esas alınır; ziyaretçinin hangi portaldan geldiğine bakılmaz.
2. Aktarımın kabulü: Portalda oturum doğrulandıktan sonra ziyaretçi, imzalı ve süreli bir belirteçle bu vService'in AGS Root Path altındaki /handoff-accept aktarım kabul adresine gönderilir. Belirteç önce trafik motorunda denetlenir; belirteç yoksa, imzası geçersizse ya da süresi dolmuşsa istek HTTP 401 ile reddedilir.
3. Oturumlu istek: Bu vService'in ya da Trusted Portals listesindeki bir portalın verdiği geçerli oturumla gelen istekler vService'in aksiyonlarıyla Kurum Servisine iletilir; hiçbir aksiyon eşleşmezse vService'in varsayılan Kurum Servisine gider.
4. AGS Root Path: Bu yol altındaki istekler yönlendirilmez, doğrudan AGS motoruna iletilir.

Listede olmayan bir vService'in verdiği, aynı adı taşıyan geçerli bir oturum çereziyle gelen isteklere Session cookie issuer not trusted by this gateway. metniyle HTTP 403 döner. Oturumsuz isteklerin portala yönlendirilmesi AGS Activation Condition koşuluna bağlı değildir; koşula uymayan oturumsuz istekler de güvenilen portala yönlendirilir. Listede Portal URL değeri tanımlı hiçbir portal yoksa yönlendirme kuralı oluşturulmaz.

vService'in AGS çerezleri ile Trusted Portals listesindeki portalların AGS çerezleri Kurum Servisine giden istekten ayıklanır.

Oturum ve Politikalar

Portal oturum çereziyle gelen istekte oturum bilgileri portalın oturum deposundaki kaydından okunur. Kullanıcı öznitelikleri ve form girdileri (%AGS_USER_ATTR(<ad>), %AGS_USER_INPUT(<alan>) vb.) portalın oturum kaydından gelir. Güvenilen portalların giriş formlarındaki alanlar da bu vService'te tanınır; Password türündeki alanlar yalnızca gizli değere izin verilen yerlerde çözülür, diğer yerlerde [secret] olarak yazılır.

Ayar	Uygulanan değer
Session Protection Policy	Bu vService'in politikası. Uygulamaya doğrudan gelen isteklerde oturumun boşta kalma süresi bu politikanın süresine göre, en fazla dakikada bir yenilenir; politika seçilmemişse ya da politikada boşta kalma süresi tanımlı değilse süre 1 saattir. Portal üzerinden tünellenen isteklerde süre önce portalda yenilendiği için portalın süresi geçerli olur.
Session Binding Type	Bu vService'in politikasındaki bağlama türüne göre hesaplanan değer, portal oturumunun kaydındaki bağlama değeriyle karşılaştırılır; bağlama türü ve bileşenleri portalınkiyle aynı seçilir. IP Address ve IP + User Agent türlerinde değer eşleşmediğinde portal oturumu bu vService'te geçersiz sayılır ve ziyaretçi yeniden güvenilen portalın aktarım adresine yönlendirilir. Whitelist Conditions ile eşleşen istekler karşılaştırmaya girmez.
Bot Protection Policies	Bu vService'in politikaları; yalnızca AGS motoruna yönlenen isteklerde (ör. AGS Root Path altındaki istekler) değerlendirilir.
Default Lockout Policies	Giriş denemeleri portalın akışında yapılır ve portalın kilitleme politikalarıyla değerlendirilir; bu vService'te seçilen politikalar yalnızca bu vService'in kendi Authentication Provider adımlarına bağlıdır.
Backend SSO Config	Bu vService'in profili; enjeksiyonlar portal oturumuyla gelen isteklere de uygulanır. Profilin çıkış koşulu tetiklendiğinde istekteki oturum kaydı silinir; portal oturumuyla gelen istekte bu kayıt portalın oturumudur ve kullanıcı portaldan ve aynı oturumu kullanan diğer uygulamalardan da çıkmış olur. Tarayıcıdaki çerez bu vService'in Cookie Domain değeri ve çerez adıyla silinir.

Portal Erişim Moduna Göre Akış

Portalın Portal Applications listesinde bu vService için seçilen Access Mode, ziyaretçinin oturumu nerede alacağını belirler:

Portal tarafındaki erişim modu	Akış
Domain Tunnel, uygulama alan adı portalın Cookie Domain değeri altında	Oturumu olmayan ziyaretçi portal vService'te karşılanır ve portal adresine yönlendirilir. Oturumlu istek portaldan bu vService'e tünellenir; portal oturumu bu vService'te doğrudan kabul edilir. Önekler aynı olmalıdır.
Domain Tunnel, uygulama alan adı portalın Cookie Domain değeri dışında	Oturumu olmayan ziyaretçi portalın aktarım adresine yönlendirilir; oturum portalın aktarım adresi ve bu vService'in /handoff-accept adresi üzerinden aktarılır.
TR7 Application	Portal tarafında kural yoktur. Ziyaretçi uygulamanın kendi adresine gelir; oturumu yoksa bu vService tarafından güvenilen portalın aktarım adresine yönlendirilir. Portal ile uygulama aynı Cookie Domain altındaysa ve önekler aynıysa portal oturumu doğrudan kabul edilir.
Private Domain Tunnel	Oturumu olmayan ziyaretçi portal vService'te karşılanır ve portala yönlendirilir. Oturumlu istek özel adresten bu vService'e tünellenir; portal oturum çerezinin özel adrese ulaşması ve öneklerin aynı olması gerekir.

Domain Tunnel erişim modunda aktarımın gerekip gerekmediği bu vService'in değil, portalın Cookie Domain değerine (boşsa Portal URL adresine) göre belirlenir. TR7 Application akışında bu vService oturumu olmayan her isteği ayrım yapmadan aktarım adresine yönlendirir.

Portal Application Moduna Erişim

1. Left Monitor Panel açılır.
2. Sol üstteki kategori sekmelerinden AGS-Enabled vServices seçilir.
3. TR7 üzerinde tanımlı, AGS erişim denetimi etkin vService'ler listelenir.
4. İzlenecek vService'e tıklanır; ekran, vService'in adını taşıyan Dashboard sekmesiyle açılır.
5. Açılan ekranda Flowchart sekmesine tıklanır.
6. Sol üstteki anahtar Edit Mode konumuna alınır.
7. Araç çubuğundaki General Settings butonuna tıklanır; açılan pencerenin Gateway Mode bölümünde Gateway Mode alanında Portal Application seçilir.

Aynı alanlar AGS Management sekmesinde de düzenlenir: Gateway Mode ve Trusted Portals mod bölümünün Edit / Scope & identity penceresinde; Trusted Portals ayrıca Trusted Portals bölümünün Edit / Trusted portals penceresinde; Cookie Domain ve Cookie Name Prefix Session bölümünün Edit / Session penceresinde bulunur. Bu pencerelerde değişiklik Accept ile doğrudan kaydedilir. Portal Application moduna geçiş Flowchart sekmesindeki General Settings penceresinden yapılır.

Gateway Mode Bölümü

Portal Application seçiliyken General Settings penceresinin Gateway Mode bölümünde dört alan görüntülenir. Mod seçildiği anda Trusted Portals alanı boş olarak belirir.

Gateway Mode Bölümü

INFO

Gateway Mode Zorunlu Varsayılan: Standalone Application

AGS'nin çalışma modu seçilir. Seçenekler sırasıyla Standalone Application, Portal ve Portal Application'dır. Mod değiştirildiğinde moda özgü alanlar pencerede anında belirir ya da kaybolur (Mod Değişikliği).

INFO

Cookie Domain

Oturum çerezinin geçerli olacağı alan adı girilir (yer tutucu company.com); biçim ve boş bırakıldığındaki davranış Standalone Application modundaki alanla aynıdır. Bu modda değer Backend SSO çıkışında tarayıcıdaki oturum çerezinin silinmesinde kullanılır; portal oturumunun aktarılıp aktarılmayacağı ise portalın Cookie Domain değerine göre belirlenir.

INFO

Cookie Name Prefix Varsayılan: Automatic

AGS çerezlerinin adlarına eklenecek önek belirlenir; Automatic ve Choose konumları Standalone Application modundaki alanla aynıdır.

Anahtar Automatic konumundayken önek, Trusted Portals listesinde sırayla bakılarak önek tanımlanmış ilk portaldan alınır; hiçbir portalda önek tanımlı değilse AGS_ kullanılır. Bu vService oturum çerezini yalnızca bu önekle okur. Choose ile portalınkinden farklı bir önek girildiğinde, portalla ortak Cookie Domain altında ya da tünel üzerinden gelen portal oturumu bu vService'te tanınmaz.

INFO

Trusted Portals Zorunlu

Oturumu kabul edilecek portallar seçilir. Alan boşken Nothing chosen yazar.

• Açılan listede yalnızca Gateway Mode değeri Portal olan vService'ler adlarıyla görüntülenir; listenin üstündeki arama kutusuyla (Enter query) süzülür. AGS erişim denetimi kapatılmış Portal vService'ler de listede görüntülenir. Kayıt yoksa No options, aramada eşleşme yoksa No results yazar. Listeden yeni bir portal oluşturulmaz.
• Listede bir vService'e tıklanarak seçilir, seçili öğeye yeniden tıklanarak seçim kaldırılır; yeni seçim sona eklenir. Seçim sayısı için üst sınır bulunmaz.
• Seçilen portallar alanın içinde etiket olarak görüntülenir. Etiketteki ikonu portalı listeden çıkarır; etiketler sürüklenerek yeniden sıralanır.
• Liste öğelerinde ve etiketlerde ikonu portalın akış şemasını salt okunur gösterir; ikonu portalın akış şemasını ayrı bir düzenleme penceresinde açar.
• Portal modundan çıkarılmış ya da silinmiş bir vService listede kalmışsa etiketi uyarı renginde görüntülenir; bu etikette yalnızca ikonu bulunur.

Seçim sırası kullanılır: oturumu olmayan ziyaretçi Portal URL değeri tanımlı ilk portala yönlendirilir, Cookie Name Prefix Automatic konumundayken önek tanımlı ilk portalın öneki kullanılır; oturumlar ise listedeki bütün portallardan kabul edilir. Önekleri farklı portalların aynı uygulamada birlikte seçilmesi durumunda yalnızca kullanılan önekle çalışan portalın oturumu tanınır.

Alan boş bırakıldığında pencerede uyarı gösterilmez ve Accept butonu pasif olmaz; eksiklik Save sırasında At least 1 options must be selected, got 0 ile başlayan hata metniyle bildirilir.

INFO

Pencerede yapılan değişiklikler Accept ile şemaya aktarılır ve araç çubuğundaki Save ile kaydedilir (General Settings Penceresi).

Flowchart'ta Portal Application

• Start kutusu görüntülenmez; mod rozeti PORTAL APPLICATION tuvalin sol üst köşesinde yer alır.
• Önceki modda tanımlanan akış adımları şemada ve kayıtta kalır; Add AGS Action ile yeni adım da eklenir. Bu adımlara Start'tan ulaşılmaz ve ziyaretçi bu vService'in akışına yönlendirilmez.
• User Attributes paneli şemadaki adımlara göre hesaplanmaya devam eder.
• Backend SSO Config profilinin Backend Session Lost Strategy değeri Re-sync ise Backend SSO (Re)Sync kutusu bu modda da görüntülenir.
• General Settings penceresi araç çubuğundaki General Settings butonuyla açılır.

Modun Görüntülendiği Yerler

Yer	Görüntülenen
Flowchart	Tuvalin sol üst köşesinde PORTAL APPLICATION rozeti.
AGS-Enabled vService List	Gateway Mode kolonunda Portal Application.
Dashboard ve AGS Management önizleme çizimi	AGS şeridinin etiketi altında Portal Application. Trusted Portals kutusunda her güvenilen portal bir satırdır; satırın bilgi penceresinde Sessions of this portal are trusted yazar.
AGS Management mod bölümü	Başlık Portal Application, alt yazı This application serves no login pages of its own; it inherits its session from a trusted portal.
AGS Management Session bölümü	Cookie Name Prefix Automatic konumundayken The cookie name prefix is inherited from the trusted portal; önek girildiyse Cookie name prefix <önek>.
AGS Management Trusted Portals bölümü	Yalnızca bu modda görüntülenir. Kaydı bulunan her portal <portal> · Sessions of this portal are trusted satırıyla listelenir ve en az bir portal varsa başlığa portal sayısı eklenir. Kaydı bulunan portal yoksa No provider profile selected görüntülenir. Bölümün Edit bağlantısı Edit / Trusted portals penceresini açar.

Mod Değişikliği

Gateway Mode değiştirildiğinde Cookie Domain, Cookie Name Prefix, politikalar ve Backend SSO Config korunur. Değişiklik için onay sorulmaz. Flowchart'ta kaydetmeden önce geri dönmek için View Mode'a geçilerek kaydedilmemiş değişiklikler atılır; AGS Management Edit / Scope & identity penceresinde değişiklik Accept ile doğrudan kaydedilir.

Geçiş	Sonuç
Standalone Application → Portal Application	Trusted Portals alanı boş olarak belirir. Accept ile Start kutusu şemadan kalkar ve rozet sol üste geçer; Save ile Start bağlantısı kayıttan silinir. Akışın adımları silinmez.
Portal → Portal Application	Yukarıdakine ek olarak Portal URL, Private Tunnel Domain ve Portal Applications değerleri Accept ile şemadan çıkarılır, Save ile kayıttan silinir. Bu vService'i Trusted Portals listesinde tutan diğer uygulamalar kendiliğinden güncellenmez.
Portal Application → Standalone Application	Trusted Portals değeri kaldırılır. Kayıt Portal Application modunda kaydedilmişse Start kutusu bağlantısız gelir; kaydetmeden önce akışın ilk adımına bağlanmalıdır, bağlantısız kayıt engellenmez.
Portal Application → Portal	Trusted Portals değeri kaldırılır; Portal URL, Private Tunnel Domain ve boş bir kartla Portal Applications alanları belirir ve zorunlu alanlar doldurulana kadar Accept pasif kalır. Kayıt Portal Application modunda kaydedilmişse Start kutusu bağlantısız gelir ve akışın ilk adımına bağlanır.

Pencere açıkken mod değiştirilip yeniden Portal Application seçilirse girilen değerler kaybolmaz; değerler yalnızca Accept anında geçerli moda göre ayıklanır.

Portal ve Authentication Providers ile İlişkisi

• Bu moddaki vService, bir Portal vService'in Portal Applications listesinde Application vService olarak seçilir ve Trusted Portals listesinde o portal seçilir. Portal tarafında uygulamanın bu moda alınıp alınmadığı denetlenmez; iki taraf ayrı ayrı yapılandırılır.
• Bir portal silindiğinde ya da Portal modundan çıkarıldığında Trusted Portals listesi kendiliğinden güncellenmez; liste elle düzenlenir.
• Authentication Providers ekranındaki Portal tipi sağlayıcı ise bir gateway modu değil, akışa eklenen bir adımdır ve Portal Gateway alanında Portal modundaki bir vService seçilir. Kendi giriş sayfası olmadan portal oturumunu devralan uygulamalarda bu mod kullanılır.

Kapsam ve Sınırlar

INFO

• Giriş portalda yapılır. Bu vService kendi giriş sayfalarını sunmaz; Start kutusu bulunmaz ve şemadaki adımlara ziyaretçi yönlendirilmez.
• Varsayılan hedef Kurum Servisidir. Oturumlu ve aksiyonla eşleşmeyen istekler vService'in varsayılan Kurum Servisine gider.
• Yönlendirme koşuldan bağımsızdır. Oturumsuz istekler AGS Activation Condition koşuluna uymasalar da güvenilen portala yönlendirilir.
• Liste sırası önemlidir. Yönlendirilen portal ve devralınan önek Trusted Portals sırasına göre belirlenir; oturumlar bütün listeden kabul edilir.
• Politikalar uygulamanındır. Oturum koruma, bot koruma ve Backend SSO bu vService'in ayarlarından uygulanır; tünel erişim modlarında istek önce portalın oturum koruma ve Backend SSO ayarlarından da geçer. Oturum bağlama türü portalınkiyle aynı seçilir.
• Zorunluluk kayıt sırasında denetlenir. Boş Trusted Portals listesi pencerede engellenmez, Save sırasında bildirilir.