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 - the adapter is not connected

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, including:

Agents
Agent adapters provide Axonius with the data to determine whether devices are being managed according to policy. Agents include:

  • IT Agents - such as Tanium and IBM BigFix.
  • Endpoint Protection Platform (EPP) agents - such as CylancePROTECT, Carbon Black CB Defense/Protection/Response, Symantec Endpoint Protection and McAfee ePolicy Orchestrator (ePO)
  • Configuration/Patch Management solutions - such as Chef and Puppet.

Identity Managment
Identity adapters provide Axonius the data for the identities used in the organization, examples are Microsoft Active Directory (AD) and Okta.

Networking
Networking adapters provide Axonius with data on devices connecting through the networks, identifying the networking location of devices and discovering unmanaged devices.
Some networking adapters connect directly to switches, such as Cisco, Juniper Junos, Aruba and Fortinet Fortigate. Others connect to a networking management solution like Cisco Prime, Infoblox DDI and RedSeal.

Vulnerability Assessment Solutions
Vulnerability assessment solutions, such as Tenable.io, Qualys Cloud Platform and Rapid7 Nexpose are also part of the networking view.

Virtualization and Cloud
Virtualization and Cloud adapters provide Axonius with data on the virtual assets in the environment:

  • Local virtualization systems - such as VMWare ESXi and Microsoft Hyper-V.
  • Public cloud environments like Amazon Web Services (AWS) and Microsoft Azure.
NOTE
To achieve a comprehensive and continuous asset inventory, connect as many adapters as possible, with at least one connected adapter from each of the categories listed above.

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. Key Files
  5. Any other credentials needed to access the adapters being used

For example, the Amazon Web Services (AWS) adapter configuration page:
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 Adapter Connection Configuration modal opens.
  4. Populate 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 test the reachability of the configured domain or IP address, click Test Reachability.
  6. To save your changes and to establish a connection to the adapter connection using the configured credentials, click Save and Connect.

As a result, the connection will be established and the adapter will start collecting data.

If the adapter connection is connected successfully, image.png icon is displayed on the adapter connection record.
If the connection has failed, error icon image.png appears.

NOTE
Axonius generates a system notification 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 image.png
  • 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?