Smarter by Design.Simpler for Business
Web CLI
WEB-CLI Nedir?
WEB-CLI, TR7 panelinin sağ alt köşesindeki WEB-CLI butonuyla açılan, tarayıcı içi bir uçbirimdir. Cihaza ayrıca SSH ile bağlanmadan, panelden çıkmadan komut satırı erişimi verir; arka planda TR7'nin kendi komut satırı motoru çalışır ve Cisco tarzı, hiyerarşik, otomatik tamamlamalı bir komut ağacı sunar. Aynı motora cihaza SSH ile bağlanarak da ulaşılır; iki yol aynı komutları çalıştırır.
Her oturum, kullanıcının kendi bağlamında çalışan durum bilgili bir uçbirimdir: komut geçmişi kullanıcıya özel saklanır, sistem komutları için seçilen vDevice ve route tablosu bağlamı korunur ve her komut çalıştırılmadan önce kullanıcının yetkisi denetlenir.
Komut istemi kullanıcı@cihaz-adı> biçimindedir: kullanıcı adı yeşil, cihazın host adı mavi renkte gösterilir.
3 Komut Dalı
API · Sistem · Pipe
Kaynak yönetimi, sistem araçları ve çıktı işleme için üç ayrı komut ailesi.
18 Ağ & Tanı Aracı
ping · dig · tcpdump…
Küratörlü ağ ve tanılama araçları; seçili vDevice ve route tablosu bağlamında çalışır.
14 Pipe Süzgeci
grep · jq · to-file…
Komut çıktısını süzer, dönüştürür ve geçici bir dosyaya yazar; tek satırda en çok 8 süzgeç.
Rol Bazlı Erişim
superAdmin · readOnly · alan rolleri
Komutlar kullanıcının alan yetkilerine göre açılır; sistem komutları yalnız superAdmin.
Üç Komut Dalı
WEB-CLI üç tür komut sunar. Aranan işe göre ilgili dala geçilir:
API Komutları
Kaynakları (lb, waf, ags, gtm, network, settings…) komut satırından yönetir; panelin yaptığı işlerin CLI karşılığı.
→
Sistem Komutları
sys-cmd ile küratörlü ağ/tanı araçları: ping, dig, tcpdump, curl, ss, ip, memory, file… seçili route tablosu bağlamında. →
Pipe Komutları
Çıktıyı süzer/dönüştürür (
| grep, | jq, | to-file…) ve geçici dosyaya yazar. →
Uçbirim Penceresi
Sağ alt köşedeki WEB-CLI butonu (uçbirim simgeli) tıklandığında panelin üzerinde TR7 WEB-CLI başlıklı bir pencere açılır; butona yeniden tıklandığında pencere gizlenir, oturum kapanmaz.
- Başlık çubuğu. Sol tarafta pencere adı, ortada dişli simgeli vDevice / Route table göstergesi bulunur. Gösterge, sistem komutlarının çalışacağı bağlamı yazar; tıklandığında vDevice ve Route table alanlı küçük bir pencere açılır ve seçim yapılır (ipucu: The route table for the sys-cmd commands); seçim kullanıcı bazında saklanır ve yalnızca bağlı oturumda değiştirilebilir.
- Araç çubuğu. Yazı boyutunu küçültme ve büyütme (8–48 punto arasında 11 kademe, varsayılan 12), pencereyi küçültme, büyütme/geri alma ve kapatma düğmeleri. Büyütülmüş pencere sol panel dışındaki tüm alanı kaplar.
- Uçbirim alanı. Bağlantı kurulduğunda komut istemi gelir. Bağlantı kesildiğinde ya da kurulamadığında uçbirimde durum mesajı ve Connect butonu gösterilir; buton bağlantıyı yeniden kurar. Pencere yeniden boyutlandırıldığında uçbirim sütun/satır sayısı kendiliğinden uyarlanır.
Erişim ve Yetkiler
WEB-CLI erişimi iki ayrı katmanla belirlenir: CLI'a hangi yoldan bağlanılabileceği (kullanıcı bazlı kanal anahtarları) ve bağlandıktan sonra hangi komutların çalıştırılabileceği (rol).
Kanal: CLI erişim anahtarları
Her cihaz kullanıcısının CLI'a nasıl ulaşacağı, Device Users ekranındaki iki bağımsız anahtarla belirlenir. Bu anahtarlar aynı CLI motoruna iki farklı erişim yolu açar ve birbirinden ayrı yönetilir:
| Anahtar (Device Users) | İşlevi | Varsayılan |
|---|---|---|
| Access CLI over WEB | Tarayıcı içi WEB-CLI uçbirimine erişim — bu sayfadaki özellik | Açık (LDAP/RADIUS gibi harici kaynaktan kendiliğinden oluşturulan kullanıcılar dâhil) |
| Access CLI over SSH | Aynı CLI'a cihaza SSH ile bağlanarak erişim | Yalnız superAdmin kullanıcılar için açık |
WEB-CLI butonu görünmüyorsa
Panelin sağ alt köşesindeki WEB-CLI butonu, yalnızca kullanıcının Access CLI over WEB anahtarı açıksa görünür; kapalıysa buton hiç gösterilmez. WEB-CLI için SSH erişimine gerek yoktur; tek başına Access CLI over WEB yeterlidir.
Yetki: rol kapsamı
Kanal açık olsa bile, çalıştırılabilecek komutlar kullanıcının rolüne bağlı alan yetkileriyle sınırlanır. API komutlarının her üst dalı bir yetki alanına eşlenir (network → Network, waf → WAF, gtm → GTM, lb ve ags → Load Balancer, users → Users, settings ve hw-mgmt → Settings); dalı görmek o alanda görüntüleme, yazan komutları (ekleme, düzenleme, silme, komut gönderme) çalıştırmak değiştirme yetkisi ister. Sistem komutları bir kabuk erişimi sayıldığından yalnızca superAdmin rolüne açıktır.
| Rol | CLI Yetkisi | Neler Yapabilir |
|---|---|---|
| superAdmin | Tam | Tüm API komutları (okuma ve yazma), sistem komutları (sys-cmd) ve pipe komutları |
| readOnly | Salt okuma | Tüm alanlarda yalnızca okuma amaçlı API komutları; yazma komutları ve sys-cmd kapalı |
| Alan rolleri (ör. wafManager, networkUser, trafficManager, monitor) | Alanla sınırlı | Yalnızca rolün alanlarına giren dallar; "Manager" rolleri o alanda yazabilir, "User" rolleri değiştirme yetkisiyle sınırlıdır, "ReadOnly"/"monitor" rolleri yalnızca okur; sys-cmd kapalı |
Yetki denetimi çift taraflıdır
Yetki dışı bir komut denendiğinde komut çalışmaz ve Permission denied. uyarısı döner (arayüz dili Türkçe olan kullanıcıda Yetkiniz bulunmamaktadır.). Sistem komutları ek olarak sunucu tarafında her çalıştırmada yeniden yetki denetiminden geçer; çalıştıran kullanıcı, istemci IP'si ve komut User Logs ekranına yazılır.
Gezinme ve Keşif
WEB-CLI'ı keşfetmenin en hızlı yolu Tab tuşu ve satır sonuna eklenen ? işaretidir; komut ağacında ne olduğunu görmek için ezber gerekmez. Aşağıdaki kısayollar ve yardımcı komutlar her an kullanılabilir.
Oturum ve Sınırlar
WEB-CLI oturumları, kararlı ve güvenli çalışması için belirli sınırlar içinde tutulur:
2 / kullanıcı
Eşzamanlı oturum
Bir kullanıcı en fazla 2 CLI oturumu açabilir; üçüncü oturum açıldığında en uzun süredir etkin olmayan oturum
Maximum user session limit reached... mesajıyla kapatılır. 15 / cihaz
Toplam oturum
Cihaz genelinde en fazla 15 CLI oturumu açık kalır; aşıldığında en uzun süredir etkin olmayan oturum
Maximum total session limit reached... mesajıyla kapatılır. 10 dakika
Etkinliksizlik zaman aşımı
10 dakika boyunca ne tuş basılan ne de çıktı üreten oturum
Closed due to inactivity... mesajıyla sonlandırılır; akan çıktı üreten uzun komutlar süreyi doldurmaz. 8 aşama
Maksimum pipe zinciri
Tek bir komut satırında en çok 8
| süzgeci art arda zincirlenebilir; aşımda Maximum pipe exceeded hatası döner. Komut geçmişi
Oturumlar arası
Girilen komutlar kullanıcıya özel bir geçmiş dosyasında saklanır ve sonraki oturumlarda da ↑/↓ ve
history ile kullanılır. Bu sınırlar SSH ve WEB-CLI oturumları için ortaktır; aynı motorun oturum sayacına ikisi de dâhildir.
