Adding a New Adapter Connection
  • 10 Mar 2024
  • 5 Minutes to read
  • Dark
    Light
  • PDF

Adding a New Adapter Connection

  • Dark
    Light
  • PDF

Article Summary

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 drawer 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. In the left navigation panel, click the image.png icon. The Adapters page opens.

  2. Hover over the adapter tile and from the 3-dot menu choose Add Connection, or click on the adapter tile.

    AddConnectionMa

  3. The Adapter Profile page opens displaying the list of configured connections for that adapter (if connections are already configured.

AWSPRofileNew

  1. Click Add Connection. The Add Connection drawer opens.
  2. 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. On the adapters page, click Adapter Connections. The Connections page opens.
  2. Click Add Connection AddConnectionButton.png to add a new adapter connection.
  3. The Add Connection drop down box appears.

AddConnectionsNew

  1. Click the arrow to select an adapter.

AddconnectionDropDown.png

  1. Click Next.

AddConnectionNExt.png

The Add Connection drawer for the adapter you chose opens.

AWSEG1

  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 drawer 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 Asset Profile page and the full text is visible when you hover over the Adapters column in the assets pages. It is also possible to query the connection 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 list on the Axonius website.
  2. Add Note - add a note of up to 50 characters for this adapter connection.

  3. The Active Connection toggle button is set to on by default and when switched on, the configured connection is considered as active.

    • The connection can be saved and fetch data from its source. Therefore once you fill in all the required parameters on the Connection Configuration drawer:
      • The Check Network Connectivity button is enabled.
      • The Save and Fetch button is enabled.
      • During a discovery cycle, data is fetched from the source of this connection.
  4. To set the connection as inactive, switch off the Active Connection toggle button. 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 Save and Fetch button is disabled
      • During a discovery cycle, this connection will be ignored and no data will be fetched from its source, but all your settings are saved.
  5. To test the network connectivity to the supplied hostname or IP address, click Check Network Connectivity.

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

  7. 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 activity log events, and additional Syslog messages, HTTPs Log messages, and emails, if those are enabled. For details, see Managing External Integrations.

To see the connection error reason and to fix the configuration, on the Adapter page click the connection record to open the Add Connection drawer. 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.

Connecting your SSO Solution Provider

Single Sign-On (SSO) solutions such as Okta, Microsoft Entra ID (Azure AD) and others, provide authentication and access management capabilities that enable organizations to ensure secure access to all corporate accounts, whilst providing visibility into this access at a granular per-user-level.

Axonius SaaS Management leverages the data fetched from an adapter that is configured as an 'SSO Provider' as part of its logic to determine managed and unmanaged applications and users.

When connecting an adapter that is used as your organization's SSO solution, the SSO provider option should be switched on.



Was this article helpful?

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.