Manage Agent Groups

Required Tenable Vulnerability Management User Role: Scan Manager or Administrator

Use the following procedures to manage agent groups. For general information about agent groups, see Agent Groups.

Create an Agent Group

You can use agent groups to organize and manage the agents linked to your account. You can add an agent to more than one group and configure scans to use these groups as targets.

Use this procedure to create an agent group in Tenable Vulnerability Management.

To create a new agent group:

1. In the left navigation, click Sensors.

   The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.

2. Click the Nessus Agents tab.

   The list of agents appears and Linked Agents is selected in the drop-down box.

3. In the drop-down box, select Agent Groups.

   The list of agent groups appears.

4. Click Add Agent Group.

   The agent group settings plane appears.

5. In the Group Name box, type a name for the new agent group.
6. Configure user permissions for the agent group.

7. Click Save.

   The new agent group appears in the table.

Add an Agent to an Agent Group

Use this procedure to add an agent to an agent group in Tenable Vulnerability Management. You can also add agents to a group when you edit an agent group.

To add an agent to agent groups:

1. In the left navigation, click Sensors.

   The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.

2. Click the Nessus Agents tab.

   The list of agents appears and Linked Agents is selected in the drop-down box.

3. In the drop-down box, select Agent Groups.

   The list of agent groups appears.

4. (Optional) Search for a specific agent or filter the agents in the table. For filter descriptions, see Agent Filters.

5. Do one of the following:

   • To add a single agent to agent groups:

     1. In the agents table, roll over the agent you want to add.

        The action buttons appear in the row.

     2. Click the button.

        The Add to Groups plane appears.

   • To add multiple agents to agent groups, do one of the following:

     • In the agents table, select the check box next to each agent you want to add.

     • In the table header, select the check box to select the entire page.

     The action bar appears at the bottom of the page.

     Tip: In the action bar, select Select All Pages to select all linked agents.
     1. In the action bar, click the button.

        The Add to Groups plane appears.

6. Do one of the following: 
   • If there are existing agent groups, select one:
     1. In the search box, search by agent group name.
     2. Click the agent group you want to select.
   • If there are no existing agent groups, create one:
     1. Click add a new group.

        The agent group settings plane appears.

     2. In the text box, type the name of the new group.
     3. In the Users & Groups section, set the user permissions for the new group.
     4. Click Save.

        The Add to Groups plane reappears. The new group appears in the selection list.

7. Click Save to save your changes.

   Tenable Vulnerability Management adds the agent to the selected group or groups.

Remove an Agent from an Agent Group

Use this procedure to remove an agent or agents from an agent group in Tenable Vulnerability Management.

To remove an agent from an agent group:

1. In the left navigation, click Sensors.

   The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.

2. Click the Nessus Agents tab.

   The list of agents appears and Linked Agents is selected in the drop-down box.

3. In the drop-down box, select Agent Groups.

   The list of agent groups appears.

4. (Optional) Search for a specific agent group or filter the agent groups in the table. For filter descriptions, see Agent Group Filters.

5. In the agent groups table, click the agent group you want to modify.

   The Group Details page appears.

6. Remove selected agent groups.

   To remove	Action
   A single agent group	Do one of the following: In the agents table, right-click the agent group you want to remove. The action buttons appear in the row. In the row of the agent group you want to remove, in the Actions column, click the button. The action buttons appear in the row. Select the check box next to the agent group you want to remove. Tenable Vulnerability Management enables More > Remove from Group. Click Remove from Group.
   Multiple agent groups	Do one of the following: In the agents table, select the check box next to each agent you want to remove. In the table header, select the check box to select the entire page. Tenable Vulnerability Management enables More > Remove Selected from Group. Click Remove Selected from Group.

Tenable Vulnerability Management removes the agent or agents from the group.

Edit an Agent Group

Required Tenable Vulnerability Management User Role: Scan Manager or Administrator

Use this procedure to edit an agent group in Tenable Vulnerability Management

To edit an agent group:

1. In the left navigation, click Sensors.

   The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.

2. Click the Nessus Agents tab.

   The list of agents appears and Linked Agents is selected in the drop-down box.

3. In the drop-down box, select Agent Groups.

   The list of agent groups appears.

4. (Optional) Search for a specific agent group or filter the agent groups in the table. For filter descriptions, see Agent Group Filters.

5. Edit agent group settings:

   1. In the agents table, do one of the following:

      • In the Actions column, click the icon for the agent you want to edit.

        The action options appear in the row.

      • Right-click the agent you want to edit.

        The action options appear next to your cursor.

      • Select the check box next to the agent you want to edit.

        The action bar appears at the top of the table.

   2. Click the Edit button.

      The Edit Agent Group plane appears.

   3. In the box, type a new name for the agent group.

   4. Configure user permissions for the agent group.

   5. Click Save to save your changes.

      Tenable Vulnerability Management saves your changes.

6. Assign agents to an agent group:

   1. Click the row of the agent group where you want to add agents.

      The agent group details page appears.

   2. In the upper-right corner, click Assign Agents.

      The assign agents page appears.

   3. (Optional) Search for a specific agent or filter the agents in the table. For filter descriptions, see Agent Filters.

   4. In the agents table, select the check boxes next to the agents you want to add to the agent group.

   5. Click Assign.

      Tenable Vulnerability Management adds the agents to the agent group, and the details page appears.

Delete an Agent Group

Required Tenable Vulnerability Management User Role: Scan Manager or Administrator

Use this procedure to delete an agent group in Tenable Vulnerability Management.

To delete an agent group:

1. In the left navigation, click Sensors.

   The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.

2. Click the Nessus Agents tab.

   The list of agents appears and Linked Agents is selected in the drop-down box.

3. In the drop-down box, select Agent Groups.

   The list of agent groups appears.

4. (Optional) Search for a specific agent group or filter the agent groups in the table. For filter descriptions, see Agent Group Filters.

5. In the agents table, do one of the following:

   • In the row for the agent group you want to delete, in the Actions column, click the button.

     The action options appear in the row.

   • Right-click the agent you want to delete.

     The action options appear next to your cursor.

   • Select the check box for the agent you want to delete.

     The action bar appears at the top.

6. Click Delete.

   A confirmation window appears.

7. Click Delete.

   Tenable Vulnerability Management deletes the agent group.

Agent Group Filters

You can use the filters listed below to filter agent groups in the Agent Groups tab.

Category	Operator	Value
Name	is equal to is not equal to contains does not contain	In the text box, type the name of the agent group.
Creation Date	earlier than later than on not on	In the text box, type the date on which the agent group was created.
Last Modified	earlier than later than on not on	In the text box, type the date on which the agent group was last modified. Modifications include: You modified the agent name or description. You added an agent to the group. You removed an agent from the group.