settings ip-tag

settings ip-tag komutu, tekil IP adreslerine ve CIDR biçimindeki ağ bloklarına operatörün verdiği adları, yani IP etiketlerini yönetir. Her kayıt tek bir adresi ya da tek bir ağ bloğunu bir adla eşler. Panel karşılığı IP Tags ekranıdır.

Komut Özeti

TR7 WEB-CLI · settings ip-tag

# komuttan sonra Tab

admin@TR7LBWAF01> settings ip-tag

add delete list show update

 

admin@TR7LBWAF01> settings ip-tag list

admin@TR7LBWAF01> settings ip-tag add name <ad> address <adres>

admin@TR7LBWAF01> settings ip-tag update id <kimlik> …

admin@TR7LBWAF01> settings ip-tag delete <kimlik>

admin@TR7LBWAF01>  

Zorunlu Alanlar

add komutunda CLI zorunlu alanları aşağıdaki sırayla, tek tek ister ve biri yazılmadan sonrakini göstermez. Alanlar alan adı ile değeri birlikte yazılır.

Sıra	Alan	Durum	Değer
1	name	Zorunlu	Etiketin adı; en az 1, en çok 128 karakter. Aynı ad iki etikette kullanılamaz
2	address	Zorunlu	Tekil bir IPv4 ya da IPv6 adresi (85.1.2.3) veya CIDR biçiminde bir ağ (10.8.0.0/24). Aynı adres iki etikette kullanılamaz

update komutunda düzenlenecek kayıt id <kimlik> ile seçilir ve hiçbir alan zorunlu değildir; yalnız değişecek alanlar -- önekiyle yazılır. show ve delete komutlarında kimlik alan adı olmadan yazılır (settings ip-tag delete <kimlik>). Kimlikler list çıktısından alınır.

İsteğe Bağlı Alanlar

Alan	Ne yapar	Arkasına ne yazılır
--description	Etikete açıklama ekler	Metin; en çok 512 karakter (varsayılan boş). Boşluk içeren metin tırnak içine alınır
--name	update komutunda etiketin adını değiştirir	Yeni ad; en çok 128 karakter
--address	update komutunda etiketin kapsadığı adresi değiştirir	Yeni adres ya da ağ; yazım kuralı add komutundakiyle aynıdır

Adresin Saklanma Biçimi

Adres kaydedilirken standart yazıma çevrilir; list ve show çıktısında bu hâliyle görüntülenir.

Girilen	Saklanan	Kural
10.0.0.1/32	10.0.0.1	Tam uzunluklu önek (IPv4'te /32, IPv6'da /128) tekil adrese indirilir
10.8.0.5/24	10.8.0.0/24	Önekle birlikte yazılan bir host adresi ağın başlangıç adresine çevrilir
2001:DB8:0:0:0:0:0:1	2001:db8::1	IPv6 adresi küçük harfli, kısaltılmış biçime getirilir

Benzersizlik denetimi bu standart yazım üzerinden yapılır: 10.0.0.1 tanımlıyken 10.0.0.1/32 ayrı bir etikete verilemez. İç içe bloklar ise serbesttir; 172.16.0.0/16 ve onun içindeki 172.16.101.0/24 ayrı etiketler taşır.

Sınırlar ve Hata İletileri

Kural	Sınır	Aşıldığında dönen ileti
Etiket sayısı	En çok 1000	At most 1000 IP tags can be defined (<sayı> given)
Etiket adı	Benzersiz; büyük/küçük harf ayrımı yapılmaz, baştaki ve sondaki boşluklar dikkate alınmaz	Birebir aynı ad: Value must be unique, conflicts with '<kimlik>' (path: …) · Yalnız büyük/küçük harfi ya da baştaki ve sondaki boşlukları farklı ad: An IP tag named "<mevcut etiketin adı>" already exists
Adres	Benzersiz; standart yazımla karşılaştırılır	Birebir aynı yazım: Value must be unique, conflicts with '<kimlik>' (path: …) · Farklı yazılmış eşdeğer adres (10.0.0.1 tanımlıyken 10.0.0.1/32): <adres> is already tagged as "<mevcut etiketin adı>"
Ad uzunluğu	En çok 128 karakter	String must be at most 128 characters (path: …)
Açıklama uzunluğu	En çok 512 karakter	String must be at most 512 characters (path: …)

Örnekler

TR7 WEB-CLI · settings ip-tag

# tekil bir adrese etiket

admin@TR7LBWAF01> settings ip-tag add name Admins address 85.1.2.3

 

# açıklamalı bir ağ bloğu etiketi

admin@TR7LBWAF01> settings ip-tag add name "VPN Pool" address 10.8.0.0/24 \

--description "Uzaktan erişim kullanıcıları"

 

# IPv6 ağ bloğu

admin@TR7LBWAF01> settings ip-tag add name Servers address 2001:db8:10::/64

 

# var olan etiketi görüntüleme, değiştirme ve silme

admin@TR7LBWAF01> settings ip-tag list

admin@TR7LBWAF01> settings ip-tag show <kimlik>

admin@TR7LBWAF01> settings ip-tag update id <kimlik> --address 10.8.0.0/23

admin@TR7LBWAF01> settings ip-tag delete <kimlik>

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Etiketler yalnız görüntüleme içindir. Trafik işleme motoru etiketleri okumaz; bir etiket eklemek ya da silmek hiçbir isteğin engellenmesini veya kuralın eşleşmesini değiştirmez. Etiketler adresin gösterildiği ekranlarda ve IP bilgi kartında görüntülenir.
• Zorunlu alanlar -- almaz. name ve address alan adı ile değeri yan yana yazılır; --description isteğe bağlıdır. Ayrıntı API Commands sayfasındadır.
• Her etiket tek bir adres ya da tek bir ağ bloğu kapsar. Adres aralığı ya da adres listesi yazılmaz; birden çok adres için ayrı etiketler tanımlanır.
• Bir adres birden çok etikete uyabilir. İç içe bloklarda adres hem kendi etiketini hem kapsayan blokların etiketlerini taşır; sıralama en spesifikten en genişe doğrudur.
• Değişiklikler kullanıcı işlem kaydına yazılır. Kayıtlar IP tag "<ad>" (<adres>) is created, is edited ve is deleted biçimindedir.
• Cluster'da senkronize edilir. Etiket listesi cluster'daki diğer cihaza aktarılır.
• Adres itibarı ayrı bir komuttadır. İtibar veritabanının güncellenmesi ve dış kaynaklar settings ip-intelligence komutuyla yönetilir.