ایک کمانڈ۔ مکمل طور پر محفوظ۔
CASTOVIA ایجنٹ 60 سیکنڈ سے کم وقت میں install ہو جاتا ہے، سیکیورٹی خود بخود سنبھالتا ہے، اور encrypted channels کے ذریعے CASTOVIA Cloud سے communication کرتا ہے۔ نہ manual firewall rules، نہ SSH keys، نہ VPN۔
انسٹالیشن کمانڈ کی وضاحت
جب آپ اپنے Linux سرور پر ایک لائن والا installer چلاتے ہیں تو بالکل کیا ہوتا ہے۔
کمانڈ کیا کرتی ہے
CASTOVIA ایڈمن ڈیش بورڈ سے کاپی کی گئی ایک لائن والی install command آپ کے Linux سرور پر درج ذیل مراحل انجام دیتی ہے:
اصل کمانڈ
آپ کے ایڈمن ڈیش بورڈ میں نظر آنے والی کمانڈ کچھ اس طرح ہوتی ہے:
curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKENYOUR_SERVER_TOKEN ہر node کے لیے ایک منفرد، single-use token ہے۔ اگر استعمال نہ ہو تو یہ 24 گھنٹے بعد expire ہو جاتا ہے۔
ایجنٹ کیا نہیں کرتا
واضح حدود۔ ایجنٹ کو دانستہ طور پر محدود رکھا گیا ہے۔
سیکیورٹی — اندرونی طور پر موجود، بعد میں لگائی ہوئی نہیں
ہر سیکیورٹی اقدام خودکار ہے۔ دستی configuration کی ضرورت نہیں۔
سرور ٹوکن توثیق
خودکارہر node کو ایک منفرد، cryptographically random server token (256-bit) ملتا ہے۔ یہ token CASTOVIA ایڈمن میں node بنانے کے وقت generate ہوتا ہے۔ یہ صرف registration کے دوران ایک بار استعمال ہوتا ہے اور پھر rotating TLS client certificate سے بدل دیا جاتا ہے۔
TLS 1.3 انکرپشن
خودکارایجنٹ اور CASTOVIA Cloud کے درمیان تمام communication TLS 1.3 استعمال کرتا ہے۔ ایجنٹ pinned root CA کے خلاف CASTOVIA certificate chain verify کرتا ہے — system certificate store پر کوئی trust نہیں۔ Man-in-the-middle حملے ممکن نہیں۔
فائر وال تقاضے
خودکارایجنٹ کو صرف CASTOVIA Cloud تک outbound HTTPS (port 443) درکار ہوتا ہے۔ کسی inbound port کو کھولنے کی ضرورت نہیں۔ آپ کے سرور کے firewall rules جوں کے توں رہتے ہیں — ایجنٹ iptables، nftables، یا firewalld میں تبدیلی نہیں کرتا۔
چلتے وقت root رسائی درکار نہیں
خودکارایجنٹ ایک مخصوص غیر مراعات یافتہ user (castovia-agent) کے طور پر چلتا ہے۔ اسے صرف installation کے دوران root درکار ہوتا ہے (systemd service بنانے کے لیے)۔ runtime پر یہ کم سے کم permissions کے ساتھ کام کرتا ہے — stream sources تک read access، اور اپنی cache directory تک write access۔
خودکار certificate rotation
خودکارClient certificates ہر 7 دن بعد rotate ہوتے ہیں۔ ایجنٹ renewal کو شفاف طور پر سنبھالتا ہے۔ اگر کوئی certificate expire ہو جائے (مثلاً سرور offline تھا) تو ایجنٹ ایک secure re-enrollment flow استعمال کرتا ہے جس کے لیے CASTOVIA ایڈمن میں approval درکار ہوتی ہے۔
صحت کی نگرانی اور خودکار بحالی
خودکارایجنٹ اپنی صحت کی نگرانی خود کرتا ہے۔ اگر یہ crash ہو جائے تو systemd اسے 5 سیکنڈ کے اندر دوبارہ شروع کر دیتا ہے۔ اگر یہ CASTOVIA Cloud تک نہ پہنچ سکے تو یہ cached configuration کے ساتھ service جاری رکھتا ہے اور metrics کو بعد میں بھیجنے کے لیے queue میں ڈال دیتا ہے۔
مواصلاتی پروٹوکول
آپ کے سرور اور CASTOVIA Cloud کے درمیان ڈیٹا کیسے بہتا ہے۔
CASTOVIA Cloud → ایجنٹ (Configuration Push)
تکنیکی: Configuration دستخط شدہ JSON payloads کی صورت میں پہنچتی ہے۔ ایجنٹ ہر payload کو لاگو کرنے سے پہلے validate کرتا ہے۔ کوئی raw SQL نہیں، کوئی shell commands نہیں — صرف منظم configuration.
ایجنٹ → CASTOVIA Cloud (Telemetry)
تکنیکی: Telemetry ہر 30 سیکنڈ بعد HTTPS POST کے ذریعے بھیجی جاتی ہے۔ payload compressed (gzip) اور encrypted ہوتا ہے۔ اوسط سائز: ہر interval میں 2–5 KB.
نیٹ ورک کا خلاصہ
| پہلو | تفصیل |
|---|---|
| پروٹوکول | certificate pinning کے ساتھ HTTPS (TLS 1.3) |
| خروجی پورٹ | 443 (صرف HTTPS) |
| ان باؤنڈ پورٹس | CASTOVIA کے لیے کوئی درکار نہیں |
| ہارٹ بیٹ | ہر 30 سیکنڈ (compressed 2–5 KB) |
| توثیق | Rotating TLS client certificates (7-day rotation) |
| بینڈوڈتھ | management traffic کے لیے < 1 MB/hour |
| آف لائن رویہ | cached config پیش کرتا ہے، telemetry queue کرتا ہے، خودکار reconnect کرتا ہے |
| اسٹریم ٹریفک | کبھی بھی CASTOVIA کے ذریعے route نہیں ہوتی — آپ کے network پر ہی رہتی ہے |
صاف ان انسٹال
اگر آپ کوئی node ہٹا دیں تو ایجنٹ مکمل طور پر صفائی کر دیتا ہے:
sudo castovia-agent uninstall --purge