The Notification Service allows to display all notifications in a central place in the frontend. All OpenSight backend services can use it to send notifications to the user.
The Notification Service is intended to be deployed along the others openSight services on the appliance. The service provides a REST API. See the OpenApi definition for details. You can view them e.g. in the Swagger Editor.
Backend services can send notifications via the Create Notification endpoint. Those notifications can then be retrieved via List Notifications to provide them to the user.
To run the service and its dependencies on your local machine you need a working installation of docker and make.
For running the Notification Service outside of docker the latest version of go must be installed.
The service is configured via environment variables. Refer to the Config for the available options and their defaults.
The secret DB_PASSWORD can be also passed by file. Simply pass the path to the file containing the secret to the service by appending _FILE to the env var name, i.e. DB_PASSWORD_FILE. If the secret is supplied in both ways, the one directly passed by env var takes precedence.
The following instructions are targeted at openSight developers. As end user the services should be run in orchestration with the other openSight services, which is not in the scope of this readme.
Before starting the services you need to set the environment variable DB_PASSWORD for the database password. This password is set (only) on the first start of the database, so make sure to use the same password on consecutive runs. All other configuration parameters are already set in the docker compose files.
Then you can start the notification service and the required dependent service Postgres with
# make sure the `DB_PASSWORD` environment variable is set
make start-servicesThe port of the notification service is forwarded, so you can access its API directly from the host machine at the base url http://localhost:8085/api/notification-service. A convenient way to interact with the service are the Swagger docs served by the running service at URL http://localhost:8085/docs/notification-service/notification-service/index.html.
If you are actively developing it might be more convenient to run the notification service directly on the host machine.
First start the containerized database with
docker compose up -dThen load the configuration parameters into environment variables and start the notification service:
# make sure the `DB_PASSWORD` environment variable is set beforehand
source set_env_vars_local_setup.sh && go run ./cmd/notification-serviceFrom here everything is identical to the docker compose setup.
If there are errors regarding the database, verify that it is running with docker ps (should show a running container for postgres).
Refer to Makefile to get an overview of all commands
To build run make build. To run the unit tests run make test. The rest API docs can be generated with make api-docs.
This project is maintained by Greenbone AG
Copyright (C) 2024 Greenbone AG
Licensed under the GNU Affero General Public License v3.0 or later.