Grant privileges and roles needed for publishing
editGrant privileges and roles needed for publishing
editUsers who publish events to Elasticsearch need to create and write to Winlogbeat indices. To minimize the privileges required by the writer role, use the setup role to pre-load dependencies. This section assumes that you’ve run the setup.
When using index lifecycle management (ILM), turn off the ILM setup check in the Winlogbeat config file before running Winlogbeat to publish events:
setup.ilm.check_exists: false
To grant the required privileges:
-
Create a writer role, called something like
winlogbeat_writer
, that has the following privileges:The
monitor
cluster privilege and thecreate_doc
andauto_configure
privileges onwinlogbeat-*
indices are required in every configuration.Type Privilege Purpose Cluster
monitor
Retrieve cluster details (e.g. version)
Cluster
read_ilm
Read the ILM policy when connecting to clusters that support ILM. Not needed when
setup.ilm.check_exists
isfalse
.Cluster
read_pipeline
Check for ingest pipelines used by Winlogbeat.
Index
create_doc
onwinlogbeat-*
indicesWrite events into Elasticsearch
Index
auto_configure
onwinlogbeat-*
indicesUpdate the datastream mapping. Consider either disabling entirely or adding the rule
-{beat_default_index_prefix}-*
to the cluster settings action.auto_create_index to prevent unwanted indices creations from the agents.Omit any privileges that aren’t relevant in your environment.
- Assign the writer role to users who will index events into Elasticsearch.