Eén commando. Volledig beveiligd.
De CASTOVIA-agent installeert in minder dan 60 seconden, regelt beveiliging automatisch en communiceert met CASTOVIA Cloud via versleutelde kanalen. Geen handmatige firewallregels, geen SSH-sleutels, geen VPN.
Het installatiecommando uitgelegd
Precies wat er gebeurt wanneer je de éénregelige installer op je Linux-server uitvoert.
Wat het commando doet
Het éénregelige installatiecommando dat je uit het CASTOVIA-beheerdersdashboard kopieert, voert de volgende stappen uit op je Linux-server:
Het daadwerkelijke commando
Het commando dat je in je beheerdersdashboard ziet, ziet er als volgt uit:
curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKENYOUR_SERVER_TOKEN is een uniek, eenmalig te gebruiken token dat per node wordt gegenereerd. Het verloopt na 24 uur als het niet wordt gebruikt.
Wat de agent NIET doet
Duidelijke grenzen. De agent is bewust beperkt van scope.
Beveiliging — Ingebouwd, niet achteraf toegevoegd
Elke beveiligingsmaatregel is automatisch. Geen handmatige configuratie nodig.
Servertoken-authenticatie
automatischElke node krijgt een uniek, cryptografisch willekeurig servertoken (256-bit). Dit token wordt gegenereerd in de CASTOVIA-admin wanneer je een node aanmaakt. Het wordt één keer gebruikt tijdens registratie en daarna vervangen door een roterend TLS-clientcertificaat.
TLS 1.3-versleuteling
automatischAlle communicatie tussen de agent en CASTOVIA Cloud gebruikt TLS 1.3. De agent valideert de CASTOVIA-certificaatketen tegen een vastgepinde root CA — geen vertrouwen in de systeemcertificaatopslag. Man-in-the-middle-aanvallen zijn niet mogelijk.
Firewallvereisten
automatischDe agent heeft alleen uitgaand HTTPS (poort 443) naar CASTOVIA Cloud nodig. Er hoeven geen inkomende poorten geopend te worden. Je firewallregels blijven onaangetast — de agent wijzigt iptables, nftables of firewalld niet.
Geen roottoegang vereist tijdens runtime
automatischDe agent draait als een speciale niet-bevoorrechte gebruiker (castovia-agent). Hij heeft alleen root nodig tijdens de installatie (om de systemd-service aan te maken). Tijdens runtime werkt hij met minimale rechten — leestoegang tot streambronnen, schrijftoegang tot zijn eigen cachemap.
Automatische certificaatrotatie
automatischClientcertificaten roteren elke 7 dagen. De agent behandelt vernieuwing transparant. Als een certificaat verloopt (bijv. server was offline), gebruikt de agent een veilig herinschrijvingsproces dat goedkeuring vereist in de CASTOVIA-admin.
Gezondheidsmonitoring en zelfherstel
automatischDe agent bewaakt zijn eigen gezondheid. Als hij crasht, start systemd hem binnen 5 seconden opnieuw op. Als hij geen verbinding kan maken met CASTOVIA Cloud, blijft hij gecachte configuratie leveren en zet hij statistieken in de wachtrij voor latere levering.
Communicatieprotocol
Hoe data stroomt tussen je server en CASTOVIA Cloud.
CASTOVIA Cloud → Agent (Configuratie push)
Technisch: Configuratie wordt geleverd als ondertekende JSON-payloads. De agent valideert elke payload voordat hij deze toepast. Geen ruwe SQL, geen shellcommando's — alleen gestructureerde configuratie.
Agent → CASTOVIA Cloud (Telemetry)
Technisch: Telemetry wordt elke 30 seconden verzonden via HTTPS POST. Payload is gecomprimeerd (gzip) en versleuteld. Gemiddelde grootte: 2–5 KB per interval.
Netwerksamenvatting
| Aspect | Detail |
|---|---|
| Protocol | HTTPS (TLS 1.3) met certificaatpinnen |
| Uitgaande poort | 443 (alleen HTTPS) |
| Inkomende poorten | Geen vereist door CASTOVIA |
| Hartslag | Elke 30 seconden (2–5 KB gecomprimeerd) |
| Authenticatie | Roterende TLS-clientcertificaten (rotatie om de 7 dagen) |
| Bandbreedte | < 1 MB/uur voor beheerverkeer |
| Gedrag offline | Levert gecachte configuratie, zet telemetry in de wachtrij, maakt automatisch opnieuw verbinding |
| Streamverkeer | Nooit gerouteerd via CASTOVIA — blijft op je netwerk |
Schone verwijdering
Als je een node verwijdert, ruimt de agent alles volledig op:
sudo castovia-agent uninstall --purge