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
Le dépôt RPM SKOOR est disponible
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 |
|---|---|
| Le port TCP sur lequel le service est accessible localement par le server web |
| 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. |
| Définissez ce paramètre sur l'une des valeurs suivantes : debug, info, warn, error |
| 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. |
| 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 |
|---|---|
| Sélectionnez l'un des niveaux suivants : debug, info, warn, error |
| Le service web à partir duquel récupérer les données |
| 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 |
| Ce paramètre est utilisé pour configurer un ou plusieurs viewers avec un nom, son URL et sa clé 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 :
Cliquez sur Login et saisissez les identifiants, éventuellement précédés d'un autre tenant avant le nom de connexion :
Les dashboards privés doivent maintenant être visibles.

