View, update and delete internal agents
In Invicti Platform you can view all of your internal agents from the Scans > Agents page.
This document walks you through viewing each agent’s details and shows you how to update or remove them.
For information on how to install internal agents, refer to:
- Installing internal agents on Windows
- Installing internal agents using Docker
- Installing internal agents with proxy settings
View all your internal agents
- Select Scans > Agents from the left-side menu.
- All internal agents are displayed on the page.
- To filter the list, click the Status drop-down and select a status (Online or Unknown).
- Invicti displays only the agents matching the selected status.
View more information about an internal agent
- Select Scans > Agents from the left-side menu.
- Click the three dots icon to the right of an agent, then select View.
- Invicti displays a drawer with the details of the selected agent:
- Details tab: Edit the agent’s name and description..
- Targets tab: View assigned targets. You can remove existing targets or add new ones by clicking Assign Target.
Invicti automatically assigns agents a GUID (globally unique identifier) and uses it mainly for troubleshooting and logging. |
Update an internal agent
The Invicti engine is updated regularly when a new version is released. The latest available engine is always pulled so that our customers do not have to run an update. These engine updates do not always impact internal agents.
Occasionally, a new version of the internal agent itself is released. When this happens, updating the agent requires the following steps:
- Reinstall the internal agent using the appropriate installation method.
- Reassign the updated agent to its target(s).
- Delete the old agent once the new one is active.
To update an internal agent means to install it again. Follow the relevant installation instructions:
- Installing internal agents on Windows
- Installing internal agents using Docker
- Installing internal agents with proxy settings
Delete an internal agent
If you delete an agent while it's scanning or it's in the queue, Invicti cancels those scans. You need to assign new agents and restart the scan. |
- From the main menu, select Agents.
- Click the three dots icon to the right of an agent, then select Delete.
- Use the drop-down to select a new agent for all the targets currently assigned to the agent you want to delete. This ensures that the scanning process for those targets continues uninterrupted even after deleting the internal agent.
- Select Yes to delete the agent.
- The agent is now deleted.