Gullveig

Gullveig

  • Documentation
  • GitHub

›Configuration

Overview

  • Overview
  • Web UI
  • Roadmap

Features

  • Monitoring
  • Metadata
  • Knowledge base

Setup

  • Getting started
  • Requirements
  • Security
  • Network
  • Installation
  • Server setup
  • Web setup
  • Agent setup
  • Upgrading

Configuration

  • Configuration
  • agent.conf
  • server.conf
  • web.conf

Alerting

  • Alerting

Modules

  • Overview
  • mod_apt
  • mod_collectd
  • mod_facter
  • mod_fs
  • mod_lwall
  • mod_osquery
  • mod_pkg
  • mod_res
  • mod_systemd

Advanced

  • Reporting
  • Monitoring
  • Extending Gullveig
  • Server database

web.conf

Gullveig web user interface configuration reference.

Section [web]

bind_to

Default value: 127.0.0.1

Network interface to bind the web server to. This should most likely be changed during installation. Value defaults to loopback interface to prevent accidentally exposing the server to WAN.

bind_port

Default value: 8770

Network port to expose the server for on. Only agents will use this port to connect to the server.

ssl_certificate

Default value: none

Web server TLS certificate. Make sure this certificate is different from the one used for reporting server.

ssl_certificate_key

Default value: none

Web server TLS key. Make sure this certificate is different from the one used for reporting server.

secret

Default value: none

Signing key for authentication tokens. Should be a random string token with the minimum length of 128 bits.

This value should be kept secret (no pun intended) and random. Knowing this value will allow for anyone to forge user credentials and allow access to the web interface.

Section [server]

data_dir

Default value: /var/lib/gullveig/

Server data directory to look for the server database.

Section [users]

User section contains a list of users, as username password pairs, authorized to access the web interface.

Passwords are in shadow compatible format. Commands, such as mkpasswd --method=SHA-512 --stdin can be used to hash the user password.

Example:

[users]

# admin:admin
admin = $6$tKs0/AQLUERKxY$L/YoYlvSvU0U4n6q8q6ZWnlfTdR6tK3feDwJJRHsGWd19sXOLdFxyILG2wvXMxcxd2RwoDmtvQCTNzlUTVsna1

Section [kb]

Configure knowledge base.

path

Default value: /var/lib/gullveig/kb/

Directory to look for knowledge base contents.

Last updated on 9/26/2020
← server.confAlerting →
  • Section [web]
    • bind_to
    • bind_port
    • ssl_certificate
    • ssl_certificate_key
    • secret
  • Section [server]
    • data_dir
  • Section [users]
  • Section [kb]
    • path
Gullveig
Documentation
OverviewWeb UISetupConfiguration
More
GitHubStar
Copyright © 2021 Matīss Treinis