Smarter by Design.Simpler for Business
ags gateway
ags gateway komutu, bir vService'in önündeki erişim akışını yönetir: kullanıcının hangi adımlardan geçeceği, hangi profillerin uygulanacağı ve erişimin nasıl sonuçlanacağı. Panel karşılığı AGS açık vService'in AGS Management ekranıdır.
Ağ geçidi kaydı kendiliğinden oluşur
Her AGS açık vService için bir ağ geçidi kaydı otomatik olarak oluşturulur ve listede vService adıyla görünür. Bu yüzden bu komutta olağan işlem add değil update'tir: önce list ile kayıt bulunur, sonra üzerinde çalışılır. Bir vService'i AGS kapsamına almak panelden yapılır; bkz. AGS-Enabled vService List.
Komut Özeti
admin@TR7LBWAF01> ags gateway list # AGS açık vService'leri listele
admin@TR7LBWAF01> ags gateway show <kimlik> # birinin ayarlarını göster
admin@TR7LBWAF01> ags gateway update id <kimlik> … # olağan işlem
admin@TR7LBWAF01> ags gateway add gatewayMode <mod> … # nadiren gerekir
admin@TR7LBWAF01> ags gateway delete <kimlik> # kaydı sil
admin@TR7LBWAF01>
Yazım Sırası
Adım 1 Kaydı bul
ags gateway listListe yalnız AGS açık vService'leri gösterir; kayıtlar vService adıyla anılır.
Adım 2 Akış adımlarını yaz
Her adım bir liste öğesidir ve kendi kimliğini taşır. Adımlar birbirine bu kimliklerle bağlanır.
--actions.0.id giris --actions.0.actionType agsForms --actions.0.actionProfileId <form>Adım 3 Geçişleri bağla
Her aksiyon türünün kendi geçişleri vardır; geçiş değeri, gidilecek adımın kimliğidir.
--actions.1.transitions.success izin --actions.1.transitions.fail retAdım 4 Başlangıcı belirle
Akışın ilk adımı ayrıca yazılır.
--startAction girisZorunlu Alanlar
| Sıra | Alan | Durum | Değer |
|---|---|---|---|
| 1 | gatewayMode | Zorunlu | standaloneApp · portal · portalApp |
| 2 | portalUrl | Koşullu zorunlu | Yalnız portal modunda; portalın adresi |
Güncellemede tek zorunlu alan id'dir; mod ve diğer ayarlar yalnız değiştirilecekse yazılır.
Ağ Geçidi Modları
gatewayMode | Ne yapar |
|---|---|
standaloneApp | Tek bir uygulamanın önünde çalışır; kullanıcı doğrulandıktan sonra o uygulamaya geçer |
portal | Kullanıcıya uygulama listesi sunan portal; kimlik burada doğrulanır ve uygulamalara buradan geçilir |
portalApp | Kimliğini bir portaldan devralan uygulama; kendi giriş akışını çalıştırmaz |
--startAction alanı standaloneApp ve portal modlarında geçerlidir. --privateTunnelDomain yalnız portal, --trustedPortals.0 yalnız portalApp modunda görünür; trustedPortals oturumu kabul edilecek portalları belirler.
Akış Adımları
Akış, --actions.N. önekiyle yazılan adımlardan oluşur. Her adımda üç şey vardır: kimlik, tür ve türe göre geçişler.
| Alan | Değer |
|---|---|
--actions.N.id | Adımın kimliği; geçişler bu kimliğe işaret eder |
--actions.N.actionType | Adımın türü (aşağıdaki tablo) |
--actions.N.actionProfileId | Adımın kullanacağı profil; yalnız form, sağlayıcı ve MFA türlerinde |
actionType | Ne yapar | Profil | Geçişleri |
|---|---|---|---|
agsForms | Giriş formunu gösterir | Form kaydı | transitions.default |
agsAuthenticationProviders | Kimliği doğrular | Sağlayıcı kaydı | transitions.success · transitions.fail |
agsMFAs | İkinci faktörü uygular | MFA kaydı | transitions.success · transitions.fail |
decisionPoint | Koşula göre dallanır | — | transitions.yes · transitions.no |
switch | Bir değere göre dallanır | — | transitions.noMatch + dal hedefleri |
assignUserAttributes | Oturuma kullanıcı özniteliği yazar | — | transitions.default |
allow | Erişimi verir; akış burada biter | — | — |
deny | Erişimi reddeder; akış burada biter | — | — |
Türe özel ayarlar
actionType | Kendi ayarları |
|---|---|
decisionPoint | --actions.N.cond — dallanma koşulu |
switch | --actions.N.switchVariable · --actions.N.switchMode (exact · prefix · suffix · contains · regex) · --actions.N.caseInsensitive · --actions.N.branches.M.pattern · --actions.N.branches.M.target |
assignUserAttributes | --actions.N.userAttributes.M.name · --actions.N.userAttributes.M.content |
allow | --actions.N.redirectUrl (boşsa kullanıcının istediği sayfa) · --actions.N.redirectDelay (boşsa 3 saniye) · --actions.N.clientScript |
deny | --actions.N.customDenyMessage · --actions.N.denyTitle.… · --actions.N.denyText.… |
--actions.N.caseInsensitive yalnız regex dışındaki eşleşme biçimlerinde geçerlidir.
Geçiş alanları
Geçiş, adımın sonucuna göre akışın hangi adımla süreceğini söyler. Değer, gidilecek adımın --actions.N.id alanına yazılan kimliğidir.
| Alan | Ne yapar | Hangi adım türünde |
|---|---|---|
--actions.N.transitions.default | Tek çıkışı olan adımdan sonra gidilecek adımı belirler | agsForms · assignUserAttributes |
--actions.N.transitions.success | Doğrulama başarılıysa gidilecek adımı belirler | agsAuthenticationProviders · agsMFAs |
--actions.N.transitions.fail | Doğrulama başarısızsa gidilecek adımı belirler | agsAuthenticationProviders · agsMFAs |
--actions.N.transitions.yes | Koşul sağlanırsa gidilecek adımı belirler | decisionPoint |
--actions.N.transitions.no | Koşul sağlanmazsa gidilecek adımı belirler | decisionPoint |
--actions.N.transitions.noMatch | Hiçbir dal eşleşmezse gidilecek adımı belirler | switch |
Reddetme sayfası metinleri
deny adımında --actions.N.customDenyMessage true yazıldığında başlık ve metin alanları açılır. İkisi de form metinleriyle aynı çok dilli kalıbı kullanır: metin ya doğrudan yazılır ya da sözlükten çağrılır.
| Alan | Ne yapar | Arkasına ne yazılır |
|---|---|---|
--actions.N.denyTitle.type | Başlığın nereden geleceğini seçer | universal doğrudan yazılan metin (varsayılan) · localized sözlükten · default sistemin ürettiği metin · none metin yok |
--actions.N.denyTitle.text | Başlığı doğrudan yazar | Görünecek metin; yalnız type universal iken açılır |
--actions.N.denyTitle.key | Başlığı sözlükten çağırır | Sözlükteki anahtar; yalnız type localized iken açılır |
--actions.N.denyText.type | Açıklama metninin nereden geleceğini seçer | universal (varsayılan) · localized · default · none |
--actions.N.denyText.text | Açıklamayı doğrudan yazar | Görünecek metin; yalnız type universal iken açılır |
--actions.N.denyText.key | Açıklamayı sözlükten çağırır | Sözlükteki anahtar; yalnız type localized iken açılır |
Sözlük kayıtları ags profiles dictionaries ile yönetilir.
Bağlanan Profiller
Ağ geçidi, ayrı ayrı oluşturulan kayıtlara kimlikleriyle bağlanır:
| Alan | Varsayılan | Neyi bağlar |
|---|---|---|
--pageTemplate | default | Erişim sayfalarının şablonu |
--dictionary | default | Çoklu dil sözlüğü |
--sessionProtectionPolicy | — | Oturum koruma politikası |
--defaultLockoutPolicies.0 | Boş | Kilitleme politikaları |
--botProtectionPolicies.0 | Boş | Bot koruma politikaları |
--notificationProfile | — | Bildirim profili |
--auditLogForwarders.0 | Boş | Denetim kaydı aktarıcıları |
--backendSsoConfig | — | Arka uç SSO profili |
--backendSessionResyncAction | — | Yalnız SSO profili bağlıyken; arka uç oturumunu yeniden kuran adımın kimliği |
Portal Uygulamaları
portal ve portalApp modlarında portalda listelenecek uygulamalar --portalApps.N. önekiyle yazılır.
| Alan | Değer |
|---|---|
--portalApps.N.appName · --portalApps.N.appIcon | Uygulamanın adı ve simgesi |
--portalApps.N.accessMode | domainTunnel · tr7App · privateDomainTunnel |
--portalApps.N.appUrl | Uygulamanın adresi; domainTunnel ve tr7App biçimlerinde |
--portalApps.N.appPoolId | Uygulamanın vService'i |
--portalApps.N.privateTunnelScope | user (adres kullanıcıya sabit) ya da session (her girişte değişir); varsayılan user |
--portalApps.N.pathPrefix | Uygulamanın portalda hangi yol öneki altında sunulacağı; aynı adres altında birden çok uygulama ayrılırken yazılır |
privateDomainTunnel biçimi için portal ağ geçidinde --privateTunnelDomain alanı da yazılır: tünel adresleri bu alan adının altında üretilir.
Diğer Ayarlar
| Alan | Varsayılan | İşlevi |
|---|---|---|
--agsRootPath | /ags-portal | Erişim sayfalarının sunulduğu yol |
--agsCondition | Koşulsuz | Koşul yazıldığında AGS yalnız eşleşen isteklerde devreye girer; yazılmazsa vService'in tüm istekleri AGS'den geçer |
--cookieDomain | — | Oturum çerezinin alan adı |
--cookiePrefix | Boş | Çerez adı öneki; boş bırakıldığında AGS_ kullanılır. Aynı alan adını paylaşan iki ağ geçidini ayırmak için yazılır |
--logLevel | info | error · warn · info · debug · silly |
--startAction | — | Akışın ilk adımı; değer, o adımın --actions.N.id kimliğidir. Yazılmazsa akış başlamaz |
--privateTunnelDomain | — | Yalnız portal modunda. privateDomainTunnel uygulamalarının taban alan adı: her uygulama https://{hash}.{buAlanAdı}/ adresinden sunulur. Bu alan adı için joker DNS kaydı (*.alanadı) ve onu kapsayan sertifika gerekir; portal oturum çerezinin bu adreslere ulaşabilmesi için --cookieDomain kapsamının altında olmalıdır |
--trustedPortals.N | Boş | Yalnız portalApp modunda ve en az bir tane zorunludur: oturumuna güvenilecek portal ağ geçitleri; her biri kendi indeksiyle |
Örnekler
# form → doğrulama → izin / ret
admin@TR7LBWAF01> ags gateway update id <vService> \
--actions.0.id giris --actions.0.actionType agsForms --actions.0.actionProfileId <form> \
--actions.0.transitions.default dogrula \
--actions.1.id dogrula --actions.1.actionType agsAuthenticationProviders --actions.1.actionProfileId <saglayici> \
--actions.1.transitions.success izin --actions.1.transitions.fail ret \
--actions.2.id izin --actions.2.actionType allow \
--actions.3.id ret --actions.3.actionType deny \
--startAction giris
admin@TR7LBWAF01>
# doğrulama başarılıysa önce MFA, sonra izin
admin@TR7LBWAF01> ags gateway update id <vService> \
--actions.4.id mfa --actions.4.actionType agsMFAs --actions.4.actionProfileId <mfa> \
--actions.4.transitions.success izin --actions.4.transitions.fail ret \
--actions.1.transitions.success mfa
admin@TR7LBWAF01>
admin@TR7LBWAF01> ags gateway update id <vService> \
--defaultLockoutPolicies.0 <kilitleme> --sessionProtectionPolicy <oturum> \
--botProtectionPolicies.0 <bot> --notificationProfile <bildirim>
admin@TR7LBWAF01>
admin@TR7LBWAF01> ags gateway update id <vService> --agsRootPath /giris --logLevel debug
admin@TR7LBWAF01> ags gateway show <vService> # sonucu doğrula
admin@TR7LBWAF01>
Güncelleme ve Silme
Güncelleme yalnız yazılan alanları değiştirir; akış adımları indeksle güncellenir ve --actions.delete akışın tamamını boşaltır. Silme komutu kaydı kaldırır, ancak bu olağan bir işlem değildir: ağ geçidi vService ile birlikte yaşar ve AGS kapatıldığında da saklanır.
admin@TR7LBWAF01> ags gateway update id <vService> --actions.2.redirectUrl /panel --actions.2.redirectDelay 0
admin@TR7LBWAF01> ags gateway update id <vService> --actions.delete # akışı boşalt
admin@TR7LBWAF01>
Bilinmesi Gerekenler
- Akış kimliklerle bağlanır. Geçiş değerleri adım kimlikleridir; var olmayan bir kimliğe işaret eden geçiş akışı kırar. Adım eklerken önce kimliği belirlemek, sonra geçişleri yazmak en güvenlisidir.
- Her akışın bir sonu olmalıdır.
allowvedenyadımlarının geçişi yoktur; akış bunlarla biter. - Profil gerektiren üç tür vardır. Form, sağlayıcı ve MFA adımları
actionProfileIdile ayrı bir kayda bağlanır; bu kayıtlar önce oluşturulmalıdır. - İndeks sırası akış sırası değildir. Adımların çalışma sırasını
--startActionve geçişler belirler;--actions.Nindeksleri yalnız listedeki yerdir. - Boşluklu ve parantezli değerler tırnak ister. Koşullar, özniteliklerin içeriği ve reddetme metinleri bu kurala girer.
