Elasticsearch
  • 2 Minutes To Read
  • Print
  • Share
  • Dark
    Light

Elasticsearch

  • Print
  • Share
  • Dark
    Light

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) - Specify the port of the Elasticsearch system. The default value is set to 9200.
  3. User Name and Password (optional) - The credentials for a user account that has the permissions to fetch assets.
  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 APU Key can be used instead of user name and password. For details see Elasticsearch Create API Key.
  5. Data Streams Search Target (optional, default: empty) - 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 (required, default: False) - Verify the SSL certificate offered by the value supplied in Host Name or IP Address. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in Host Name or IP Address will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in Host Name or IP Address will not be verified against the CA database inside of Axonius.
  7. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Host Name or IP Address.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Host Name or IP Address.
    • If not supplied, Axonius will connect directly to the value supplied in Host Name or IP Address.
  8. HTTPS Proxy User Name (optional, default: empty) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.
    • If supplied, Axonius will authenticate with this value when connecting to the value supplied in HTTPS Proxy.
    • If not supplied, Axonius will not perform authentication when connecting to the value supplied in HTTPS Proxy.
  9. HTTPS Proxy Password (optional, default: empty) - The password to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.
    • If supplied, Axonius will authenticate with this value when connecting to the value supplied in HTTPS Proxy.
    • If not supplied, Axonius will not perform authentication when connecting to the value supplied in HTTPS Proxy.
  10. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png


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


Was This Article Helpful?