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.
- rivex_agent-0.6.0/PKG-INFO +140 -0
- rivex_agent-0.6.0/README.md +109 -0
- rivex_agent-0.6.0/agent_launcher.py +2971 -0
- rivex_agent-0.6.0/core/__init__.py +1 -0
- rivex_agent-0.6.0/core/config_manager.py +195 -0
- rivex_agent-0.6.0/core/install_paths.py +152 -0
- rivex_agent-0.6.0/core/logger.py +30 -0
- rivex_agent-0.6.0/core/patch_engine.py +467 -0
- rivex_agent-0.6.0/core/protection.py +295 -0
- rivex_agent-0.6.0/core/remote_commands.py +112 -0
- rivex_agent-0.6.0/core/scheduler.py +379 -0
- rivex_agent-0.6.0/core/system_deps.py +620 -0
- rivex_agent-0.6.0/core/system_install.py +782 -0
- rivex_agent-0.6.0/core/updater.py +248 -0
- rivex_agent-0.6.0/modules/__init__.py +1 -0
- rivex_agent-0.6.0/modules/base_info.py +85 -0
- rivex_agent-0.6.0/modules/filesystem.py +60 -0
- rivex_agent-0.6.0/modules/fingerprint.py +26 -0
- rivex_agent-0.6.0/modules/metrics.py +199 -0
- rivex_agent-0.6.0/modules/network.py +237 -0
- rivex_agent-0.6.0/modules/security.py +52 -0
- rivex_agent-0.6.0/modules/services.py +111 -0
- rivex_agent-0.6.0/modules/software.py +134 -0
- rivex_agent-0.6.0/pyproject.toml +81 -0
- rivex_agent-0.6.0/rivex_agent.egg-info/PKG-INFO +140 -0
- rivex_agent-0.6.0/rivex_agent.egg-info/SOURCES.txt +31 -0
- rivex_agent-0.6.0/rivex_agent.egg-info/dependency_links.txt +1 -0
- rivex_agent-0.6.0/rivex_agent.egg-info/entry_points.txt +2 -0
- rivex_agent-0.6.0/rivex_agent.egg-info/requires.txt +6 -0
- rivex_agent-0.6.0/rivex_agent.egg-info/top_level.txt +4 -0
- rivex_agent-0.6.0/rivex_agent.py +33 -0
- rivex_agent-0.6.0/setup.cfg +4 -0
- 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
|