Guide de SKOOR Dashboard Viewer

Introduction

Ce guide couvre l'installation du SKOOR Dashboard Viewer. Pour l'installation de SKOOR Engine ou de Redhat, veuillez consulter le guide d'installation de SKOOR Engine. Pour plus d'informations sur l'architecture des composants Dashboard, veuillez consulter la page Composants dans la section architecture de ce guide.

Prérequis

Matériel

Système Dashboard Viewer

Le Viewer Service fonctionne sur une petite machine. 2 Go de RAM et 2 cœurs CPU suffiront.

Système Dashboard Provider

En règle générale, le service Dashboard Provider est installé sur la machine server SKOOR Engine. Si cette machine a été dimensionnée avec une certaine marge, ce composant devrait fonctionner correctement sur le même système. De plus, dans la plupart des cas, un composant Dashboards présentant les mêmes prérequis est déjà installé.

Logiciel

Système Dashboard Viewer

Le Dashboard Viewer nécessite le server apache httpd avec mod_ssl. Veuillez installer les RPM correspondants depuis les dépôts et démarrer le server :

$ sudo yum install httpd mod_ssl
$ sudo /sbin/service httpd start

Configurez httpd pour qu'il démarre lors du démarrage du système :

$ sudo systemctl enable httpd

Configurez firewalld :

$ sudo firewall-cmd --add-port=443/tcp --permanent
$ sudo firewall-cmd --reload

Avant d'installer les composants SKOOR, SELINUX doit être désactivé :

# vi /etc/selinux/config
SELINUX=permissive

# setenforce 0
#
# sestatus
...
Current mode:                 permissive
...

Enfin, le Dashboard Viewer a besoin d'un Dashboard Provider qui l'alimente en données provenant de SKOOR Webservice.

Système Dashboard Provider

Les composants SKOOR suivants doivent être installés sur le système sur lequel le Dashboard Provider sera installé :

De plus, bien entendu, une instance de SKOOR Engine doit être disponible.

Installation

Système Dashboard Viewer

Installez depuis le dépôt RPM SKOOR à l'aide de yum :

sudo yum install eranger-nodejs eranger-dashboard-viewer-service eranger-doc

Pour configurer le Dashboard Viewer, ouvrez le fichier /etc/opt/eranger/eranger-dashboard-viewer-service.json.

Exemple :

{
  "port": 8092,
  "presharedKey": "1234567890",
  "logLevel": "debug",
  "defaultUsername": "dashboard-user",
  "defaultPassword": "dashboard-user"
}


Paramètre

Description

port

Le port TCP sur lequel le service est accessible localement par le server web

presharedKey

Cette clé doit être partagée entre le Dashboard Provider et le Dashboard Viewer Service. Pour des raisons de sécurité, elle doit être remplacée par une valeur unique.

logLevel

Définissez ce paramètre sur l'une des valeurs suivantes : debug, info, warn, error

defaultUsername

Les dashboards peuvent être affichés avec ou sans connexion utilisateur. Un utilisateur et un mot de passe doivent être définis pour afficher le dashboard en tant qu'utilisateur anonyme. S'ils sont omis, le Dashboard Viewer ne peut pas être utilisé sans connexion. Ce paramètre doit être configuré avec un utilisateur en lecture seule de SKOOR Engine.

Veuillez noter que le même utilisateur par défaut doit être configuré dans tous les SKOOR Engines qui fournissent des données à ce viewer.

defaultPassword

Associé à defaultUsername, ce mot de passe est utilisé pour authentifier l'utilisateur configuré avec defaultUsername


Vérifiez l'état du Dashboard Viewer en demandant l'URL suivante à l'aide d'un navigateur :

https://<viewer server name>/skoor-dashboard-viewer-service/status

La sortie doit se présenter comme suit :

{"status":"ok"}


