Elasticsearch Node.js client [7.x] » Authentication
«  Breaking changes coming from the old client     Observability  »

Authenticationedit

This document contains code snippets to show you how to connect to various Elasticsearch providers.

Basic Authedit

You can provide your credentials in the node(s) URL.

const { Client } = require('@elastic/elasticsearch')
const client = new Client({
  node: 'https://username:password@localhost:9200'
})

Or you can use the full node declaration.

const { URL } = require('url')
const { Client } = require('@elastic/elasticsearch')
const client = new Client({
  node: {
    url: new URL('https://username:password@localhost:9200'),
    id: 'node-1',
    ...
  }
})

SSL configurationedit

Without any additional configuration you can specify https:// node urls, but the certificates used to sign these requests will not verified (rejectUnauthorized: false). To turn on certificate verification you must specify an ssl object either in the top level config or in each host config object and set rejectUnauthorized: true. The ssl config object can contain many of the same configuration options that tls.connect() accepts.

const { Client } = require('@elastic/elasticsearch')
const client = new Client({
  node: 'http://username:password@localhost:9200',
  ssl: {
    ca: fs.readFileSync('./cacert.pem'),
    rejectUnauthorized: true
  }
})

Elastic Cloudedit

If you are using Elastic Cloud, the client offers a easy way to connect to it via the cloud option. You must pass the Cloud ID that you can find in the cloud console, then your username and password.

Note

When connecting to Elastic Cloud, the client will automatically enable both request and response compression by default, since it yields significant throughput improvements. Moreover, the client will also set the ssl option secureProtocol to TLSv1_2_method unless specified otherwise. You can still override this option by configuring them.

Important

Do not enable sniffing when using Elastic Cloud, since the nodes are behind a load balancer, Elastic Cloud will take care of everything for you.

const { Client } = require('@elastic/elasticsearch')
const client = new Client({
  cloud: {
    id: 'name:bG9jYWxob3N0JGFiY2QkZWZnaA==',
    username: 'elastic',
    password: 'changeme'
  }
})
«  Breaking changes coming from the old client     Observability  »