Grant users access to Winlogbeat indices

edit

To enable users to access the indices Winlogbeat creates, grant them read and view_index_metadata privileges on the Winlogbeat indices. If they’re using Kibana, they also need the kibana_user role.

  1. Create a reader role that has the read and view_index_metadata privileges on the Winlogbeat indices.

    You can create roles from the Management > Roles UI in Kibana or through the role API. For example, the following request creates a role named winlogbeat_reader:

    POST _xpack/security/role/winlogbeat_reader
    {
      "indices": [
        {
          "names": [ "winlogbeat-*" ], 
          "privileges": ["read","view_index_metadata"]
        }
      ]
    }

    If you use a custom Winlogbeat index pattern, specify that pattern instead of the default winlogbeat-* pattern.

  2. Assign your users the reader role so they can access the Winlogbeat indices. For Kibana users who need to visualize the data, also assign the kibana_user role:

    1. If you’re using the native realm, you can assign roles with the Management > Users UI in Kibana or through the user API. For example, the following request grants winlogbeat_user the winlogbeat_reader and kibana_user roles:

      POST /_xpack/security/user/winlogbeat_user
      {
        "password" : "YOUR_PASSWORD",
        "roles" : [ "winlogbeat_reader","kibana_user"],
        "full_name" : "Winlogbeat User"
      }
    2. If you’re using the LDAP, Active Directory, or PKI realms, you assign the roles in the role_mapping.yml configuration file. For example, the following snippet grants Winlogbeat User the winlogbeat_reader and kibana_user roles:

      winlogbeat_reader:
        - "cn=Winlogbeat User,dc=example,dc=com"
      kibana_user:
        - "cn=Winlogbeat User,dc=example,dc=com"

      For more information, see Using Role Mapping Files.