Skip to content
This repository was archived by the owner on Jun 30, 2026. It is now read-only.

Commit 4bcbf9b

Browse files
CopilotRomuDeuxfois
authored andcommitted
[docs] fix(executors): correct misleading implant cleanup statement
1 parent a4c0943 commit 4bcbf9b

2 files changed

Lines changed: 20 additions & 29 deletions

File tree

docs/deployment/ecosystem/executors.md

Lines changed: 17 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -31,13 +31,6 @@ payloads on endpoints.
3131
The Tanium agent can be leveraged to execute implants as detached processes that will then execute payloads, according
3232
to the [OpenAEV architecture](https://docs.openaev.io/latest/deployment/platform/overview/).
3333

34-
The implants will be downloaded to these folders on the different assets:
35-
36-
* On Windows assets: `C:\Program Files (x86)\Filigran\OAEV Agent\runtimes\implant-XXXXX`
37-
* On Linux or MacOS assets: `/opt/openaev-agent/runtimes/implant-XXXXX`
38-
39-
where XXXXX will be a completely random UUID, generated for each inject that will be executed.
40-
This ensures that the implants are unique and will be deleted on assets' restart.
4134

4235
### Configure the Tanium Platform
4336

@@ -129,13 +122,6 @@ Endpoints from the selected computer groups should now appear in the **OpenAEV E
129122
The CrowdStrike Falcon agent can be leveraged to execute implants as detached processes that will then execute payloads
130123
according to the [OpenAEV architecture](https://docs.openaev.io/latest/deployment/platform/overview/).
131124

132-
The implants will be downloaded to these folders on the different assets:
133-
134-
* On Windows assets: `C:\Program Files (x86)\Filigran\OAEV Agent\runtimes\implant-XXXXX`
135-
* On Linux or MacOS assets: `/opt/openaev-agent/runtimes/implant-XXXXX`
136-
137-
where XXXXX will be a completely random UUID, generated for each inject that will be executed.
138-
This ensures that the implants are unique and will be deleted on assets' restart.
139125

140126
### Configure the CrowdStrike Platform
141127

@@ -301,13 +287,6 @@ according to the [OpenAEV architecture](https://docs.openaev.io/latest/deploymen
301287

302288
On Windows, because Palo Alto Cortex whitelists its own process tree, OpenAEV creates a scheduled task to detach the process that will execute the payloads.
303289

304-
The implants will be downloaded to these folders on the different assets:
305-
306-
* On Windows assets: `C:\Program Files (x86)\Filigran\OAEV Agent\runtimes\implant-XXXXX`
307-
* On Linux or MacOS assets: `/opt/openaev-agent/runtimes/implant-XXXXX`
308-
309-
where XXXXX will be a completely random UUID, generated for each inject that will be executed.
310-
This ensures that the implants are unique and will be deleted on assets' restart.
311290

312291
### Configure the Palo Alto Cortex Platform
313292

@@ -392,13 +371,6 @@ Endpoint on the OpenAEV endpoint page.
392371
The SentinelOne agent can be leveraged to execute implants as detached processes that will then execute payloads
393372
according to the [OpenAEV architecture](https://docs.openaev.io/latest/deployment/platform/overview/).
394373

395-
The implants will be downloaded to these folders on the different assets:
396-
397-
* On Windows assets: `C:\Program Files (x86)\Filigran\OAEV Agent\runtimes\implant-XXXXX`
398-
* On Linux or MacOS assets: `/opt/openaev-agent/runtimes/implant-XXXXX`
399-
400-
where XXXXX will be a completely random UUID, generated for each inject that will be executed.
401-
This ensures that the implants are unique and will be deleted on assets' restart.
402374

403375
!!! warning "SentinelOne"
404376

@@ -585,3 +557,20 @@ Run the following commands with an administrator Powershell in order to uninstal
585557
`schtasks /delete /tn OpenAEVCaldera`<br/>
586558
`Stop-Process -Name oaev-agent-caldera`<br/>
587559
`rm -force -Recurse "C:\Program Files (x86)\Filigran\OAEV Caldera"`
560+
561+
## Implant directories and cleanup
562+
563+
For all executors (except Caldera and OpenAEV agent), implants are downloaded to the following folders on the endpoints:
564+
565+
* On Windows assets: `C:\Program Files (x86)\Filigran\OAEV Agent\runtimes\implant-XXXXX`
566+
* On Linux or MacOS assets: `/opt/openaev-agent/runtimes/implant-XXXXX`
567+
568+
where `XXXXX` is a completely random UUID, generated for each inject that will be executed.
569+
570+
- Each implant directory is unique per inject.
571+
- Old implant directories are periodically cleaned up by the platform. Every `clean-implant-interval` hours (default: **8**), the platform sends a cleanup command to each endpoint agent, which removes all directories in `runtimes/` and `payloads/` that are older than **24 hours**.
572+
573+
!!! note "OpenAEV Agent"
574+
575+
The OpenAEV Agent has its own built-in garbage collector with different thresholds. See the [OpenAEV Agent documentation](../../usage/openaev-agent.md) for details.
576+

docs/usage/openaev-agent.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -246,7 +246,9 @@ The main features of the OpenAEV Agent include:
246246
* Automatic agent upgrade (on startup and registration)
247247
* Periodic job retrieval (every 30 seconds)
248248
* Implant lifecycle management
249-
* Execution cleanup and directory pruning
249+
* Execution cleanup and directory pruning (garbage collector running every **3 minutes**):
250+
* Directories matching `runtimes/execution-*` and `payloads/execution-*` older than **20 minutes** are processed: associated processes are killed, then the directories are renamed from `execution-*` to `executed-*`.
251+
* Directories matching `runtimes/executed-*` and `payloads/executed-*` older than **2 days** are permanently deleted.
250252
* Health checks (heartbeat every 2 minutes)
251253

252254
---

0 commit comments

Comments
 (0)