rivex-agent 0.6.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. rivex_agent-0.6.0/PKG-INFO +140 -0
  2. rivex_agent-0.6.0/README.md +109 -0
  3. rivex_agent-0.6.0/agent_launcher.py +2971 -0
  4. rivex_agent-0.6.0/core/__init__.py +1 -0
  5. rivex_agent-0.6.0/core/config_manager.py +195 -0
  6. rivex_agent-0.6.0/core/install_paths.py +152 -0
  7. rivex_agent-0.6.0/core/logger.py +30 -0
  8. rivex_agent-0.6.0/core/patch_engine.py +467 -0
  9. rivex_agent-0.6.0/core/protection.py +295 -0
  10. rivex_agent-0.6.0/core/remote_commands.py +112 -0
  11. rivex_agent-0.6.0/core/scheduler.py +379 -0
  12. rivex_agent-0.6.0/core/system_deps.py +620 -0
  13. rivex_agent-0.6.0/core/system_install.py +782 -0
  14. rivex_agent-0.6.0/core/updater.py +248 -0
  15. rivex_agent-0.6.0/modules/__init__.py +1 -0
  16. rivex_agent-0.6.0/modules/base_info.py +85 -0
  17. rivex_agent-0.6.0/modules/filesystem.py +60 -0
  18. rivex_agent-0.6.0/modules/fingerprint.py +26 -0
  19. rivex_agent-0.6.0/modules/metrics.py +199 -0
  20. rivex_agent-0.6.0/modules/network.py +237 -0
  21. rivex_agent-0.6.0/modules/security.py +52 -0
  22. rivex_agent-0.6.0/modules/services.py +111 -0
  23. rivex_agent-0.6.0/modules/software.py +134 -0
  24. rivex_agent-0.6.0/pyproject.toml +81 -0
  25. rivex_agent-0.6.0/rivex_agent.egg-info/PKG-INFO +140 -0
  26. rivex_agent-0.6.0/rivex_agent.egg-info/SOURCES.txt +31 -0
  27. rivex_agent-0.6.0/rivex_agent.egg-info/dependency_links.txt +1 -0
  28. rivex_agent-0.6.0/rivex_agent.egg-info/entry_points.txt +2 -0
  29. rivex_agent-0.6.0/rivex_agent.egg-info/requires.txt +6 -0
  30. rivex_agent-0.6.0/rivex_agent.egg-info/top_level.txt +4 -0
  31. rivex_agent-0.6.0/rivex_agent.py +33 -0
  32. rivex_agent-0.6.0/setup.cfg +4 -0
  33. rivex_agent-0.6.0/test/test_all_commands.py +527 -0
