mirror of
https://github.com/elastic/kibana.git
synced 2025-04-24 09:48:58 -04:00
9bb2343c53
* [skip-ci][Maps] Connecting to Elastic Maps Service from an internal network documenation * use ascii docs list format * review feedback
38 lines
1.7 KiB
Text
38 lines
1.7 KiB
Text
[role="xpack"]
|
|
[[maps-connect-to-ems]]
|
|
== Connecting to Elastic Maps Service
|
|
|
|
https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] is a service that hosts
|
|
tile layers and vector shapes of administrative boundaries.
|
|
If you are using Kibana's out-of-the-box settings, **Elastic Maps** is already configured to use EMS.
|
|
|
|
EMS requests are made to the following domains:
|
|
|
|
* catalogue.maps.elastic.co
|
|
* tiles.maps.elastic.co
|
|
* vector.maps.elastic.co
|
|
|
|
**Elastic Maps** makes requests directly from the browser to EMS.
|
|
|
|
[float]
|
|
=== Connect to Elastic Maps Service from an internal network
|
|
|
|
To connect to EMS when your Kibana server and browser are in an internal network:
|
|
|
|
. Set `map.proxyElasticMapsServiceInMaps` to `true` in your <<settings, kibana.yml>> file to proxy EMS requests through the Kibana server.
|
|
. Update your firewall rules to whitelist connections from your Kibana server to the EMS domains listed above.
|
|
|
|
NOTE: Coordinate map and region map visualizations do not support `map.proxyElasticMapsServiceInMaps` and will not proxy EMS requests through the Kibana server.
|
|
|
|
|
|
[float]
|
|
=== Disable Elastic Maps Service
|
|
|
|
You might experience EMS connection issues if your Kibana server or browser are on a private network or
|
|
behind a firewall. If this happens, you can disable the EMS connection to avoid unnecessary EMS requests.
|
|
|
|
To disable EMS, change your <<settings, kibana.yml>> file.
|
|
|
|
. Set `map.includeElasticMapsService` to `false` to turn off the EMS connection.
|
|
. Set `map.tilemap.url` to the URL of your tile server. This configures the default tile layer of **Elastic Maps**.
|
|
. (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use.
|