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>"
}

Rapports PDF (PdfBrowser)

Depuis la 4.3.0, un rapport peut etre envoye en PDF (voir Langue et format). Le Webserver construit toujours le rapport HTML, puis demarre un Chrome, Chromium ou Edge sans interface qui l’ouvre, attend que les graphiques soient dessines et l’imprime en A4 paysage. Rien d’autre n’est a installer : le navigateur est pilote directement, sans driver.

Navigateur utilise. Si PdfBrowser est renseigne, cet executable et aucun autre. Un chemin qui n’existe pas n’est pas remplace par un autre navigateur : le rapport repasse en HTML avec l’erreur PdfBrowser "<chemin>" in webserver.json does not exist. Si PdfBrowser est vide ou absent, le Webserver cherche :

Windows 10/11 et Windows Server 2022 ou ulterieur incluent Edge : le PDF y fonctionne sans aucun reglage. Sous Linux, installez un navigateur, par exemple :

# Debian / Ubuntu
sudo apt install chromium
# RHEL / Rocky / Alma (EPEL)
sudo dnf install chromium

Renseignez PdfBrowser lorsque le navigateur est ailleurs, ou pour imposer un navigateur quand plusieurs sont installes :

{
  "HTTPS": "true",
  "PortAPI": "8050",
  "PortWEB": "9090",
  "RunUser": "mugnsoft",
  "_sharedInternal": "<meme-valeur-sur-chaque-composant>",
  "PdfBrowser": "/opt/google/chrome/chrome"
}

Sous Windows, doublez les barres obliques inverses : "PdfBrowser": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe". Le parametre est lu au demarrage : redemarrez le Webserver apres l’avoir modifie.

Fonctionnement.

• Chaque impression utilise un profil de navigateur jetable, supprime ensuite. Vos profils, cookies et extensions ne sont jamais lus.
• Execute en root (cas typique d’un conteneur), le navigateur est demarre avec --no-sandbox, car Chrome refuse son bac a sable en root. Executez le service sous un utilisateur normal (RunUser) pour conserver le bac a sable.
• Deux rapports au plus sont imprimes en meme temps ; les autres attendent leur tour. Prevoyez 150 a 300 Mo de memoire par impression.
• Une impression qui ne se termine pas a temps (60 s pour dessiner les graphiques, 2 minutes au total) est abandonnee, et le rapport est envoye en HTML.
• Aucun acces Internet n’est necessaire. La page du rapport demande ses bibliotheques (Chart.js, UIkit, jQuery, moment…) a des CDN publics ; pendant l’impression, le Webserver repond lui-meme a ces requetes avec les copies integrees a son executable, et refuse toute autre requete. Un Webserver sur un reseau ferme imprime des PDF complets. Pour des rapports HTML lus sans acces Internet, voir Rapports sans acces Internet.
• Une page dont la bibliotheque de graphiques ne s’est pas chargee n’est pas imprimee avec des panneaux vides : le rapport est envoye en HTML avec la raison the report libraries did not load.

Docker. L’image mugnsoft/webserver ne contient pas de navigateur : les rapports PDF repassent donc en HTML. Pour imprimer des PDF, construisez une image derivee qui ajoute Chromium, et renseignez PdfBrowser s’il n’est pas dans l’un des emplacements ci-dessus.

Depannage. Lorsque le PDF manque, le resultat de l’envoi affiche PDF unavailable (raison) et le journal du Webserver contient une ligne sendReportEmail ... PDF not produced avec la cause :

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)

Integration Slack

Integration GitLab

Integration LDAP

Journalisation

Parametres d’authentification JWT

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

Emplacements des fichiers

Traductions

• en: Webserver Configuration