Ein Befehl. Vollständig abgesichert.
Der CASTOVIA-Agent installiert sich in unter 60 Sekunden, übernimmt die Sicherheit automatisch und kommuniziert mit CASTOVIA Cloud über verschlüsselte Kanäle. Keine manuellen Firewall-Regeln, keine SSH-Keys, kein VPN.
Der Installationsbefehl erklärt
Genau das passiert, wenn Sie den Einzeiler-Installer auf Ihrem Linux-Server ausführen.
Was der Befehl macht
Der Installationsbefehl mit einer Zeile, den Sie aus dem CASTOVIA-Admin-Dashboard kopieren, führt auf Ihrem Linux-Server die folgenden Schritte aus:
Der eigentliche Befehl
Der Befehl, den Sie in Ihrem Admin-Dashboard sehen, sieht so aus:
curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKENYOUR_SERVER_TOKEN ist ein eindeutiges Einmal-Token, das pro Knoten generiert wird. Es läuft nach 24 Stunden ab, wenn es nicht verwendet wird.
Was der Agent NICHT tut
Klare Grenzen. Der Agent ist bewusst im Funktionsumfang begrenzt.
Sicherheit — integriert, nicht nachträglich angebracht
Jede Sicherheitsmaßnahme erfolgt automatisch. Keine manuelle Konfiguration erforderlich.
Server-Token-Authentifizierung
automatischJeder Knoten erhält ein eindeutiges, kryptografisch zufälliges Server-Token (256 Bit). Dieses Token wird im CASTOVIA-Admin generiert, wenn Sie einen Knoten erstellen. Es wird einmal während der Registrierung verwendet und anschließend durch ein rotierendes TLS-Client-Zertifikat ersetzt.
TLS-1.3-Verschlüsselung
automatischDie gesamte Kommunikation zwischen dem Agenten und CASTOVIA Cloud verwendet TLS 1.3. Der Agent validiert die CASTOVIA-Zertifikatskette gegen eine fest verankerte Root-CA — kein Vertrauen in den System-Zertifikatsspeicher. Man-in-the-Middle-Angriffe sind nicht möglich.
Firewall-Anforderungen
automatischDer Agent benötigt nur ausgehendes HTTPS (Port 443) zu CASTOVIA Cloud. Es müssen keine eingehenden Ports geöffnet werden. Ihre Server-Firewall-Regeln bleiben unberührt — der Agent verändert iptables, nftables oder firewalld nicht.
Zur Laufzeit kein Root-Zugriff erforderlich
automatischDer Agent läuft als dedizierter, nicht privilegierter Benutzer (castovia-agent). Root wird nur während der Installation benötigt (um den systemd-Dienst zu erstellen). Zur Laufzeit arbeitet er mit minimalen Berechtigungen — Lesezugriff auf Stream-Quellen, Schreibzugriff auf sein eigenes Cache-Verzeichnis.
Automatische Zertifikatsrotation
automatischClient-Zertifikate rotieren alle 7 Tage. Der Agent übernimmt die Erneuerung transparent. Wenn ein Zertifikat abläuft (z. B. Server war offline), verwendet der Agent einen sicheren Re-Enrollment-Flow, der eine Genehmigung im CASTOVIA-Admin erfordert.
Gesundheitsüberwachung & Selbstheilung
automatischDer Agent überwacht seinen eigenen Zustand. Wenn er abstürzt, startet systemd ihn innerhalb von 5 Sekunden neu. Wenn er CASTOVIA Cloud nicht erreichen kann, liefert er weiterhin die zwischengespeicherte Konfiguration aus und stellt Metriken für die spätere Übertragung in eine Warteschlange.
Kommunikationsprotokoll
Wie Daten zwischen Ihrem Server und CASTOVIA Cloud fließen.
CASTOVIA Cloud → Agent (Konfigurations-Push)
Technisch: Die Konfiguration wird als signierte JSON-Payloads geliefert. Der Agent validiert jede Payload vor der Anwendung. Kein rohes SQL, keine Shell-Befehle — nur strukturierte Konfiguration.
Agent → CASTOVIA Cloud (Telemetrie)
Technisch: Die Telemetrie wird alle 30 Sekunden per HTTPS POST gesendet. Die Payload ist komprimiert (gzip) und verschlüsselt. Durchschnittliche Größe: 2–5 KB pro Intervall.
Netzwerkübersicht
| Aspekt | Detail |
|---|---|
| Protokoll | HTTPS (TLS 1.3) mit Zertifikat-Pinning |
| Ausgehender Port | 443 (nur HTTPS) |
| Eingehende Ports | Keine von CASTOVIA erforderlich |
| Heartbeat | Alle 30 Sekunden (2–5 KB komprimiert) |
| Authentifizierung | Rotierende TLS-Client-Zertifikate (7-Tage-Rotation) |
| Bandbreite | < 1 MB/Stunde für Verwaltungsverkehr |
| Offline-Verhalten | Liefert zwischengespeicherte Konfiguration, stellt Telemetrie in eine Warteschlange, verbindet automatisch erneut |
| Stream-Verkehr | Nie über CASTOVIA geroutet — bleibt in Ihrem Netzwerk |
Saubere Deinstallation
Wenn Sie einen Knoten entfernen, bereinigt der Agent alles vollständig:
sudo castovia-agent uninstall --purge