ags

ags komut dalı, TR7'nin AGS - AAM (Application Access Management) kaynaklarını komut satırından yönetir: erişim ağ geçitleri, kimlik doğrulama sunucu ve sağlayıcıları, yerel kullanıcı veritabanları, giriş formları, MFA yapılandırmaları, güvenlik politikaları ve entegrasyonlar. Panel karşılığı AGS - AAM bölümüdür; buradaki her komut, o bölümdeki bir ekranın yaptığı işi yapar.

12 Kaynak

ags altındaki komutlar

İkisi (profiles, security) yalnızca gruplayıcıdır; kayıt yönetimi alt komutlarındadır.

5 Komut

list · show · add · update · delete

Her kaynakta aynı beş komut; öğrenilen kalıp tüm dal boyunca tekrar eder.

Tür seçince daralır

type · method · gatewayMode

Tür alanı seçildiği anda yalnız o türün alanları istenir; gerisi gizlenir.

Load Balancer yetkisi

ags dalının yetki alanı

Okumak için görüntüleme, yazmak için değiştirme yetkisi gerekir.

Komut Haritası

Komut	Ne yönetir	Panel ekranı
ags gateway	Erişim ağ geçidi: akışın (form → kimlik → MFA → karar) tanımı	AGS Management
ags authentication-server	Dizin ya da servis bağlantısı (LDAP, RADIUS, HTTP…)	Authentication Servers
ags authentication-provider	Kimlik doğrulama yöntemi (9 sağlayıcı türü)	Authentication Providers
ags local-database	Yerel kullanıcı veritabanı ve parola politikası	Local Databases
ags local-user	Yerel veritabanındaki kullanıcı hesapları	Users sekmesi
ags forms	Giriş formları ve form alanları	Login Forms
ags mfas	MFA yapılandırmaları (TOTP, e-posta/SMS OTP, HTTP OTP)	Multi-Factor Authentication
ags backend-sso-configs	Kimliğin arka uç servise aktarılması	Backend SSO Configurations
ags notifications	Bildirim profilleri (eşik ve alarm ayarları)	Notification Profiles
ags log-forwarders	Erişim kayıtlarının dışarı aktarılması	Log Forwarding
ags profiles → page-templates · dictionaries	Sayfa şablonları ve çoklu dil sözlükleri	Page Templates · Dictionaries
ags security → lockout-policies · session-protection-policies · rate-limit-policies · captcha-providers	Kilitleme, oturum koruma, bot koruma ve CAPTCHA politikaları	Protection Policies

Bir komut adı ekran adıyla örtüşmüyor

ags security rate-limit-policies, panelde Bot Protection Policies adıyla geçen kayıtları yönetir. Komut adı ile ekran adı farklıdır; oran sınırlama bu politikaların bir parçasıdır.

Her Kaynakta Aynı Beş Komut

Bir kaynağın komutları öğrenildiğinde diğerleri de bilinir. Kalıp her kaynakta aynıdır:

TR7 WEB-CLI · beş komut kalıbı

admin@TR7LBWAF01> ags authentication-server list # hepsini listele

admin@TR7LBWAF01> ags authentication-server show <kimlik> # birini göster

admin@TR7LBWAF01> ags authentication-server add <alanlar> # yeni kayıt

admin@TR7LBWAF01> ags authentication-server update id <kimlik> <alanlar> # değiştir

admin@TR7LBWAF01> ags authentication-server delete <kimlik> # sil

admin@TR7LBWAF01>  

Kimliğin yazılışı komuta göre değişir; ikisi de Tab ile kayıt adlarından seçilir:

Komut	Kimlik nasıl yazılır
show · delete	Komuttan hemen sonra, alan adı yazmadan: show <kimlik>
update	id alanıyla: update id <kimlik>; kimlik verilmeden diğer alanlar listelenmez

Alan Yazım Kuralları

Bu kurallar ags dalının tamamında geçerlidir:

