Kapsam ve kurallar
Bir CLI makinesi yalnızca ona verdiklerinize erişebilir. Kapsam onay sırasında seçilir ve daha sonra Ayarlar › CLI makineleri bölümünden (veya kasa açıkken app.konsolity.com/cli-machines adresinden) değiştirilebilir. Kapsam iki kez uygulanır: kapsam dışındaki her çağrıyı reddeden Konsolity sunucusu tarafından ve sunucunun ne okuyabildiği ne de değiştirebildiği şifreli kuralları uygulayan makinenin kendisi tarafından. İkisi de izin verilmeyeni reddeder.
Alanlar
| Alan | İzin verdikleri |
|---|---|
hosts |
Seçilen sunucuları listelemek; tam erişimle bu sunucularda komut çalıştırmak (konsolity run). |
snippets |
Seçilen parçacıkları listelemek; tam erişim ve hosts ile bunları çalıştırmak (konsolity snippet run). |
sessions |
Hesapta çalışan CLI oturumlarını görmek ve sonlandırmak (konsolity sessions). |
mcp |
Claude ajanlarına araç olarak hizmet vermek (konsolity mcp, konsolity serve). |
Varsayılan: hosts ve snippets.
Salt okunur veya tam erişim
- Salt okunur: yalnızca listeler ve durum. Bir parçacık aracılığıyla bile hiçbir komut çalıştırılamaz. Varsayılan erişim budur ve bir pano veya izleme için doğru seçimdir.
- Tam erişim: seçilen sunucularda, aşağıdaki komut kuralları dahilinde komutlara izin verilir.
Makine kasası
Makine kasanızın anahtarını asla almaz. Onay sırasında cihazınız bu makineye özgü bir makine anahtarı üretir, bunu mühürlenmiş olarak iletir, ardından bu anahtarla şifreleyerek yalnızca kapsamın izin verdiği öğeleri kopyalar:
- seçilen sunucular, kimlikleri, SSH anahtarları ve sabitlenmiş sunucu anahtarlarıyla birlikte;
- seçilen parçacıklar;
- makinenin kuralları.
Konsolity sunucusu bu kopyaları opak veri blokları olarak saklar. Kapsam dışındaki bir sunucunun kopyası yoktur: SSH anahtarı kasanızdan asla çıkmaz. Makinenin hesap kasasına erişimi yoktur.
- Kapsama sunucu eklemek: kasanın açık olduğu bir cihaz kopyasını yazar.
- Sunucu kaldırmak: Konsolity sunucusu kopyasını hemen siler.
- Kasada sunucuyu düzenlemek (adres, anahtar): cihazlarınız makinelerin kopyalarını bir sonraki senkronizasyonda günceller. Sunucuyu silmek kopyalarını da siler.
Yalnızca sunucu anahtarı kasada zaten sabitlenmiş sunucular kullanılabilir: CLI bilinmeyen bir sunucu anahtarını asla kabul etmez (host_key_unknown). Anahtarı sabitlemek için sunucuya uygulamadan bir kez bağlanın.
Komut kuralları
Tam erişimle konsolity run (ve Claude'un run_command aracı) yalnızca sunucu kapsamdaysa ve komut, baştaki ve sondaki boşluklar olmadan bir kurala uyuyorsa izinlidir. Üç karşılaştırma yöntemi vardır:
| Tür | Kural | Örnek desen | Kabul eder | Reddeder |
|---|---|---|---|---|
exact |
komutun tamamı, birebir aynı | df -h |
df -h |
df -h / |
prefix |
komut desenle başlar | uptime |
uptime -p |
w |
glob |
* bir karakter dizisinin yerini tutar |
systemctl status * |
systemctl status nginx |
systemctl restart nginx |
* işaretinin asla izin vermedikleri
Bir glob deseninde * şunları içeremez:
;&|(zincirleme ve boru);`ve$((komut ikamesi);>ve<(yönlendirme);- satır sonu.
Dolayısıyla systemctl status * ne systemctl status nginx; rm -rf / ne de systemctl status x | sh komutunu kabul eder. Bir prefix deseni önekten sonra geleni olduğu gibi kabul eder: bunu zararsız komutlara ayırın.
Herhangi bir komut
Herhangi bir komut seçeneği, seçilen sunucularda her metne izin verir. Ekranda açık bir onay ister ve önerilmez: makine tam bir kabuk erişiminin eşdeğeri hâline gelir. Yıkıcı komutlar yine onaya tabidir (aşağıya bakın).
Tam erişimle etkinleştirmede hiçbir kural işaretli değildir ve “Herhangi bir komut” kapalıdır: kural yazmanız veya “Herhangi bir komut” seçeneğini açıkça işaretlemeniz gerekir, aksi hâlde her serbest komut reddedilir. İzin verilen parçacıklar kaydedildikleri gibi çalışır.
Azami zaman aşımı
Her komut azami zaman aşımı aşıldığında durdurulur: varsayılan olarak 60 saniye, en fazla 1 saat. --timeout ile veya Claude tarafından istenen değer her zaman bu zaman aşımıyla sınırlanır.
Yıkıcı komutlar: her zaman onaylanır
Bazı komutlar, kapsam ne olursa olsun, “Herhangi bir komut” açıkken bile, uygulamada veya konsolda açık onayınız olmadan asla çalıştırılmaz. Bir komut (veya bir parçacığın içeriği), ayrı bir sözcük olarak örneğin şunlardan birini içeriyorsa yıkıcıdır:
- silme ve temizleme:
rm -r,rm -f,rmdir,shred,truncate,dd,mkfs,fdisk,parted,wipefs; - kapatma:
shutdown,reboot,poweroff,halt,init 0,init 6,systemctl stop,disable,mask,kill,service ... stop,kill -9,killall,pkill; - hesaplar ve izinler:
userdel,deluser,passwd,chmod -R,chown -R,crontab -r; - güvenlik duvarı:
iptables -F,ufw disable,ufw reset; - veritabanları:
DROP,TRUNCATE,DELETE FROM,ALTER TABLE ... DROP,migrate:fresh,migrate:reset,migrate:rollback; - depolar ve altyapı:
git push --force,git reset --hard,git clean -f,docker rm,docker rmi,docker system prune,docker volume rm,docker compose down -v,kubectl delete,terraform destroy; - bir diske (
/dev/sd*,/dev/nvme*) veya/etc/dizinine yapılan>yönlendirmesi.
Aynı liste CLI ve Konsolity sunucusu tarafından uygulanır: onaylanmış bir onay isteği olmadan başlatılan yıkıcı bir komut her iki tarafta da reddedilir. Akış Onaylar sayfasında açıklanmıştır.
Kapsamı değiştirme
- Genişletmek (bir alan eklemek, salt okunurdan tam erişime geçmek) yeniden ikinci faktör (TOTP veya geçiş anahtarı) gerektirir.
- Daraltmak (bir alanı kaldırmak, salt okunura dönmek, bir sunucuyu kaldırmak) anında gerçekleşir ve hiçbir şey istemez: kapsam dışındaki kopyalar hemen silinir.
Komut kuralları ve zaman aşımı, kasa açıkken her zaman değiştirilebilir. Makinenin gerçekte neyi uyguladığını görmek için:
konsolity policy
Örnekler
İzleme (salt okunur, hosts + sessions): listeler ve durum, komut yok.
Günlük işletim (tam erişim, birkaç sunucu):
glob systemctl status *
exact df -h
exact free -m
prefix uptime
glob journalctl -u * --since *
glob tail -n * /var/log/nginx/error.log
exact docker ps
artı “nginx'i yeniden başlat” ve “Uygulama önbelleğini temizle” parçacıkları.
CI'dan dağıtım (uzun ömürlü belirteç, tam erişim, hosts + snippets): üretim sunucusunda tek bir “Dağıt” parçacığı, serbest komut kuralı yok.