Adapters Page
  • 6 Minutes To Read
  • Print
  • Share
  • Dark

Adapters Page

  • Print
  • Share
  • Dark

The Adapters page displays the list of the solutions Axonius integrates with, called adapters.

To open the Adapters page, click the image.png icon on the left navigation panel.

You can toggle between viewing all available adapters and the adapters that have connections configured. Click the Configured adapters toggle button to display only the adapters that have connections configured.


Each adapter entry includes the adapter name, logo and description, and each record is highlighted in one of the following colors:

  • Green - all the adapter connections for this adapter are successfully connected.
  • Red - there is a connection error in at least one of the configured adapter connections for this adapter.
  • Dark grey - there are only inactive connection for this adapter.
  • Light grey - there are no configured connections for this adapter.

The Connection Status column displays the number of configured connections that:

  • Have been successfully connected (image.png).
  • Have connection errors (image.png)
  • Have set as inactive connection (image.png)

Connecting adapters enable Axonius to pull assets information from many sources across the organization. The more adapters you connect, the more comprehensive your asset inventory will be. It is recommended you will connect any of the following to Axonius adapters:

To see a full list of supported adapters, visit

To connect a new adapter, please provide the needed access credentials. The details will vary by adapter, but will include some combination of:

  1. IP Addresses
  2. User Names
  3. Passwords
  4. API keys
  5. Key Files
  6. Any other credentials needed to access the adapters being used

For example, the Amazon Web Services (AWS) adapter configuration dialog:

Adding a New Adapter Connection


For Axonius-as-a-Service customers only:

  • The Axonius-as-a-Service 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 to establish a link between an internal network and the Axonius-as-a-Service instance.
  • Axonius Tunnel is only required to connect adapters their sources are only accessible by an internal network.
  • Axonius Tunnel is not required to connect adapters their 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.

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. Specify the required information, including the following common parameters:
    • Choose Instance (required for a multi-node environment, default: 'Master') - The Axonius node to utilize when connecting to the specified adapter host. For more details, see Connecting Additional Axonius Nodes.

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

      • If supplied, the label will be appended to the adapter name. You will also be able to query the label in the Query Wizard.
      • If not supplied, only the adapter name will be displayed.
      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.
  5. To set the connection as inactive, switch off the Active Connection toggle button.
    • If switched on, the configured connection will be considered as active.
      • The connection can be saved and fetch data from its source. Therefore:
        • The Check Network Connectivity button will be enabled.
        • The Saved and Fetch button will be enabled.
        • During a discovery cycle, data will be fetched from the source of this connection.
    • If switched off, the configured connection will be considered as inactive:
      • The connection can be saved, but it will not fetch data from its source. Therefore:
        • The Check Network Connectivity button will be disabled.
        • The Saved and Fetch button will be disabled.
        • During a discovery cycle, this connection will be ignored and no data will be fetched from its source.
  6. To test the network connectivity to the supplied hostname or the IP address, click Check Network Connectivity.
  7. To save the configuration changes and to initiate data fetch from the configured source, click Save and Fetch.
  8. To save the configuration changes without initiating data fetch, click Save.

As a result, the connection will be added to the adapter's connection list:

  • If the adapter connection is connected successfully, image.png icon is displayed on the adapter connection record.
  • If the connection has errir, error icon image.png appears.
  • If the connection is inactive, inactive icon image.png appears.
Axonius generates a 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, open the Add Connection dialog, by clicking the connection record.


  • Each adapter includes documented connection instructions. To view such instructions, click the help ('?') button.
  • 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
  • In addition to the adapter connection configuration settings, each adapter has 'Advanced Settings' used to support your use of Axonius. For more details, see Adapter Advanced Settings.

Override Advanced Settings Values

The Actions menu on the top right of the Adapters table, lets you take various actions on all Adapters.
The Override Advanced Settings Values action enables you to override Adapter Advanced Settings values for all adapters or for adapters without configured connections.


To modify the advanced settings for a single adpater. Click on the relevant adapter and then on Advanced Settings.

In the Override Advances Settings Values modal, select the settings you want to override by checking the relevant checkboxes and setting the required value in the corresponding input fields.
Then select whether to apply these new values to all adapters or only to adapters without configured connections.

Adapters Fetch History

The Adapters Fetch History button displays the fetch results over time for each adapter and for specific adapter connections.

Was This Article Helpful?