Kural	Yazımı
Zorunlu alan	Öneksiz yazılır ve sırayla istenir: add name kurumsal-ldap protocol ldap
İsteğe bağlı alan	-- öneki alır: --connectionTimeout 30
Liste alanı	Her öğe kendi indeksiyle: --hosts.0.host 10.0.0.30 --hosts.1.host 10.0.0.31
İç içe alan	Nokta ile: --addr.ip, --title.text
Parola alanı	Komut satırına yazılmaz; ayrı satırda, ekranda görünmeden sorulur
Tür alanı	type, method, gatewayMode gibi alanlar seçildikten sonra yalnız o türün alanları istenir
Alanı boşaltma	Yalnız update sırasında: --alan.delete

Sıradaki alanı görmek

Zorunlu alanlar tek tek istenir: biri yazılmadan sonraki listelenmez. Bulunulan noktada ne yazılabileceğini görmek için Tab, açıklamalı liste için satır sonuna ? yazılıp Enter kullanılır. Bir komutun ne yaptığını çalıştırmadan okumak için --info eklenir.

Bir Erişim Akışını Sıfırdan Kurma

Ağ geçidi, akışın parçalarına kimlikleriyle atıfta bulunur; bu yüzden önce parçalar oluşturulur, ağ geçidi en sonda düzenlenir.

Adım 1 Kimlik kaynağını tanımla

Dizin bağlantısı açılır, sonra bu bağlantıyı kullanan sağlayıcı oluşturulur. Sağlayıcı komutunda ilk yazılan alan türdür; tür seçilene kadar kaydın adı bile istenmez. Tür yazıldığında yalnız o türün alanları açılır.

ags authentication-server add name kurumsal-ldap protocol ldap --hosts.0.host 10.0.0.30 --hosts.0.port 389
ags authentication-provider add type ldap name kurumsal-giris authServerId <sunucu-kimliği> …

Harici dizin yoksa bu adımın yerine ags local-database ile bir veritabanı, ardından ags local-user ile hesaplar açılır.

Adım 2 Giriş formunu oluştur

Form yalnız adla oluşturulur; alanlar (kullanıcı adı, parola, gönder butonu) sonradan indeksli alanlarla eklenir.

ags forms add name giris-formu

Adım 3 Gerekiyorsa ikinci faktörü ekle

Yöntem seçildiğinde o yöntemin zorunlu alanları istenir: TOTP için görüntülenecek kurum adı, OTP için kanal, HTTP OTP için adres ve yöntem.

ags mfas add name totp-dogrulama method totp totpIssuerName Kurum

Adım 4 Güvenlik politikalarını hazırla

Kilitleme, oturum koruma, bot koruma ve CAPTCHA politikaları ayrı kayıtlardır ve ağ geçidine kimlikleriyle bağlanır.

ags security lockout-policies list

Adım 5 Ağ geçidinde birleştir

Ağ geçidi kaydı, AGS açık her vService için kendiliğinden oluşur ve vService adıyla anılır. Bu yüzden akış kurarken yeni kayıt eklemek yerine var olan kayıt düzenlenir: önce liste alınır, sonra akış adımları (aksiyonlar) indeksli alanlarla yazılır.

ags gateway list
ags gateway update id <vService-kimliği> --actions.0.actionType agsForms --actions.0.actionProfileId <form-kimliği>

vService'te AGS açık değilse

Ağ geçidi kaydı yalnızca AGS'si açık vService'ler için listelenir. Bir vService'i AGS kapsamına almak panelden yapılır; bkz. AGS-Enabled vService List.

Yetki

ags komutları Load Balancer yetki alanına bağlıdır: dalı görmek ve okumak için bu alanda görüntüleme, kayıt eklemek, değiştirmek ya da silmek için değiştirme yetkisi gerekir. superAdmin rolü tüm komutları çalıştırır, readOnly rolü yalnız list ve show komutlarını kullanır. Yetkisiz bir komut çalıştırılmaz ve Permission denied. uyarısı döner (arayüz dili Türkçe olan kullanıcıda Yetkiniz bulunmamaktadır.). Ayrıntılar için API Commands sayfasına bakılabilir.