@@ -0,0 +1,140 @@
1
+ Metadata-Version: 2.4
2
+ Name: rivex-agent
3
+ Version: 0.6.0
4
+ Summary: Rivex security posture collection agent (cross-platform)
5
+ Author: Rivex Team
6
+ License: Proprietary
7
+ Project-URL: Homepage, https://rivex.local
8
+ Project-URL: Documentation, https://rivex.local/docs/agent
9
+ Project-URL: Source, https://gitlab.com/rivex/pa4a
10
+ Project-URL: Issue Tracker, https://gitlab.com/rivex/pa4a/-/issues
11
+ Keywords: security,posture,vulnerability,agent,collector,cybersecurity,sme
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Environment :: Console
14
+ Classifier: Environment :: No Input/Output (Daemon)
15
+ Classifier: Intended Audience :: System Administrators
16
+ Classifier: Operating System :: POSIX :: Linux
17
+ Classifier: Operating System :: Microsoft :: Windows
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.9
20
+ Classifier: Programming Language :: Python :: 3.10
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Topic :: Security
24
+ Classifier: Topic :: System :: Monitoring
25
+ Requires-Python: >=3.9
26
+ Description-Content-Type: text/markdown
27
+ Requires-Dist: psutil>=5.9
28
+ Requires-Dist: requests>=2.31
29
+ Requires-Dist: cryptography>=42
30
+ Requires-Dist: distro>=1.9; sys_platform == "linux"
31
+
32
+ # rivex-agent
33
+
34
+ Agent collecteur multi-plateforme pour la plateforme de surveillance de
35
+ posture de securite **Rivex**. Collecte logs systeme, version OS, niveaux de
36
+ patchs, ports ouverts, permissions de fichiers sensibles et remonte le tout
37
+ vers le serveur central chiffre.
38
+
39
+ > Composant PMEs : s installe sur chaque machine (serveur Linux ou poste
40
+ > Windows) pour alimenter le score de securite en temps reel du dashboard.
41
+
42
+ ## Installation
43
+
44
+ ### A. Via PyPI (recommande pour developpeurs / tests)
45
+
46
+ ```bash
47
+ pip install rivex-agent
48
+ rivex-agent --version
49
+ ```
50
+
51
+ ### B. Installation systeme (service au demarrage)
52
+
53
+ Linux (root requis) :
54
+
55
+ ```bash
56
+ pip install rivex-agent
57
+ sudo rivex-agent --install
58
+ # => /opt/rivex-agent/ + systemd unit + symlink /usr/local/bin/rivex-agent
59
+ sudo systemctl status rivex-agent
60
+ ```
61
+
62
+ Windows (admin requis) :
63
+
64
+ ```powershell
65
+ pip install rivex-agent
66
+ rivex-agent --install # UAC prompt automatique
67
+ Get-Service RivexAgent
68
+ ```
69
+
70
+ ### C. Binaire autonome (sans Python)
71
+
72
+ Telecharger depuis le dashboard Rivex ou la page releases :
73
+
74
+ - Linux : `rivex-agent-linux-x86_64`
75
+ - Windows : `rivex-agent-windows-x86_64.exe`
76
+
77
+ Binaires PyInstaller sans dependance externe. Fonctionnement identique a la
78
+ version pip.
79
+
80
+ ### D. Mode portable (developpement)
81
+
82
+ ```bash
83
+ git clone https://gitlab.com/rivex/pa4a
84
+ cd pa4a/src/agent
85
+ python agent_launcher.py --version
86
+ ```
87
+
88
+ Tous les modes partagent la meme CLI. Seuls les chemins de config / logs
89
+ different (voir "Chemins" ci-dessous).
90
+
91
+ ## Commandes principales
92
+
93
+ | Commande | Description |
94
+ |---|---|
95
+ | `rivex-agent --enroll --url https://rivex.example.com --c "srv-prod"` | Enregistre l agent sur le serveur |
96
+ | `rivex-agent --scan` | Effectue un scan complet et envoie le payload |
97
+ | `rivex-agent --sync` | Synchronise l etat avec le serveur |
98
+ | `rivex-agent --status` | Affiche l etat local |
99
+ | `rivex-agent --diagnostic` | Rapport complet (config, log, deps systeme, etc.) |
100
+ | `rivex-agent --install` | Installe comme service systeme (root/admin) |
101
+ | `rivex-agent --uninstall [--purge]` | Retire l installation |
102
+ | `rivex-agent --install_status` | Etat de l installation (JSON) |
103
+ | `rivex-agent --check_system_deps` | Audit des outils OS requis |
104
+ | `rivex-agent --install_system_deps` | Installe les outils OS manquants |
105
+ | `rivex-agent --check_protection` | Verifie l integrite des fichiers critiques |
106
+ | `rivex-agent --patch <source>` | Applique un patch de remediation (file / URL) |
107
+ | `rivex-agent --help` | Aide complete groupee par categorie |
108
+
109
+ ## Elevation automatique
110
+
111
+ Les actions `--install`, `--uninstall`, `--service-run`, `--patch`,
112
+ `--install_system_deps`, `--update`, `--set_scan_interval`,
113
+ `--enable_auto_scan`, `--disable_auto_scan` declenchent une elevation
114
+ automatique :
115
+
116
+ - Linux : re-exec via `sudo -E`
117
+ - Windows : UAC prompt via `ShellExecuteW runas`
118
+
119
+ Si deja admin, aucune invite n apparait.
120
+
121
+ ## Chemins
122
+
123
+ | Mode | Config | Runtime | Logs |
124
+ |---|---|---|---|
125
+ | Portable | `.runtime/config.json` | `.runtime/` | `.runtime/logs/` |
126
+ | 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/` |
127
+ | Installe Windows | `%ProgramData%\Rivex\Agent\config.json` (seed) + `.runtime\config.json` (live) | `%ProgramData%\Rivex\Agent\.runtime\` | `%ProgramData%\Rivex\Agent\logs\` |
128
+
129
+ ## Compatibilite
130
+
131
+ - Python 3.9 - 3.12
132
+ - Linux : Debian / Ubuntu / RHEL / Fedora / Arch (detection auto du gestionnaire
133
+ de paquets avec priorite `apt-get` > `yum` > `pacman` > `dnf`)
134
+ - Windows : 10 / 11 / Server 2016+
135
+
136
+ ## Support
137
+
138
+ Documentation complete : `_agent_explication.md` (FR).
139
+ Changelog : `CHANGELOG.md`.
140
+ Issues / support : https://gitlab.com/rivex/pa4a/-/issues
@@ -0,0 +1,109 @@
1
+ # rivex-agent
2
+
3
+ Agent collecteur multi-plateforme pour la plateforme de surveillance de
4
+ posture de securite **Rivex**. Collecte logs systeme, version OS, niveaux de
5
+ patchs, ports ouverts, permissions de fichiers sensibles et remonte le tout
6
+ vers le serveur central chiffre.
7
+
8
+ > Composant PMEs : s installe sur chaque machine (serveur Linux ou poste
9
+ > Windows) pour alimenter le score de securite en temps reel du dashboard.
10
+
11
+ ## Installation
12
+
13
+ ### A. Via PyPI (recommande pour developpeurs / tests)
14
+
15
+ ```bash
16
+ pip install rivex-agent
17
+ rivex-agent --version
18
+ ```
19
+
20
+ ### B. Installation systeme (service au demarrage)
21
+
22
+ Linux (root requis) :
23
+
24
+ ```bash
25
+ pip install rivex-agent
26
+ sudo rivex-agent --install
27
+ # => /opt/rivex-agent/ + systemd unit + symlink /usr/local/bin/rivex-agent
28
+ sudo systemctl status rivex-agent
29
+ ```
30
+
31
+ Windows (admin requis) :
32
+
33
+ ```powershell
34
+ pip install rivex-agent
35
+ rivex-agent --install # UAC prompt automatique
36
+ Get-Service RivexAgent
37
+ ```
38
+
39
+ ### C. Binaire autonome (sans Python)
40
+
41
+ Telecharger depuis le dashboard Rivex ou la page releases :
42
+
43
+ - Linux : `rivex-agent-linux-x86_64`
44
+ - Windows : `rivex-agent-windows-x86_64.exe`
45
+
46
+ Binaires PyInstaller sans dependance externe. Fonctionnement identique a la
47
+ version pip.
48
+
49
+ ### D. Mode portable (developpement)
50
+
51
+ ```bash
52
+ git clone https://gitlab.com/rivex/pa4a
53
+ cd pa4a/src/agent
54
+ python agent_launcher.py --version
55
+ ```
56
+
57
+ Tous les modes partagent la meme CLI. Seuls les chemins de config / logs
58
+ different (voir "Chemins" ci-dessous).
59
+
60
+ ## Commandes principales
61
+
62
+ | Commande | Description |
63
+ |---|---|
64
+ | `rivex-agent --enroll --url https://rivex.example.com --c "srv-prod"` | Enregistre l agent sur le serveur |
65
+ | `rivex-agent --scan` | Effectue un scan complet et envoie le payload |
66
+ | `rivex-agent --sync` | Synchronise l etat avec le serveur |
67
+ | `rivex-agent --status` | Affiche l etat local |
68
+ | `rivex-agent --diagnostic` | Rapport complet (config, log, deps systeme, etc.) |
69
+ | `rivex-agent --install` | Installe comme service systeme (root/admin) |
70
+ | `rivex-agent --uninstall [--purge]` | Retire l installation |
71
+ | `rivex-agent --install_status` | Etat de l installation (JSON) |
72
+ | `rivex-agent --check_system_deps` | Audit des outils OS requis |
73
+ | `rivex-agent --install_system_deps` | Installe les outils OS manquants |
74
+ | `rivex-agent --check_protection` | Verifie l integrite des fichiers critiques |
75
+ | `rivex-agent --patch <source>` | Applique un patch de remediation (file / URL) |
76
+ | `rivex-agent --help` | Aide complete groupee par categorie |
77
+
78
+ ## Elevation automatique
79
+
80
+ Les actions `--install`, `--uninstall`, `--service-run`, `--patch`,
81
+ `--install_system_deps`, `--update`, `--set_scan_interval`,
82
+ `--enable_auto_scan`, `--disable_auto_scan` declenchent une elevation
83
+ automatique :
84
+
85
+ - Linux : re-exec via `sudo -E`
86
+ - Windows : UAC prompt via `ShellExecuteW runas`
87
+
88
+ Si deja admin, aucune invite n apparait.
89
+
90
+ ## Chemins
91
+
92
+ | Mode | Config | Runtime | Logs |
93
+ |---|---|---|---|
94
+ | Portable | `.runtime/config.json` | `.runtime/` | `.runtime/logs/` |
95
+ | 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/` |
96
+ | Installe Windows | `%ProgramData%\Rivex\Agent\config.json` (seed) + `.runtime\config.json` (live) | `%ProgramData%\Rivex\Agent\.runtime\` | `%ProgramData%\Rivex\Agent\logs\` |
97
+
98
+ ## Compatibilite
99
+
100
+ - Python 3.9 - 3.12
101
+ - Linux : Debian / Ubuntu / RHEL / Fedora / Arch (detection auto du gestionnaire
102
+ de paquets avec priorite `apt-get` > `yum` > `pacman` > `dnf`)
103
+ - Windows : 10 / 11 / Server 2016+
104
+
105
+ ## Support
106
+
107
+ Documentation complete : `_agent_explication.md` (FR).
108
+ Changelog : `CHANGELOG.md`.
109
+ Issues / support : https://gitlab.com/rivex/pa4a/-/issues