Adapters Page
  • 4 Minutes To Read
  • Print
  • Share
  • Dark
    Light

Adapters Page

  • Print
  • Share
  • Dark
    Light

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 Only toggle button to show only the adapters that have connections configured.

image.png

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

  • Green (along with image.png icon) - all the adapter connections are successfully connected.
  • Orange (along with image.png icon) - there is a connection error in at least one of the configured adapter connection
  • Grey - there are no configured connections for this adapter.

A number to the left of the adapter displays the number of configured connections that:

  • Have been successfully connected - with a green circle above it (image.png).
  • Have connection errors - with a red triangle above it (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 https://docs.axonius.com/docs/en/adapters-list



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:
image.png

Adding a New Adapter Connection

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

image.png

NOTES
  • 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.
Was This Article Helpful?