rivex-agent 0.7.4

Rivex security posture collection agent (cross-platform)

rivex-agent

Agent collecteur multi-plateforme pour la plateforme de surveillance de posture de securite Rivex. Collecte logs systeme, version OS, niveaux de patchs, ports ouverts, permissions de fichiers sensibles et remonte le tout vers le serveur central chiffre.

Version et changelog (obligatoire a chaque changement de code)

1. Choisir le prochain numéro (souvent +1 sur le patch : 0.7.x).
2. Mettre a jour : agent_launcher.py (APP_VERSION), pyproject.toml, config.json (défaut), core/config_manager.py si c’est la source du défaut de version, test/unit/test_protection.py (payload d’exemple) si la version y figure, src/server/frontend/public/agent/version.json (téléchargement dashboard), badge agent dans le README a la racine du depot.
3. Rédiger une section dans CHANGELOG.md (ce repertoire) : date, intitulé des correctifs / fonctionnalités , ligne pip install rivex-agent==... en bas de section si publie sur PyPI.

Composant PMEs : s installe sur chaque machine (serveur Linux ou poste Windows) pour alimenter le score de securite en temps reel du dashboard.

Installation

A. Via PyPI (recommande pour developpeurs / tests)

pip install rivex-agent
rivex-agent --version

B. Installation systeme (service au demarrage)

Linux (root requis) :

pip install rivex-agent
sudo rivex-agent --install
# => /opt/rivex-agent/ + systemd unit + symlink /usr/local/bin/rivex-agent
sudo systemctl status rivex-agent

Windows (admin requis) :

pip install rivex-agent
rivex-agent --install            # UAC prompt automatique
Get-Service RivexAgent

C. Binaire autonome (sans Python)

Telecharger depuis le dashboard Rivex ou la page releases :

• Linux : rivex-agent-linux-x86_64
• Windows : rivex-agent-windows-x86_64.exe

Binaires PyInstaller sans dependance externe. Fonctionnement identique a la version pip.

D. Mode portable (developpement)

git clone https://gitlab.com/rivex/pa4a
cd pa4a/src/agent
python agent_launcher.py --version

Tous les modes partagent la meme CLI. Seuls les chemins de config / logs different (voir "Chemins" ci-dessous).

Commandes principales

Commande	Description
rivex-agent --enroll --url https://rivex.example.com --c "srv-prod"	Enregistre une nouvelle machine (cle d org). Rattachement / re-activation : --enroll --enroll_key <cle fiche>
rivex-agent --scan	Effectue un scan complet et envoie le payload
rivex-agent --sync	Synchronise l etat avec le serveur
rivex-agent --status	Affiche l etat local
rivex-agent --diagnostic	Rapport complet (config, log, deps systeme, etc.)
rivex-agent --install	Installe comme service systeme (root/admin)
rivex-agent --uninstall [--purge]	Retire l installation
rivex-agent --install_status	Etat de l installation (JSON)
rivex-agent --check_system_deps	Audit des outils OS requis
rivex-agent --install_system_deps	Installe les outils OS manquants
rivex-agent --check_protection	Verifie l integrite des fichiers critiques
rivex-agent --patch <source>	Applique un patch de remediation (file / URL)
rivex-agent --help	Aide complete groupee par categorie
rivex-agent -v / --version	Affiche la version de l agent (build / APP_VERSION)

Statuts sur le serveur (admin)

Si l administrateur suspend l agent, la sync echoue en 403 tant que l agent n est pas reactive ; le token local reste valide. En cas de revocation, le serveur regenere le token : rivex-agent --enroll --enroll_key avec la cle de la fiche machine (saisie explicite en CLI si l agent est en statut local revoked). Voir documentation/agent/etat-cote-serveur.md (depot) et la doc serveur.

Elevation automatique

Les actions --install, --uninstall, --service-run, --patch, --install_system_deps, --update, --set_scan_interval, --enable_auto_scan, --disable_auto_scan declenchent une elevation automatique :

• Linux : re-exec via sudo -E
• Windows : UAC prompt via ShellExecuteW runas

Si deja admin, aucune invite n apparait.

Chemins

Mode	Config	Runtime	Logs
Portable	.runtime/config.json	.runtime/	.runtime/logs/
Installe Linux	/etc/rivex-agent/config.json (seed) + /var/lib/rivex-agent/.runtime/config.json (live)	/var/lib/rivex-agent/.runtime/	/var/log/rivex-agent/
Installe Windows	%ProgramData%\Rivex\Agent\config.json (seed) + .runtime\config.json (live)	%ProgramData%\Rivex\Agent\.runtime\	%ProgramData%\Rivex\Agent\logs\

Compatibilite

• Python 3.9 - 3.12
• Linux : Debian / Ubuntu / RHEL / Fedora / Arch (detection auto du gestionnaire de paquets avec priorite apt-get > yum > pacman > dnf)
• Windows : 10 / 11 / Server 2016+

Support

Documentation complete : _agent_explication.md (FR). Changelog : CHANGELOG.md. Issues / support : https://gitlab.com/rivex/pa4a/-/issues