Visualization UI

Overview

To access the Interface, you must point your Web Browser to the URL provided during installation.

By default the Visualization Tool is accessible on the dedicated port 7767 (HTTP). For example : http://172.16.1.130:7767

This chapter explain how to configure the Visualization UI

The file /etc/shinken/modules/webui.cfg contains configuration parameters.
you can set
- the HTTPS
- the port
- activated modules
- the language
- ...

HTTPS

The UI can be now protected by an HTTPS access.

In the webui.cfg,

to activate the HTTPS:
- http_use_ssl 0
  - by default it is set to 0.
  - Set it to 1 to activate.
to set certificates by updating the 3 following parameters:
- http_ssl_cert /etc/shinken/certs/server.cert
- http_ssl_key /etc/shinken/certs/server.key

The files default files /etc/shinken/certs/server.cert and /etc/shinken/certs/server.key are just samples that are provided with the installation and MUST be changed by your own certificates.

Accessing to the UI will still use the default dedicated port 7766 (but in HTTPS).

- For example : https://172.16.1.130:7767

You must Sign in to access the Administration Tool :

Enter your Username and Password
Click the Login Button or hit Enter

If Shinken is connected to an active directory, please use your usual active directory account (without the DOMAIN\ part).

You can also use your active dorectory email address as your login.

If an error occurred (wrong login or password), you will be prompted again

Link the Login authentication to an Active Directory Server

Configure the auth_active_directory module

Edit the auth_active_directory.cfg in /etc/shinken/modules:

Property	Example	Description
ldap_uri	ldaps://myserver	The address of the Active Directory server.
user	user	The user name to connect to the lapd server
password	password	The password
DC	DC =google,DC=com	Base OU for the users.

Then activate this module in the webui.cfg file

Edit the webui.cfg file in /etc/shinken/modules

Property	Example	Description
modules	Cfg_password, auth-active-directory, Mongodb, webui-enterprise, sla	By default, auth-active-directory should be present in the line. If missing, add it to activate the module.

It will first try to identify the login/pass provided in the via the active directory module, then check in the synchronizer database, and then reject it if not found or valid.

Page tree