Greenbone Source Edition for Gentoo/Linux

This is not official Gentoo/Linux repository.

You can find official Gentoo/Linux package: https://packages.gentoo.org/packages/net-analyzer/gvm

What is GSE

Greenbone Source Edition (GSE) is vulnerability management platform including a network security scanner with associated tools like a graphical user front-end. The core component is a server with a set of network vulnerability tests (NVTs) to detect security problems in remote systems and applications.

GSE was previously known as Open Vulnerability Assessment System (OpenVAS).

Usage

via local overlays

Copy greenbone-source-edition-overlay.conf from this repository into /etc/portage/repos.conf/ to use the portage sync capabilities.

Then run:

emerge --sync # or eix-sync or emaint -a sync
emerge --ask net-analyzer/gse-21.4.1[openvas,gsa,cron,extras,-ldap,-radius]

via layman

layman -o https://raw.github.com/vulnbe/greenbone-source-edition-overlay/master/repositories.xml -f -a greenbone-source-edition-overlay

Then run:

layman -s greenbone-source-edition-overlay

Use Flags

gsa - Greenbone Security Assistant (WebUI)
openvas - OSPD OpenVAS scanner
cron - A cron job to update GSE's vulnerability feeds daily
extras - Extra fonts, pdf-results! and html docs support
ldap - LDAP support
radius - Radius support

Certificates provision

sudo -u gvm gvm-manage-certs -a

PostgreSQL initialization and configuration

emerge --config dev-db/postgresql:12

sudo -u postgres bash -c "createuser -DRS gvm; createdb -O gvm gvmd"
sudo -u postgres psql gvmd -c 'create role dba with superuser noinherit; grant dba to gvm; create extension "uuid-ossp"; create extension "pgcrypto"; create extension "pg-gvm";'

sudo -u gvm greenbone-feed-sync --type GVMD_DATA
sudo -u gvm greenbone-feed-sync --type SCAP
sudo -u gvm greenbone-feed-sync --type CERT

Scanner configuration

Update scanner socket path

sudo -u gvm gvmd --get-scanners
sudo -u gvm gvmd --modify-scanner=08b69003-5fc2-4037-a479-93b440211c73 --scanner-host /var/run/gvm/ospd-openvas.sock
sudo -u gvm gvmd --verify-scanner=08b69003-5fc2-4037-a479-93b440211c73

Add osp scanner

sudo -u gvm gvmd --create-scanner="OSP Scanner" --scanner-host=127.0.0.1 --scanner-port=9391 \
    --scanner-type="OSP" --scanner-ca-pub=/var/lib/gvm/CA/cacert.pem \
    --scanner-key-pub=/var/lib/gvm/CA/clientcert.pem \
    --scanner-key-priv=/var/lib/gvm/private/CA/clientkey.pem

User management

sudo -u gvm gvmd --create-user=admin --password=admin"

Feed import owner configuration

sudo -u gvm gvmd --get-users --verbose
sudo -u gvm gvmd --modify-setting 78eceaec-3385-11ea-b237-28d24461215b --value UUID

Issues

Unable to connect to redis

review redis socket permissions (must be 770)

GVM stucks on NVT cache update

psql -q --pset pager=off gvmd -c "DELETE FROM meta where name = 'nvts_feed_version' OR name = 'nvts_check_time';"

Cache corruption

redis-cli -s /tmp/redis.sock FLUSHALL

Migration guide

Dump the database: sudo -u postgres pg_dump -O gvmd > /tmp/gvmd_dump.sql
Copy dump file and content of /var/lib/{gvm,openvas} and /usr/share/{gvm,openvas} to new host;
Create an empty gvmd database with the required extensions:

sudo -u postgres bash -c "createuser -DRS gvm; createdb -O gvm gvmd";
sudo -u postgres psql gvmd -c 'create role dba with superuser noinherit; grant dba to gvm;'
sudo -u postgres psql gvmd -c 'alter role gvm superuser;'
sudo -u gvm psql gvmd -c 'create extension "uuid-ossp"; create extension "pgcrypto";'

Import DB as gvm user:

sudo -u gvm psql -d gvmd -f tmp/gvmd_dump.sql;
sudo -u postgres psql gvmd -c 'alter role gvm nosuperuser;'

If you are also upgrading gvm, make sure you run sudo -u gvm gvmd -m
If you get errors like gvmd: database is wrong version, you should run sudo -u gvm -- gvmd --migrate

vulnbe/greenbone-source-edition-overlay