Agent és kommunikáció

Egy parancs. Teljesen biztonságos.

A CASTOVIA agent kevesebb mint 60 másodperc alatt települ, automatikusan kezeli a biztonságot, és titkosított csatornákon kommunikál a CASTOVIA Clouddal. Nincs szükség kézi tűzfalszabályokra, SSH kulcsokra vagy VPN-re.

A telepítési parancs magyarázata

Pontosan mi történik, amikor lefuttatja az egysoros telepítőt Linux szerverén.

Mit csinál a parancs

Az egysoros telepítési parancs, amelyet a CASTOVIA admin vezérlőpultból másol ki, a következő lépéseket hajtja végre Linux szerverén:

Letölti a CASTOVIA agent binárisát (~15 MB) a hivatalos CDN-ről
Ellenőrzi a bináris aláírását (SHA-256 + GPG) a manipuláció megakadályozása érdekében
Létrehoz egy dedikált rendszerfelhasználót: castovia-agent (nincs login shell, nincs sudo)
Telepíti a binárist a /opt/castovia/agent útvonalra
Létrehozza a /etc/castovia/ konfigurációs könyvtárat korlátozott jogosultságokkal (0700)
A szervertokent (csomópontonként egyedi) a /etc/castovia/token.conf fájlba írja
Az agentet systemd szolgáltatásként regisztrálja: castovia-agent.service
Elindítja a szolgáltatást és engedélyezi az automatikus indítást bootkor
Első kézfogást hajt végre a CASTOVIA Clouddal a csomópont regisztrálásához

A tényleges parancs

Az a parancs, amelyet az admin vezérlőpulton lát, így néz ki:

curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKEN

A YOUR_SERVER_TOKEN egy egyedi, egyszer használatos token, amely csomópontonként generálódik. Fel nem használva 24 óra után lejár.

Mit NEM csinál az agent

Világos határok. Az agent szándékosan korlátozott funkcionalitású.

Nem nyit meg bejövő portokat a szerverén
Nem módosítja a tűzfalszabályokat (iptables, nftables, firewalld)
Nem telepít vagy módosít SSH kulcsokat
Nem fér hozzá a szerverén lévő más alkalmazásokhoz
Nem továbbít stream tartalmat a CASTOVIA szerverein keresztül (a streamek az ÖN hálózatán maradnak)
Nem tárol személyes előfizetői adatokat a csomóponton
Nem igényel VPN-t vagy külön hálózati konfigurációt
Nem fut rootként az első telepítés után

Biztonság — beépítve, nem utólag hozzácsavarva

Minden biztonsági intézkedés automatikus. Nincs szükség kézi konfigurációra.

Szervertokenes hitelesítés

automatikusan

Minden csomópont egyedi, kriptográfiailag véletlenszerű szervertokent kap (256 bites). Ezt a tokent a CASTOVIA adminban generálják, amikor létrehoz egy csomópontot. Egyszer használják regisztrációkor, majd egy forgó TLS kliens tanúsítvány váltja fel.

TLS 1.3 titkosítás

automatikusan

Az agent és a CASTOVIA Cloud közötti összes kommunikáció TLS 1.3-at használ. Az agent a CASTOVIA tanúsítványláncát egy rögzített root CA-hoz ellenőrzi — nincs bizalom a rendszer tanúsítványtárában. Man-in-the-middle támadások nem lehetségesek.

Tűzfal-követelmények

automatikusan

Az agentnek csak kimenő HTTPS (443-as port) kapcsolatra van szüksége a CASTOVIA Cloud felé. Nincs szükség bejövő portok megnyitására. A szerver tűzfalszabályai érintetlenek maradnak — az agent nem módosítja az iptables, nftables vagy firewalld beállításait.

Futás közben nincs szükség root hozzáférésre

automatikusan

Az agent egy dedikált, nem privilegizált felhasználóként fut (castovia-agent). Rootra csak telepítéskor van szüksége (a systemd szolgáltatás létrehozásához). Futás közben minimális jogosultságokkal működik — olvasási hozzáférés a stream forrásokhoz, írási hozzáférés a saját cache könyvtárához.

Automatikus tanúsítványrotáció

automatikusan

A kliens tanúsítványok 7 naponta cserélődnek. Az agent átláthatóan kezeli a megújítást. Ha egy tanúsítvány lejár (pl. a szerver offline volt), az agent egy biztonságos újrabejelentkezési folyamatot használ, amely jóváhagyást igényel a CASTOVIA adminban.

Állapotfigyelés és önjavítás

automatikusan

Az agent figyeli a saját állapotát. Ha összeomlik, a systemd 5 másodpercen belül újraindítja. Ha nem éri el a CASTOVIA Cloudot, tovább szolgálja a gyorsítótárazott konfigurációt, és sorba állítja a metrikákat későbbi továbbításra.

Kommunikációs protokoll

Hogyan áramlik az adat az Ön szervere és a CASTOVIA Cloud között.

CASTOVIA Cloud → Agent (Konfiguráció továbbítása)

Stream-konfigurációk (forrás URL-ek, transzkódolási profilok, felvételi ütemezések)
Nginx konfigurációs részletek a médiakiszolgáláshoz
Catch-up és timeshift szabályok
EPG adatok és csatornalogók
Csomag-/bouquet-hozzárendelések
Előfizetői jogosultságfrissítések

Műszaki: A konfiguráció aláírt JSON payloadokként kerül kézbesítésre. Az agent minden payloadot ellenőriz az alkalmazás előtt. Nincs nyers SQL, nincs shell parancs — csak strukturált konfiguráció.

Agent → CASTOVIA Cloud (Telemetria)

Szerverállapot: CPU, RAM, lemezhasználat, hálózati I/O
Stream állapot: aktív streamek, bitráta, hibaarányok
Felvételi állapot: aktív felvételek, felhasznált tárhely, befejezési állapot
FFmpeg job eredmények: transzkód befejezése, hibák, kimeneti fájlméretek
Nézői kapcsolatszámok (anonim összesítés — nincs személyes adat)
Agent verzió és frissítési elérhetőség

Műszaki: A telemetria 30 másodpercenként kerül elküldésre HTTPS POST segítségével. A payload tömörített (gzip) és titkosított. Átlagos méret: 2–5 KB intervallumonként.

Hálózati összefoglaló

SzempontRészlet
ProtokollHTTPS (TLS 1.3) tanúsítvány-pineléssel
Kimenő port443 (csak HTTPS)
Bejövő portokA CASTOVIA részéről nincs szükség rá
Heartbeat30 másodpercenként (2–5 KB tömörítve)
HitelesítésForgó TLS kliens tanúsítványok (7 napos rotáció)
Sávszélesség< 1 MB/óra a menedzsment forgalomhoz
Offline viselkedésGyorsítótárazott konfigurációt szolgál ki, telemetriát sorba állít, automatikusan újracsatlakozik
Stream forgalomSoha nem kerül a CASTOVIA-n keresztül — az Ön hálózatán marad

Tiszta eltávolítás

Ha eltávolít egy csomópontot, az agent teljesen kitakarít maga után:

sudo castovia-agent uninstall --purge
Leállítja és eltávolítja a systemd szolgáltatást
Törli a binárist a /opt/castovia/ útvonalról
Eltávolítja az összes konfigurációt a /etc/castovia/ könyvtárból
Eltávolítja a castovia-agent rendszerfelhasználót
Visszavonja a kliens tanúsítványt a CASTOVIA Cloudban
Nincs hátramaradó fájl, folyamat vagy cron feladat