Regenerate a Linking Key

Required User Role: Scan Manager or Administrator

Under certain circumstances, you may need to regenerate the linking key for your Tenable.io instance. For example, you may regenerate the key for security reasons if an employee with knowledge of the linking key leaves your organization.

Regenerating a linking key does not affect sensors that are currently linked to Tenable.io, because the linking key is only used to establish the initial link. After you link a sensor, the sensor connects to Tenable.io using unique credentials.

If your organization has hard-coded a linking key into implementation scripts, keep in mind the following:

  • Be sure to replace the original key with the regenerated key to prevent script failure.
  • Each Tenable.io instance uses a single linking key for all sensor types. If you regenerate the linking key while working with one type of sensors (for example, Nessus scanners), you also regenerate the linking key for the other sensor types. If you regenerate the linking key, be sure to update implementation for scripts involving all types of sensors.

To regenerate a linking key for your Tenable.io instance in the new interface:

  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 widget.

    The Sensors page appears.

  4. In the left navigation menu, click any sensor type (for example, NNM).

    The appropriate sensor page appears.

  5. In the upper-right corner of the page, click the Add [Sensor Type] button (for example, Add NNM).

    The appropriate sensor plane appears (for example, Add NNM).

  6. In the Add [Sensor Type] plane, click the Regenerate button.

    A confirmation window appears.

  7. In the confirmation window, click Regenerate.

    The Regenerated Linking Key message appears, and the new linking key replaces the original linking key in the Add [Sensor Type] plane.

What to do next: