2018-01-12 14:35:16 -05:00
|
|
|
[role="xpack"]
|
2017-04-06 21:29:29 -04:00
|
|
|
[[separating-node-client-traffic]]
|
|
|
|
=== Separating node-to-node and client traffic
|
|
|
|
|
2019-07-03 05:31:55 -04:00
|
|
|
deprecated[7.3.0, Transport Client is deprecated and will be removed]
|
|
|
|
|
2018-12-19 18:28:25 -05:00
|
|
|
Elasticsearch has the feature of so called
|
|
|
|
{ref}/modules-transport.html[TCP transport profiles]
|
|
|
|
that allows it to bind to several ports and addresses. The {es}
|
|
|
|
{security-features} extend on this functionality to enhance the security of the
|
|
|
|
cluster by enabling the separation of node-to-node transport traffic from client
|
|
|
|
transport traffic. This is important if the client transport traffic is not
|
|
|
|
trusted and could potentially be malicious. To separate the node-to-node traffic
|
|
|
|
from the client traffic, add the following to `elasticsearch.yml`:
|
2017-04-06 21:29:29 -04:00
|
|
|
|
|
|
|
[source, yaml]
|
|
|
|
--------------------------------------------------
|
|
|
|
transport.profiles.client: <1>
|
|
|
|
port: 9500-9600 <2>
|
2017-07-06 23:33:35 -04:00
|
|
|
xpack.security:
|
2017-04-06 21:29:29 -04:00
|
|
|
type: client <3>
|
|
|
|
--------------------------------------------------
|
|
|
|
<1> `client` is the name of this example profile
|
|
|
|
<2> The port range that will be used by transport clients to communicate with
|
|
|
|
this cluster
|
|
|
|
<3> Categorizes the profile as a `client`. This accounts for additional security
|
|
|
|
filters by denying request attempts on for internal cluster operations
|
|
|
|
(e.g shard level actions and ping requests) from this profile.
|
|
|
|
|
|
|
|
If supported by your environment, an internal network can be used for node-to-node
|
|
|
|
traffic and public network can be used for client traffic by adding the following
|
|
|
|
to `elasticsearch.yml`:
|
|
|
|
|
|
|
|
[source, yaml]
|
|
|
|
--------------------------------------------------
|
|
|
|
transport.profiles.default.bind_host: 10.0.0.1 <1>
|
|
|
|
transport.profiles.client.bind_host: 1.1.1.1 <2>
|
|
|
|
--------------------------------------------------
|
|
|
|
<1> The bind address for the network that will be used for node-to-node communication
|
|
|
|
<2> The bind address for the network used for client communication
|
|
|
|
|
2018-01-12 14:35:16 -05:00
|
|
|
If separate networks are not available, then
|
2019-12-20 13:01:19 -05:00
|
|
|
{ref}/ip-filtering.html[IP Filtering] can
|
2017-04-06 21:29:29 -04:00
|
|
|
be enabled to limit access to the profiles.
|
|
|
|
|
|
|
|
When using SSL for transport, a different set of certificates can also be used
|
|
|
|
for the client traffic by adding the following to `elasticsearch.yml`:
|
|
|
|
|
|
|
|
[source, yaml]
|
|
|
|
--------------------------------------------------
|
|
|
|
transport.profiles.client.xpack.security.ssl.truststore:
|
|
|
|
path: /path/to/another/truststore
|
2017-06-29 16:27:57 -04:00
|
|
|
password: x-pack-test-password
|
2017-04-06 21:29:29 -04:00
|
|
|
|
|
|
|
transport.profiles.client.xpack.security.ssl.keystore:
|
|
|
|
path: /path/to/another/keystore
|
2017-06-29 16:27:57 -04:00
|
|
|
password: x-pack-test-password
|
2017-04-06 21:29:29 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
To change the default behavior that requires certificates for transport clients,
|
|
|
|
set the following value in the `elasticsearch.yml` file:
|
|
|
|
|
|
|
|
[source, yaml]
|
|
|
|
--------------------------------------------------
|
2017-11-22 12:09:06 -05:00
|
|
|
transport.profiles.client.xpack.security.ssl.client_authentication: none
|
2017-04-06 21:29:29 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
This setting keeps certificate authentication active for node-to-node traffic,
|
|
|
|
but removes the requirement to distribute a signed certificate to transport
|
2018-01-12 14:35:16 -05:00
|
|
|
clients. For more information, see
|
2019-12-20 13:01:19 -05:00
|
|
|
{ref}/java-clients.html#transport-client[Configuring the Transport Client to work with a Secured Cluster].
|