Add or Remove Agents from Agent Profiles

Required Tenable Vulnerability Management User Role: Scan Manager or Administrator

Use the following procedures to add an agent to an agent profile or remove an agent from an agent profile in Tenable Vulnerability Management. You can also add and remove agents from profiles from the Sensor Profile Details page. For more information, see Edit an agent profile.

In addition to using the Tenable Vulnerability Management user interface, you can link an agent to a profile by running the nessuscli agent link command and specifying the optional --profile-uuid argument. You can link an agent to a profile during deployment by specifying the profile-uuid in the config.json file. To find a profile's profile-uuid, see View an agent profile ID.

Note: The agent profile version overrides the agent's Nessus Agent update plan setting. If you assign the agent a freeze window, the freeze window overrides both the Nessus Agent update plan and the agent profile. In this case, the agent remains on its current version and no software updates occur for that agent as long as the agent is assigned to the freeze window.

To apply an agent profile to an agent:

  1. In the upper-left corner, click the Menu button.

    The left navigation plane appears.

  2. In the left navigation plane, click Settings.

    The Settings page appears.

  3. Click the Sensors tile.

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

  4. Click the Nessus Agents tab.

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

  5. Do one of the following:

    • To assign a single agent to an agent profile:

      1. Click in the row of the agent that you want to assign to the profile.

        The action buttons appear in the row.

      2. Click Apply Agent Profile.

        The Select Agent Profile window appears.

      3. In the table, select the checkbox of the agent profile that you want to assign the agent to.

      4. Click Apply.

        Tenable Vulnerability Management assigns the agent to the agent profile.

    • To assign multiple agents to an agent profile, 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 Apply Agent Profile.

        The Select Agent Profile window appears.

      2. In the table, select the checkbox of the agent profile that you want to assign the agents to.

      3. Click Apply.

        Tenable Vulnerability Management assigns the agents to the agent profile. The agents' versions update within 24 hours of the profile application.

To remove an agent profile from an agent:

  1. In the upper-left corner, click the Menu button.

    The left navigation plane appears.

  2. In the left navigation plane, click Settings.

    The Settings page appears.

  3. Click the Sensors tile.

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

  4. Click the Nessus Agents tab.

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

  5. Do one of the following:

    • To remove a single agent from an agent profile:

      1. Click in the row of the agent that you want to assign to the profile.

        The action buttons appear in the row.

      2. Click Remove Agent Profile.

        The Remove Agent Profile window appears.

      3. Click Remove to confirm.

        Tenable Vulnerability Management removes the agent from the agent profile.

    • To remove multiple agents from an agent profile, 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 Remove Agent Profile.

        The Remove Agent Profile window appears.

      2. Click Remove to confirm.

        Tenable Vulnerability Management removes the agents from the agent profile or profiles. The agents' versions update within 24 hours of the profile removal.

What to do next: