Elasticsearch
  • 19 Dec 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Elasticsearch

  • Dark
    Light
  • PDF

The Elasticsearch adapter imports device information from an Elasticsearch database.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices

Parameters

  1. Host Name or IP Address (required) - The hostname or IP address of the Elasticsearch server that Axonius can communicate with.

  2. Port (required, default: 9200) - Specify the port of the Elasticsearch system.

  3. User Name and Password (optional) - The credentials for a user account that has the permissions to fetch assets.

    Note:

    When API Key ID and API Key are not supplied, User Name and Password are required.

  4. API Key ID and API Key (optional) - An API Key ID and API key associated with a user account that has the permissions to fetch assets. API Key ID and API Key can be used instead of user name and password. For details see Elasticsearch Create API Key.

    Note:

    When User Name and Password are not supplied, API Key ID and API Key are required.

  5. Data Streams Search Target (optional) - The target path search to fetch from.

    • If supplied, Axonius will fetch the data from the defined list. The list should be passed in a comma-separated, listing data streams, indices and index aliases. Elastic wildcard (*) expressions are supported.
    • If not supplied, all data will be fetched.
  6. Verify SSL - Select whether to verify the SSL certificate offered by the value supplied in Host Name or IP Address. For more details, see SSL Trust & CA Settings.

  7. HTTPS Proxy (optional) - A proxy to use when connecting to the value supplied in Host Name or IP Address.

  8. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

  9. HTTPS Proxy Password (optional) - The password to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

  10. To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png


Note:

Axonus fetches data structured in the Elastic Common Schema that has some of the Host fields listed in the Host Structure. Refer to:

Advanced Settings

Note:

From Version 4.6, Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters.

  1. Hour range filter (required, default: 10) - Inspect all logs within the last specified hours and extract devices from all data received. Minimum value is 1; Maximum value is 72.
  2. Fetch devices without hostname - Select whether to fetch devices from Elasticsearch that do not have a hostname.


Note:

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.


APIs

Axonius uses the Elasticsearch 7.10 API.

Version Matrix

This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

Version Supported Notes
Elasticsearch 7.10 Yes



What's Next
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.