Link an Agent to Nessus Manager

After you install Nessus Agent, link the agent to Nessus Manager.

Before you begin:

To link Nessus Agent to Nessus Manager:

  1. Log in to the Nessus Agent from a command terminal.

  2. At the agent command prompt, use the command nessuscli agent link using the supported arguments.

    For example:

The following table lists the supported arguments for nessuscli agent link

Argument Required Value
--key

yes

The linking key that you from the manager.
--host yes

The static IP address or hostname you set during the Nessus Manager installation.

--port yes 8834 or your custom port.

--name

no A name for your agent. If you do not specify a name for your agent, the name defaults to the name of the computer where you are installing the agent.
--ca-path no A custom CA certificate to use to validate the manager's server certificate.
--groups no

One or more existing agent groups where you want to add the agent. If you do not specify an agent group during the install process, you can add your linked agent to an agent group later in Nessus Manager.

List multiple groups in a comma-separated list. If any group names have spaces, use quotes around the whole list.

For example: --groups="Atlanta,Global Headquarters"

Note: The agent group name is case-sensitive and must match exactly.

--offline-install no

If enabled (set to "yes"), installs Nessus Agent on the system, even if it is offline. Nessus Agent periodically attempts to link itself to its manager.

If the agent cannot connect to the controller, it retries every hour. If the agent can connect to the controller but the link fails, it retries every 24 hours.

--proxy-host no

The hostname or IP address of your proxy server.

--proxy-port no The port number of the proxy server.
--proxy-password no The password of the user account that you specified as the username.
--proxy-username no The name of a user account that has permissions to access and use the proxy server.
--proxy-agent no The user agent name, if your proxy requires a preset user agent.