ags backend-sso-configs

ags backend-sso-configs komutu, AGS'de doğrulanmış kullanıcının kimliğinin arka uçtaki servise nasıl aktarılacağını ve o servisin oturum durumunun nasıl izleneceğini belirleyen profilleri yönetir. Panel karşılığı Backend SSO Configurations ekranıdır.

Profil iki işi bir arada yapar: doğrulanmış isteklere kimlik bilgisi ekler (başlık, Basic Auth, Bearer token ya da çerez) ve arka uç oturumu kaybettiğinde ya da kendi çıkışını yaptığında ne olacağını tanımlar.

Komut Özeti

TR7 WEB-CLI · ags backend-sso-configs

admin@TR7LBWAF01> ags backend-sso-configs list # hepsini listele

admin@TR7LBWAF01> ags backend-sso-configs show <kimlik> # birini göster

admin@TR7LBWAF01> ags backend-sso-configs add name <ad> … # yeni profil

admin@TR7LBWAF01> ags backend-sso-configs update id <kimlik> … # değiştir

admin@TR7LBWAF01> ags backend-sso-configs delete <kimlik> # sil

admin@TR7LBWAF01>  

Yazım Sırası

Adım 1 Profili adıyla oluştur

ags backend-sso-configs add name portal-sso

Zorunlu tek alan addır; profil boş olarak oluşturulabilir ve içeriği sonradan güncellemeyle doldurulabilir.

Adım 2 Enjeksiyonları ekle

Her enjeksiyon bir liste öğesidir ve kendi indeksiyle yazılır. Önce türü, sonra o türün alanları verilir.

--injections.0.type header --injections.0.headerName X-User --injections.0.headerValue <kullanıcı-ifadesi>

Adım 3 Oturum davranışını tanımla

Arka uç oturumu kaybettiğinde ya da kendi çıkışını yaptığında ne olacağı isteğe bağlı alanlarla belirlenir; hiçbiri verilmezse profil yalnız enjeksiyon yapar.

Adım 4 Profili vService'e bağla

Profil kendi başına çalışmaz; ilgili ağ geçidine bağlanır.

ags gateway update id <vService> --backendSsoConfig <profil>

Zorunlu Alanlar

Sıra	Alan	Durum	Değer
1	name	Zorunlu	Profilin adı
—	backendLogoutRedirectHeaderName	Koşullu zorunlu	Yalnız yönlendirme biçimlerine customHeader eklendiğinde istenir

Bunların dışındaki her alan isteğe bağlıdır ve -- önekiyle yazılır. Profilin asıl içeriği olan enjeksiyonlar da isteğe bağlı alanlardır: enjeksiyonsuz bir profil geçerlidir ama arka uca kimlik aktarmaz.

Enjeksiyonlar

Her enjeksiyon --injections.N. önekiyle, kendi indeksiyle yazılır. Önce tür seçilir, sonra o türün alanları verilir.

type	Ne yapar	O türün alanları
header	İsteğe bir HTTP başlığı ekler	--injections.N.headerName · --injections.N.headerValue
basicAuth	Basic Auth kimlik bilgisi ekler	--injections.N.username · --injections.N.password
bearer	Bearer token ekler	--injections.N.token (+ isteğe bağlı --injections.N.bearerHeaderName)
cookie	Arka uca çerez gönderir	--injections.N.cookieName · --injections.N.cookieValue

• Değer alanları smart değişken kabul eder; doğrulanmış kullanıcının bilgileri buradan aktarılır. Kullanılabilecek değişkenler akışa göre değişir ve Tab ile listelenir. Parantez içeren bir değişken yazıldığında değer çift tırnak içine alınır.

Alan	Ne yapar	Arkasına ne yazılır
--injections.N.type	Enjeksiyonun türünü seçer; o türün alanları buna göre açılır	header · basicAuth · bearer · cookie
--injections.N.cond	Enjeksiyonun yalnız belirli isteklere uygulanmasını sağlar	Koşul ifadesi. Boş bırakıldığında doğrulanmış her isteğe uygulanır

• --injections.N.bearerHeaderName verilmezse başlık Authorization olur.
• --injections.N.cond ile enjeksiyon yalnız belirli isteklere uygulanır; koşul verilmezse doğrulanmış her isteğe uygulanır.

Oturum Kaybı ve Çıkış Davranışı

Alan	Varsayılan	İşlevi
--backendSessionLostCond	Tanımsız	Arka ucun oturumu kaybettiğini gösteren koşul
--backendSessionLostStrategy	logout	Oturum kaybında ne yapılacağı: logout kullanıcıyı çıkarır, resync akıştaki yeniden eşitleme adımını çalıştırır
--backendSessionLostMaxAutoRetries	2	Yalnız resync seçiliyken; sessiz deneme sayısı, 0 her seferinde kullanıcı etkileşimi ister
--backendLogoutCond	Tanımsız	Arka ucun kendi çıkışını tamamladığını gösteren koşul; eşleşmede AGS oturumu da sonlanır
--backendLogoutRedirectTo	/	Çıkıştan sonra yönlendirilecek adres
--backendLogoutRedirectModes.0	httpRedirect	Yönlendirme biçimi: httpRedirect ve/veya customHeader
backendLogoutRedirectHeaderName	—	customHeader seçildiğinde zorunlu; adresin döneceği başlığın adı

Koşul alanları

--backendSessionLostCond, --backendLogoutCond ve --injections.N.cond alanları koşul ifadesi bekler. İfade komut satırında da yazılabilir; bulunulan noktada kullanılabilecek terimler Tab ile tamamlanır. Koşulların görsel olarak kurulması panelde daha pratiktir.

Örnekler

TR7 WEB-CLI · A) Başlıkla kimlik aktarma

admin@TR7LBWAF01> ags backend-sso-configs add name portal-sso \

--injections.0.type header --injections.0.headerName X-Auth-User \

--injections.0.headerValue <kullanıcı-ifadesi>

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) İki enjeksiyon: başlık ve Basic Auth

admin@TR7LBWAF01> ags backend-sso-configs add name eski-uygulama-sso \

--injections.0.type header --injections.0.headerName X-Remote-User --injections.0.headerValue <kullanıcı-ifadesi> \

--injections.1.type basicAuth --injections.1.username <kullanıcı-ifadesi> --injections.1.password <parola>

admin@TR7LBWAF01>  

TR7 WEB-CLI · C) Çıkış sonrası özel başlıkla yönlendirme

admin@TR7LBWAF01> ags backend-sso-configs update id <kimlik> \

--backendLogoutRedirectModes.0 httpRedirect --backendLogoutRedirectModes.1 customHeader \

--backendLogoutRedirectHeaderName X-Auth-Redirect --backendLogoutRedirectTo /giris

admin@TR7LBWAF01>  

TR7 WEB-CLI · D) Profili vService'e bağlama

admin@TR7LBWAF01> ags backend-sso-configs list # profilin kimliğini bul

admin@TR7LBWAF01> ags gateway update id <vService> --backendSsoConfig <profil>

admin@TR7LBWAF01>  

Güncelleme ve Silme

Güncelleme kimliği id alanıyla ister ve yalnız yazılan alanları değiştirir. Enjeksiyon listesi indeksle güncellenir; --injections.delete listenin tamamını boşaltır.

TR7 WEB-CLI · güncelleme ve silme

admin@TR7LBWAF01> ags backend-sso-configs update id <kimlik> --injections.0.headerName X-User

admin@TR7LBWAF01> ags backend-sso-configs update id <kimlik> --injections.delete # tüm enjeksiyonları kaldır

admin@TR7LBWAF01> ags backend-sso-configs delete <kimlik>

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Profil tek başına çalışmaz. Bir ağ geçidine bağlanana kadar hiçbir etkisi olmaz; bağlama ags gateway update ile yapılır ve her vService tek bir profil kullanır.
• Parantezli değerler tırnak ister. Komut satırı ( ve ) işaretlerini ayırıcı sayar; parantez içeren bir smart değişken yazıldığında değerin tamamı çift tırnak içine alınır.
• Sırlar komut satırına yazılır. Basic Auth parolası ve Bearer token gizli sorulmaz; satırda görünür ve komut geçmişine düşer.
• Yeniden eşitleme adımı burada tanımlanmaz. resync stratejisi seçildiğinde çalıştırılacak adım, vService'in akış düzenleyicisinde belirlenir.