Create a Connection Alias

Last Updated: November 26, 2025

You can create a connection alias with a guided setup.

Required User Role: Administrator

To create a connection alias:

  1. Log in to your ServiceNow instance.

  2. Navigate to Tenable Connector for Assets > Guided Setup.

  3. Select the setup type.

  4. Click Continue.

  5. In the Prerequisite page, select the Update the max length of credential field tab and follow the steps in the user interface.

  6. Check the Mark as Complete checkbox.

  7. Click Continue.

  8. Select the Configure Authentication Information tab and follow the steps in the user interface.

  9. Check the Mark as Complete checkbox.

  10. Click Continue.

  11. Select the Test Connection tab and follow the steps in the user interface.

  12. To fetch assets from Tenable, select the Configure Tenable Schedule Import tab and follow the steps in the user interface.

  13. Check the Mark as Complete checkbox.

  14. Click Continue.

Add Multiple Instances (Optional)

  1. Navigate to Tenable Connector for Assets > Add Multiple Instances

  2. Select the Add Another Connections tab and follow the steps in the user interface.

  3. Check the Mark as Complete checkbox.

  4. Click Continue.

  5. Select the Test New Connections tab and follow the steps in the user interface.

  6. Check the Mark as Complete checkbox.

  7. Click Continue.

  8. To fetch assets from Tenable, select the Configure Tenable Schedule Import tab and follow the steps in the user interface.

  9. Check the Mark as Complete checkbox.

  10. Click Continue.

Map Custom Aliases to the Connector (Optional)

Caution: When you create a new alias for your API keys, you may miss the step of mapping this alias to the Connector. This results in the connector defaulting to the wrong alias, causing connection failures and an "Unhealthy" connector status. The procedure to correct this scenario is in the following subsection.

If you have created a new Connection & Credential Alias (instead of using the default), you must manually map it to the Connector.

To map your custom alias to the connector:

  1. Navigate to Connectors.

  2. Select the relevant Tenable connector.

  3. Locate the Service Graph Connection field.

  4. Click the lookup icon.

  5. Select your newly created Connection Alias.

  6. Click Update.

    The changes are saved.