Adding a New Adapter Connection
  • 27 Jan 2022
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Adding a New Adapter Connection

  • Dark
    Light
  • PDF

You can add a new adapter connection either from the Adapters page or from the Connections page.

Note:

For Axonius-hosted (SaaS) customers only:

  • The Axonius-hosted (SaaS) instance resides in the cloud and is not part of your organization's internal network. Axonius securely fetches data from the organization's data sources, known as adapters.
    The Axonius Tunnel enables establishing a link between an internal network and the Axonius-hosted (SaaS) instance.
  • Axonius Tunnel is only required to connect adapters whose sources are only accessible by an internal network.
  • Axonius Tunnel is not required to connect adapters whose sources are accessible from the internet.
  • Once a tunnel is successfully installed, you need to select the tunnel in the Adapter Configuration dialog under the Tunnel Name field.
  • For details on configuring and installing the Axonius Tunnel, see Installing the Axonius Tunnel.

Adding a New Adapter Connection from the Adapters Page

To add an adapter connection, do the following:

  1. Open the Adapters page. Click the image.png icon on the left navigation panel.
  2. Search and click the relevant adapter. The Adapter Connections page opens displaying the list of configured connections.
  3. To add a new connection, click Add Connection. The Add Connection dialog opens.
  4. See Setting Adapter Connection Parameters for more information, and refer to the specific adapter page for configuration details for each adapter.

Adding a New Adapter Connection From the Connections Page

  1. From the adapters page click Connections to open the Connections page.
  2. Click Add Connection AddConnectionButton.png to add a new adapter connection.
  3. The Add Connection drop down box appears.

AddConnections.png

  1. Click the arrow to select an adapter.

AddconnectionDropDown.png

  1. Click Next.

AddConnectionNExt.png

The Add connection drop down box for the adapter you chose opens.

AddConnectionEG.png

  1. See Setting Adapter Connection Parameters for more information, and refer to the specific adapter page for configuration details for each adapter.

Setting Adapter Connection Parameters

The connections you set in the Adapter Connection parameters dialog are specific for the connection you are currently configuring.
Configure the required settings for each adapter. Refer to the parameters in the documentation for each parameter for more details.
In addition, you can configure the following:

  1. Connection Label (optional, default: empty) - An optional label to help distinguish between multiple connections for the same adapter. This label is concatenated to the relevant Adapter Name in the Device/User Profile page and the full text is visible when you hover over the Adapters column in the Devices/Users pages. It is also possible to query the label in the Query Wizard, otherwise only the adapter name is displayed.

    Note:
    Some adapters require additional steps to gain the relevant connection details, such as generating API keys or other steps. To understand the required actions for connecting each adapter, open its connection documentation page. For more details, see Adapters List on the product documentation and the Adapter Matrix on the Axonius website.
  2. To set the connection as inactive, switch off the Active Connection toggle button.

    • When switched on, the configured connection is considered as active.
      • The connection can be saved and fetch data from its source. Therefore:
        • The Check Network Connectivity button is enabled.
        • The Saved and Fetch button is enabled.
        • During a discovery cycle, data is fetched from the source of this connection.
    • When switched off, the configured connection is considered as inactive:
      • The connection can be saved, but it will not fetch data from its source. Therefore:
        • The Check Network Connectivity button is disabled.
        • The Saved and Fetch button is disabled.
        • During a discovery cycle, this connection will be ignored and no data will be fetched from its source.
  3. To test the network connectivity to the supplied hostname or the IP address, click Check Network Connectivity.

  4. To save the configuration changes and to initiate data fetch from the configured source, click Save and Fetch.

  5. To save the configuration changes without initiating data fetch, click Save.

Once you create a connection, the connection is added to the adapter's connection list and to the Connections page:

  • If the adapter connection is connected successfully, image.png icon is displayed on the adapter connection record.
  • If the connection has an error, error icon image.png appears.
  • If the connection is inactive, inactive icon image.png appears.
Note:
Axonius generates an activity log events and additional Syslog message, HTTPs Log messages and emails, if those are enabled. For details, see Global Settings.

To see the connection error reason and to fix the configuration, on the Adapter page click the connection record to open the Add Connection dialog. Or, on the Connection page click any of the fields except for the Adapter name, see Editing Connection Information

image.png

In addition, you can set various Advanced Settings for each adapter. Refer to Advanced Settings

Notes:
  • Each adapter includes documented connection instructions. To view the instructions, click help ('?').
  • You can connect multiple connections. For example, to connect multiple Microsoft Active Directory (AD) domain controllers, configure a different connection for each domain controller.
  • When the Axonius VM connects to these connections, it must have connectivity to that address, i.e. it must be able to connect to that IP/URL on that port.
  • All fields not marked as 'optional' are mandatory and must be populated.



Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.