Open Settings, choose Scan Agents and revoke the agent from its row in the table. Revoking cancels its key at once. Any profile pinned to it returns to the Cyberlop cloud. Stop the container on your own machine as well.
Steps
Cyberlop calls removal revoking. The key stops working the moment you do it, even if a scan is mid-flight, so choose a quiet time.
STEPSWhat changes
Revoking has three effects.
| Item | Result |
|---|---|
| Agent key | Invalid straight away |
| Pinned profiles | Revert to the Cyberlop cloud |
| Scan capacity | The agent's extra concurrent capacity goes away |
Good to know
This is the step to watch. A profile that scans an internal app cannot be reached from the cloud. After the revert, those scans have nowhere to go. Pin them to another agent first, because otherwise the next scheduled run of each affected profile will have no route to the app it is meant to test.
Look for the control at the end of the row, since the docs call this action revoke. Scripts can use DELETE /api/agents/:id, which needs the settings:update permission.
Tell colleagues before you act, because their scans may be affected.
Planning to replace the agent rather than drop it? Add the new one first with the add steps, move the profiles, and then revoke the old one. That order avoids a gap in coverage.
Questions about a stuck row? Write to us on the contact page.
Removal is a good moment to tidy up. Delete any copies of the old enrollment command from chat threads and wikis, and remove the host from your inventory if it only served this agent. A clean record helps the next person who reads your setup notes and wonders what is still live.
Related questions
- How do I add a self-hosted scan agent?
- How do I see whether my scan agent is online?
- What is a self-hosted scan agent, and when do I need one?
- Does adding a scan agent let me run more scans at once?
- I added a scan agent but still can't run more scans at once. Why?
Cyberlop self-hosted scan agents: scan private apps from inside your network
Step-by-step, with annotated screenshots.
Updated · Back to the help centre
Still stuck?
Tell us what you see on screen and an engineer will help you sort it out.