2018-04-20 21:13:37 +02:00
|
|
|
[role="xpack"]
|
|
|
|
[[graph-configuration]]
|
2020-06-10 16:20:55 +02:00
|
|
|
== Configure Graph
|
2018-04-20 21:13:37 +02:00
|
|
|
|
|
|
|
When a user saves a graph workspace in Kibana, it is stored in the `.kibana`
|
|
|
|
index along with other saved objects like visualizations and dashboards.
|
|
|
|
By default, both the configuration and data are saved for the workspace:
|
|
|
|
|
|
|
|
[horizontal]
|
|
|
|
*configuration*::
|
|
|
|
The selected index pattern, fields, colors, icons,
|
|
|
|
and settings.
|
|
|
|
*data*::
|
|
|
|
The visualized content (the vertices and connections displayed in
|
|
|
|
the workspace).
|
|
|
|
|
|
|
|
The data in a saved workspace is like a report--it is a saved snapshot that
|
|
|
|
potentially summarizes millions of raw documents. Once saved, these summaries
|
|
|
|
are no longer controlled by security policies. Because the original documents
|
|
|
|
might be deleted after a workspace is saved, there's no practical basis for
|
|
|
|
checking permissions for the data in a saved workspace.
|
|
|
|
|
|
|
|
For this reason, you can configure the save policy for graph workspaces to
|
2019-06-06 17:08:18 +02:00
|
|
|
ensure appropriate handling of your data. You can allow all users to save
|
|
|
|
only the configuration information for a graph, require all users to
|
2018-04-20 21:13:37 +02:00
|
|
|
explicitly include the workspace data, or completely disable the ability
|
|
|
|
to save a workspace.
|
|
|
|
|
|
|
|
For example, to disable the save option entirely, set
|
|
|
|
`xpack.graph.savePolicy` to `none` in `kibana.yml`:
|
|
|
|
|
|
|
|
[source,yaml]
|
|
|
|
--------------------------------------------------
|
|
|
|
xpack.graph.savePolicy: none
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
The supported save policies are:
|
|
|
|
|
|
|
|
`none`::
|
|
|
|
Neither the configuration or data can be saved.
|
|
|
|
`config`::
|
|
|
|
Only the configuration is saved.
|
|
|
|
`configAndData`::
|
|
|
|
Both configuration and data are saved. This is the
|
|
|
|
default policy.
|
|
|
|
`configAndDataWithConsent`::
|
|
|
|
Only the configuration is saved unless the user
|
|
|
|
explicitly selects the include data option.
|
|
|
|
|
2019-06-06 17:08:18 +02:00
|
|
|
[float]
|
2020-06-10 16:20:55 +02:00
|
|
|
=== Use Security to grant access
|
2019-06-06 17:08:18 +02:00
|
|
|
You can also use security to grant read only or all access to different roles.
|
|
|
|
When security is used to grant read only access, the following indicator in Kibana
|
2019-09-13 16:44:01 +02:00
|
|
|
is displayed. For more information on granting access to Kibana, see
|
2019-06-06 17:08:18 +02:00
|
|
|
<<xpack-security-authorization>>.
|
|
|
|
|
|
|
|
[role="screenshot"]
|
2019-09-13 19:10:32 +02:00
|
|
|
image::user/graph/images/graph-read-only-badge.png[Example of Graph's read only access indicator in Kibana's header]
|
2019-06-06 17:08:18 +02:00
|
|
|
|
2019-10-31 20:18:07 +01:00
|
|
|
[discrete]
|
2018-04-20 21:13:37 +02:00
|
|
|
[[disable-drill-down]]
|
2020-06-10 16:20:55 +02:00
|
|
|
=== Disable drilldown configuration
|
2018-04-20 21:13:37 +02:00
|
|
|
|
2019-11-14 15:41:23 +01:00
|
|
|
By default, users can configure _drilldown_ URLs to display additional
|
2018-04-20 21:13:37 +02:00
|
|
|
information about a selected vertex in a new browser window. For example,
|
2019-11-14 15:41:23 +01:00
|
|
|
you could configure a drilldown URL to perform a web search for the selected
|
2018-04-20 21:13:37 +02:00
|
|
|
vertex term.
|
|
|
|
|
2019-11-14 15:41:23 +01:00
|
|
|
To prevent users from adding drilldown URLs, set
|
2018-04-20 21:13:37 +02:00
|
|
|
`xpack.graph.canEditDrillDownUrls` to `false` in `kibana.yml`:
|
|
|
|
|
|
|
|
[source,yaml]
|
|
|
|
--------------------------------------------------
|
|
|
|
xpack.graph.canEditDrillDownUrls: false
|
|
|
|
--------------------------------------------------
|