Une seule commande. Entièrement sécurisé.
L'agent CASTOVIA s'installe en moins de 60 secondes, gère automatiquement la sécurité et communique avec CASTOVIA Cloud via des canaux chiffrés. Aucune règle de pare-feu manuelle, aucune clé SSH, aucun VPN.
Explication de la commande d'installation
Précisément ce qui se passe lorsque vous exécutez l'installateur en une ligne sur votre serveur Linux.
Ce que fait la commande
La commande d'installation en une ligne que vous copiez depuis le tableau de bord admin CASTOVIA effectue les étapes suivantes sur votre serveur Linux :
La commande réelle
La commande que vous voyez dans votre tableau de bord admin ressemble à ceci :
curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKENYOUR_SERVER_TOKEN est un jeton unique à usage unique généré pour chaque nœud. Il expire après 24 heures s'il n'est pas utilisé.
Ce que l'agent ne fait PAS
Des limites claires. L'agent est volontairement limité dans son périmètre.
Sécurité — intégrée, pas ajoutée après coup
Chaque mesure de sécurité est automatique. Aucune configuration manuelle requise.
Authentification par jeton serveur
automatiqueChaque nœud reçoit un jeton serveur unique et cryptographiquement aléatoire (256 bits). Ce jeton est généré dans l'admin CASTOVIA lorsque vous créez un nœud. Il est utilisé une seule fois lors de l'enregistrement puis remplacé par un certificat client TLS rotatif.
Chiffrement TLS 1.3
automatiqueToutes les communications entre l'agent et CASTOVIA Cloud utilisent TLS 1.3. L'agent valide la chaîne de certificats CASTOVIA contre une CA racine épinglée — aucune confiance dans le magasin de certificats du système. Les attaques de type man-in-the-middle sont impossibles.
Exigences de pare-feu
automatiqueL'agent n'a besoin que de HTTPS sortant (port 443) vers CASTOVIA Cloud. Aucun port entrant n'a besoin d'être ouvert. Les règles de pare-feu de votre serveur restent inchangées — l'agent ne modifie pas iptables, nftables ni firewalld.
Aucun accès root requis à l'exécution
automatiqueL'agent s'exécute en tant qu'utilisateur non privilégié dédié (castovia-agent). Il n'a besoin de root que pendant l'installation (pour créer le service systemd). À l'exécution, il opère avec des permissions minimales — accès en lecture aux sources de flux, accès en écriture à son propre répertoire de cache.
Rotation automatique des certificats
automatiqueLes certificats client tournent tous les 7 jours. L'agent gère le renouvellement de manière transparente. Si un certificat expire (par ex. serveur hors ligne), l'agent utilise un flux de réinscription sécurisé qui nécessite une approbation dans l'admin CASTOVIA.
Surveillance de santé et auto-réparation
automatiqueL'agent surveille sa propre santé. S'il plante, systemd le redémarre en moins de 5 secondes. S'il ne peut pas atteindre CASTOVIA Cloud, il continue à servir la configuration mise en cache et met les métriques en file d'attente pour une transmission ultérieure.
Protocole de communication
Comment les données circulent entre votre serveur et CASTOVIA Cloud.
CASTOVIA Cloud → Agent (Push de configuration)
Technique: La configuration est livrée sous forme de charges JSON signées. L'agent valide chaque charge avant de l'appliquer. Pas de SQL brut, pas de commandes shell — uniquement une configuration structurée.
Agent → CASTOVIA Cloud (Télémétrie)
Technique: La télémétrie est envoyée toutes les 30 secondes via HTTPS POST. La charge est compressée (gzip) et chiffrée. Taille moyenne : 2–5 KB par intervalle.
Résumé réseau
| Aspect | Détail |
|---|---|
| Protocole | HTTPS (TLS 1.3) avec épinglage de certificat |
| Port sortant | 443 (HTTPS uniquement) |
| Ports entrants | Aucun requis par CASTOVIA |
| Signal de présence | Toutes les 30 secondes (2–5 KB compressés) |
| Authentification | Certificats client TLS rotatifs (rotation sur 7 jours) |
| Bande passante | < 1 MB/heure pour le trafic de gestion |
| Comportement hors ligne | Sert la configuration en cache, met la télémétrie en file d'attente, se reconnecte automatiquement |
| Trafic des flux | Jamais acheminé via CASTOVIA — reste sur votre réseau |
Désinstallation propre
Si vous supprimez un nœud, l'agent nettoie complètement :
sudo castovia-agent uninstall --purge