ags authentication-server

ags authentication-server komutu, AGS'nin kimlik doğrulama için bağlanacağı dizin ya da servisin bağlantı tanımını yönetir: protokol, sunucu adresleri, yük dağıtımı, bağlantı ve TLS ayarları. Panel karşılığı Authentication Servers ekranıdır.

Bu kayıt yalnızca nereye bağlanılacağını söyler. Kimliğin nasıl doğrulanacağı ayrı bir kayıttır ve ags authentication-provider ile tanımlanır; sağlayıcı bu sunucuya authServerId alanıyla bağlanır.

Komut Özeti

TR7 WEB-CLI · ags authentication-server

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

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

admin@TR7LBWAF01> ags authentication-server add name <ad> protocol <protokol> … # yeni kayıt

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

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

admin@TR7LBWAF01>  

Yazım Sırası

Adım 1 Adı yaz

ags authentication-server add name kurumsal-ldap

Ad benzersizdir ve sağlayıcı kaydı bu sunucuyu adıyla listeler.

Adım 2 Protokolü seç

protocol ldap

Beş değer alır: ldap, ldaps, radius, http, https. Seçilen protokol, sonrasında hangi ayarların geçerli olduğunu belirler.

Adım 3 En az bir sunucu adresi ver

--hosts.0.host 10.0.0.30 --hosts.0.port 389

Adresler liste alanıdır, bu yüzden -- önekiyle ve indeksle yazılır. Tamamlama listesinde zorunlu görünmezler ama en az bir adres verilmeden kayıt oluşmaz.

Adım 4 Gerekiyorsa ayarları ekle

Bağlantı, TLS ve yük dengeleme ayarlarının tümü isteğe bağlıdır ve varsayılan değerleriyle çalışır.

RADIUS sırrı komut satırına yazılmaz

Protokol radius seçildiğinde RADIUS shared secret alanı zorunludur, ancak komut satırına yazılmaz: Enter'a basıldıktan sonra ayrı bir satırda, ekranda görünmeden sorulur. Bu yüzden komutta böyle bir alan görünmez.

Zorunlu Alanlar

Aşağıdaki alanların tamamı zorunludur: CLI bunları verilen sırayla, tek tek ister ve biri yazılmadan sonrakini göstermez.

Sıra	Alan	Durum	Değer
1	name	Zorunlu	Sunucunun benzersiz adı
2	protocol	Zorunlu	ldap · ldaps · radius · http · https
3	radiusSecret	Koşullu zorunlu	Yalnız radius protokolünde; komuttan sonra gizli olarak sorulur
—	--hosts.0.host · --hosts.0.port	En az bir adres	Tamamlama listesinde isteğe bağlı görünür, ancak adressiz kayıt kabul edilmez

Sunucu Adresleri

Bir sunucu kaydı birden çok adres taşıyabilir; her adres kendi indeksiyle yazılır ve üç alanı vardır.

Alan	Değer
--hosts.N.host	Sunucunun adresi
--hosts.N.port	Bağlantı portu
--hosts.N.weight	Ağırlık; 1 ile 10 arasında, varsayılan 1

Birden çok adres verildiğinde istekler --lbMethod alanına göre dağıtılır:

Değer	Davranış
roundrobin	Sırayla dağıtır (varsayılan)
weighted	Ağırlıklara göre dağıtır
failover	İlk adresi kullanır, erişilemezse sıradakine geçer

İsteğe Bağlı Alanlar

Alan	Varsayılan	Geçerli olduğu protokoller
--lbMethod	roundrobin	Hepsi
--disableHealthCheck	false	Hepsi
--namespace	Cihazın varsayılan route tablosu	ldap ldaps radius http https
--connectionTimeout	30 saniye (1–300)	ldap ldaps radius http https
--connectionPoolSize	5 (1–50)	ldap ldaps radius http https
--sslValidateCertificate	true	Yalnız ldaps ve https
--sslMinTlsVersion	1.2 (1.2 ya da 1.3)	Yalnız ldaps ve https

--namespace alanı, sunucuya çıkılacak route tablosunu belirler; panelde bu alan Route table adıyla görünür.

Örnekler

TR7 WEB-CLI · A) LDAP dizin sunucusu

admin@TR7LBWAF01> ags authentication-server add name kurumsal-ldap protocol ldap \

--hosts.0.host 10.0.0.30 --hosts.0.port 389

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) LDAPS, iki sunucu, ağırlıklı dağıtım

admin@TR7LBWAF01> ags authentication-server add name kurumsal-ldaps protocol ldaps \

--hosts.0.host 10.0.0.30 --hosts.0.port 636 --hosts.0.weight 3 \

--hosts.1.host 10.0.0.31 --hosts.1.port 636 --hosts.1.weight 1 \

--lbMethod weighted --sslMinTlsVersion 1.3

admin@TR7LBWAF01>  

TR7 WEB-CLI · C) RADIUS — sır ayrı satırda sorulur

admin@TR7LBWAF01> ags authentication-server add name radius-01 protocol radius \

--hosts.0.host 10.0.0.40 --hosts.0.port 1812

RADIUS shared secret: ••••••••

admin@TR7LBWAF01>  

Güncelleme ve Silme

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

TR7 WEB-CLI · güncelleme ve silme

admin@TR7LBWAF01> ags authentication-server update id <kimlik> --connectionTimeout 60

admin@TR7LBWAF01> ags authentication-server update id <kimlik> --hosts.1.host 10.0.0.32 # ikinci adresi değiştir

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

admin@TR7LBWAF01>  

Protokol radius olan bir kayıt güncellenirken sır eski kayıttan geri okunmadığı için yeniden sorulur.

Bilinmesi Gerekenler

• Bağlantı testi komut satırında yoktur. Panelin sunucu önizlemesindeki Test Connection işleminin CLI karşılığı bulunmuyor; bağlantı bu komutla sınanamaz.
• Adressiz kayıt oluşmaz. Adres alanları tamamlama listesinde isteğe bağlı görünse de sunucu en az bir adres bekler; adres verilmeden çalıştırılan komut hata döner.
• Ayarlar protokole göre görünür. TLS ayarları yalnız ldaps ve https protokollerinde, bağlantı ve route tablosu ayarları beş protokolde de listelenir.
• Silmeden önce kullanımı kontrol edilmelidir. Bu sunucuya bağlı bir sağlayıcı varsa kayıt yine de silinir; bağın kopması sağlayıcı tarafında görülür.