An enrolled agent is managed while it holds a licence lease from your DPLens Manager. From then on its configuration, its secrets and its licence come from the Manager, and the console on the machine becomes a window onto the agent rather than a way to change it.
An agent that is enrolled but still pending approval or waiting for a seat is not managed yet — it runs under its local configuration exactly as before. See Enrolling an agent with DPLens Manager.
The console
The sidebar reads Managed by your Manager — local changes are disabled.
These actions are refused with "managed by …", and each refusal is recorded in the audit log under the account that tried:
- applying staged changes to the configuration,
- rolling the configuration back,
- setting a secret,
- applying a recommendation,
- replacing the console certificate,
- applying a licence key,
- capturing the machine for a deployment MSI.
Everything else works as before: every page, the live stream, testing a destination, previews, the audit log, and the Licence page, which shows the licence the Manager granted.
What always stays local
A few settings belong to the machine and are never taken from the Manager:
- the console port,
- the console certificate you installed,
- the diagnostics capture settings.
The Manager never sees them; the agent puts them back into every configuration the Manager sends.
What a Manager may and may not configure
Your Manager renders the configuration; the agent checks every one against its own rules before running it, and refuses — by name, with the position of the offending setting — anything outside them:
- The console can only be made safer. A Manager can switch the console off or turn remote access off, and can shrink the list of networks allowed to reach it — but never turn either back on, or widen the list, beyond what was set on this machine when it enrolled.
- Secrets come only from the Manager. A managed configuration may refer only to secrets the Manager delivered, never to one set by hand on the machine.
- Every path is a local drive path. Network shares, device paths and the other forms that would make the machine connect somewhere are refused before the agent touches the file system. Nothing inside DPLens's own folders or its program folder may be read, watched or used as a cache.
- Receivers only if you allowed them at install. A Manager can configure a syslog or NetFlow receiver only on machines installed with
ALLOW_MANAGED_RECEIVERS=1, listening only on the addresses and admitting only the senders you set at install withMANAGED_RECEIVER_BINDandMANAGED_RECEIVER_ALLOW. - A disk reserve that cannot go below a floor. Each destination's cache keeps at least the floor free on its volume:
DISK_RESERVE_FLOORif you set it at install, otherwise the larger of 10% of the volume and 2 GiB.
These install-time choices are never changed by the Manager. An administrator can change them on the machine with dplens.exe --enrol, but only while the agent is not enrolled — before its first enrolment, or after it has been detached.
Secrets delivered by the Manager
A secret the Manager sends is encrypted to this agent's own key and sealed to the machine like every other secret. It is also bound to the destinations it was sent for: the agent will use it only for those destination addresses, for the same kind of credential, and only while their TLS settings are unchanged. A configuration that tried to send the credential somewhere else, or to turn certificate verification off for it, is refused.
This protects your credentials if a Manager is ever compromised. It is not a barrier against an administrator on the machine, who can always read what the agent can read.
Nothing shows a secret's value — not the console, not the Manager.
Changes made on the machine anyway
Someone with administrator rights can still edit the configuration file on a managed machine. The agent does not undo the edit: it reports it to the Manager as drift at its next check-in, and putting it right is the Manager's decision — an ordinary re-apply of the configuration it intended.
A reboot or an upgrade never shows up as drift.
When a managed configuration cannot start
If, at start-up, the configuration the Manager last sent cannot run because a secret it depends on no longer matches it, the agent does not fail to start. It starts with collection held, reports the problem to the Manager, records it in the audit log, and waits. As soon as the Manager sends a corrected configuration, collection resumes. Pull-based sources lose nothing while it waits.
If the Manager is unreachable
Nothing stops. The agent keeps collecting and delivering under its last configuration, and keeps its counters and five-minute summaries — up to a day of them — to send when it reconnects. Its licence lease lasts its term plus a grace period (by default 30 days plus 7), and only after that does collection stop, exactly as when a standalone licence expires. See Licensing.
When an agent stops being managed
- It is detached — by the Manager, or by an administrator on the machine. See Detaching an agent.
- Its lease runs out — term plus grace without a renewal. The console becomes writable again so that you can act locally.
- It is uninstalled. Uninstalling always removes the agent's Manager identity; a reinstall starts standalone.