Sur cette page

Configuration du Webserver

Le Webserver dispose d’un fichier de configuration JSON minimal pour les parametres au niveau du service, tandis que la plupart des parametres operationnels sont geres via l’interface Web et stockes dans sa base de donnees cle-valeur integree.

Configuration du service (webserver.json)

Ce fichier doit se trouver dans le meme repertoire que l’executable.

{
  "HTTPS": "true",
  "PortAPI": "8050",
  "PortWEB": "9090",
  "RunUser": "mugnsoft",
  "_sharedInternal": "<meme-valeur-sur-chaque-composant>"
}
Champ Type Description Defaut
HTTPS string Activer HTTPS pour les serveurs API et Web. Definir a "true" ou "false" "true"
PortAPI string Port TCP pour le serveur API REST "8050"
PortWEB string Port TCP pour le serveur de l’interface Web "9090"
RunUser string Utilisateur systeme pour executer le service (Linux uniquement). Laisser vide pour utiliser l’utilisateur courant ""
_sharedInternal string Mot de passe du compte machine interne adminMNS. Le Webserver l’utilise pour s’authentifier aupres de chaque composant qu’il pilote (Enable, Push Settings, resynchronisation des jetons) ; il doit correspondre a la valeur de la configuration de chaque composant. Lorsqu’il est vide, adminMNS n’est pas cree. Voir Secret interne des composants valeur d’exemple fournie
Important : La modification des ports ou du parametre HTTPS necessite un redemarrage du service. Les autres parametres (SMTP, Slack, LDAP, etc.) sont configures via l’interface Web et ne necessitent pas de modifications de ce fichier.
_sharedInternal doit contenir la meme valeur dans webserver.json, monitor.json, integrator.json et discovery_agent.json. Une non-correspondance fait echouer les actions Enable / Push Settings du Webserver avec une erreur bcrypt dans le journal du composant cible. Le redemarrage d’un composant recalcule le hash de son mot de passe adminMNS pour correspondre a sa configuration : une valeur obsolete se repare ainsi automatiquement.

Parametres d’execution (via l’interface Web)

Ces parametres sont configures via la page Parametres de l’interface Web et stockes de maniere chiffree dans le magasin cle-valeur integre.

SMTP (Email)

Parametre Description
SMTP Server Nom d’hote du serveur de messagerie
SMTP Port Port du serveur de messagerie (25, 465, 587)
SMTP Username Nom d’utilisateur pour l’authentification
SMTP Password Mot de passe pour l’authentification
SMTP TLS Activer le chiffrement TLS
Sender Email Adresse email pour les messages sortants

Integration Slack

Parametre Description
Slack Token Jeton de bot pour l’API Slack
Slack Channel Canal par defaut pour les notifications

Integration GitLab

Parametre Description
GitLab URL URL du serveur GitLab
GitLab Token Jeton d’acces personnel
GitLab Project Identifiant du projet pour l’import de scripts de moniteur

Integration LDAP

Parametre Description
LDAP Server Nom d’hote du serveur LDAP/AD
LDAP Port Port du serveur (389, 636)
LDAP Base DN DN de base pour les recherches
LDAP Bind DN DN de l’utilisateur de liaison
LDAP Bind Password Mot de passe de l’utilisateur de liaison
LDAP TLS Activer TLS

Journalisation

Parametre Description Defaut
Log Level debug, info, warn, error info
Max Log Size Taille maximale du fichier journal (Mo) 10
Max Backups Nombre de fichiers journaux en rotation 5
Max Age Jours de conservation des fichiers journaux 28
Compress Logs Compresser les fichiers en rotation true

Parametres d’authentification JWT

Ces parametres sont integres dans le binaire et ne peuvent pas etre modifies via la configuration :

Parametre Valeur
Algorithme de signature RS256
Duree de vie du jeton utilisateur 15 minutes
Duree de vie du jeton composant 60 jours (1440 heures)
Recherche du jeton header: Authorization, cookie: jwt
En-tete du jeton Bearer
Nom du cookie jwt
Cookie HTTPOnly true
Cookie SameSite Lax

Emplacements des fichiers

Fichier/Repertoire Fonction
webserver.json Configuration du service
license_MNS.dat Fichier de licence (requis)
config/sec/mugnsoft_webserver.key Cle privee RSA (signature JWT)
config/sec/mugnsoft_webserver.key.pub Cle publique RSA (verification JWT)
config/ssl/certificates/ Certificats TLS
config/ssl/private/ Cles privees TLS
dbs/webserver.db Base de donnees cle-valeur integree principale
dbs/backup/ Sauvegardes automatiques
log/ Journaux de l’application

Traductions

Configuration du Monitor