En supposant que le Dashboard Viewer doive être accessible sous son propre FQDN dédié, par exemple hostname.domain.com, configurez la redirection directement vers la page principale du Dashboard Viewer en ajoutant les lignes suivantes dans le fichier de configuration SSL d'apache /etc/httpd/conf.d/ssl.conf (dans le bloc <VirtualHost *:443> existant) :

<VirtualHost *:443> #find this existing block in your ssl configuration file and add the lines below

    # Rewrite only / without anything else to /skoor-dashboard-viewer/
    RewriteEngine On
    RewriteRule ^/$ https://%{SERVER_NAME}/skoor-dashboard-viewer/ [R,L]

Pour que cette configuration fonctionne, le répertoire DocumentRoot doit exister. Créez-le, puis redémarrez le server web à l'aide des commandes suivantes :

$ sudo mkdir -p /srv/eranger/html
$ sudo systemctl restart httpd

Système Dashboard Provider

Installez les paquets nodejs et dashboard-viewer-provider :

$ sudo yum install eranger-dashboard-viewer-provider

Configurez le Dashboard Viewer Provider en modifiant le fichier /etc/opt/eranger/eranger-dashboard-viewer-provider.json. Voici une brève description des propriétés disponibles :

Paramètre

Description

logLevel

Sélectionnez l'un des niveaux suivants : debug, info, warn, error

webserviceUrl

Le service web à partir duquel récupérer les données

tenantId

Identifie différents tenants si plusieurs d'entre eux alimentent le même Dashboard Viewer. La valeur préconfigurée est « default ». La connexion au tenant « default » ne nécessite pas de préfixe tenantId. Pour vous connecter à d'autres tenants, ajoutez « <tenantname>/ » avant le nom d'utilisateur

viewerServices

Ce paramètre est utilisé pour configurer un ou plusieurs viewers avec un nom, son URL et sa clé presharedKey.

  • Le paramètre presharedKey doit être identique sur tous les providers qui alimentent le même Viewer Service

  • Le paramètre url peut pointer directement vers le service provider si le viewer est installé sur l'hôte local :

    "url": "http://localhost:8092"
  • Si le viewer est installé dans une DMZ, l'URL doit pointer vers le port 443 desservi par apache httpd :

    "url": "https://<viewer server name or ip>/skoor-dashboard-viewer-service"

presharedKey

Cette clé doit être partagée entre le Dashboard Provider et le Dashboard Viewer Service. Pour des raisons de sécurité, elle doit être remplacée par une valeur unique.

 Exemple :
 

{
  "logLevel": "debug",
  "webserviceUrl": "http://localhost:8090",
  "authUrl": "http://localhost:8094",
  "tenantId": "default",
  "viewerServices": {
    "dashboard-viewer": {
      "url": "https://<viewer server name or ip>/skoor-dashboard-viewer-service",
      "presharedKey": "1234567890"
    }
  }
}


Redémarrez maintenant le service Provider :

sudo systemctl restart eranger-dashboard-viewer-provider.service

Mise à jour

Mettez à jour tout paquet SKOOR à l'aide de yum update :

$ sudo yum update eranger-dashboards-*.rpm

Smoke test

Ouvrez l'URL https://<viewer server name>/skoor-dashboard-viewer dans un navigateur web. Un dashboard visible par l'utilisateur par défaut configuré doit s'afficher sans qu'il soit nécessaire de se connecter au préalable. Le cas échéant, il est possible de passer à un autre tenant en ajoutant le paramètre d'URL tenantId à l'URL : https://<viewer server name>/skoor-dashboard-viewer?tenantId=someTenant

Dans le menu utilisateur, le lien Log In permet de se connecter avec un autre utilisateur, généralement un utilisateur autorisé à afficher des informations privilégiées qui ne doivent pas être visibles par l'utilisateur par défaut :

image-20250729-134255.png

Cliquez sur Login et saisissez les identifiants, éventuellement précédés d'un autre tenant avant le nom de connexion :

image-20250729-134727.png

Les dashboards privés doivent maintenant être visibles.