This is an automated email from the git hooks/post-receive script. New commit to branch develop in repository observe. See https://gitlab.nuiton.org/codelutin/observe.git commit 312ec728d3107215ea1fba2d31bbbd52b868d304 Author: Tony CHEMIT <chemit@codelutin.com> Date: Mon Sep 5 11:19:07 2016 +0200 Amélioration documentation de configuration de l'application web --- src/site/rst/administration-web.rst.vm | 68 +++++++++++++++++++--------------- 1 file changed, 39 insertions(+), 29 deletions(-) diff --git a/src/site/rst/administration-web.rst.vm b/src/site/rst/administration-web.rst.vm index 66c3134..b185362 100644 --- a/src/site/rst/administration-web.rst.vm +++ b/src/site/rst/administration-web.rst.vm @@ -20,58 +20,49 @@ .. * #L% .. - +Installation de l'application web +--------------------------------- + +L'application web est une application web classique à installer dans un conteneur web (tomcat). + Configuration de l'application web ---------------------------------- -La configuration de l'application web est réalisée par l'intermédiaire de plusieurs fichiers dont le point d'entrée est le fichier : +La configuration de l'application web est regroupé dans un seul fichier à placer ici :: - observeweb.conf + /etc/observeweb.conf -Ce fichier est embarqué avec l'application et est chargé par le biais de la classe ApplicationConfig de nuiton. -Par conséquent, il peut donc être surchargé à plusieurs niveaux sur la machine. (voir http://nuiton-config.nuiton.org/v/latest/index.html) -Ce fichier de configuration permet de définir le mode d'exécution de l'application, son numéro de version,.. mais aussi de surcharger les options de configuration par défaut. -Par exemple, il est possible de modifier l'emplacement par défaut (/var/local/observeweb) des autres fichiers de configuration. +La configuration de l'application possède des valeurs par défaut pour toutes les options, si vous utiliser ces valeurs par défaut, un minimum de configuration est requise. -Le reste de la configuration de l'application web est placée sous /var/local/observeweb et contient : +Par défaut, l'application utilise le répertoire **/var/local/observeweb** pour y stoquer ses données. :: /var/local/observeweb/ - |-- databases.yml #contient les informations de connexion aux bases de données distantes + |-- databases.yml # configuration des bases de données |-- log - | `-- observeweb-${project.version}.log - |-- observeweb-log4j.conf # contient la configuration relative aux logs de l'application web - |-- temp - `-- users.yml # contient la liste des utilisateurs habilités à utiliser les services web ainsi que leurs niveaux de droits. - -En mode développement (devMode = true), si le répertoire /var/local/observeweb n'existe pas, un répertoire est généré sous /tmp. + | `-- observeweb-${project.version}.log # logs de l'application + |-- observeweb-log4j.conf # configuration des logs + |-- temp # répertoire temporaire + `-- users.yml # configuration des utilisateurs Par défaut, l'application est déployée à l'adresse suivante : :: http://localhost:8080/obwerveweb +Consulter la `page des configurations`_ pour connaitre l'ensemble des options de cette configuration. -Configuration des utilisateurs habilités à consommer les services web -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Le fichier users.yml définit les utilisateurs habilités à utiliser les services mis à disposition par l'application web -ainsi que leur niveau de droit (mapping avec les droits des bases de données). Par exemple : - -:: - - users: - - login: myUser - password: a - permissions: - - database: production - role: technicien +Deux options doivent être modifiées : -L'utilisateur "myUser" aura le droit d'accéder à la base de production avec le rôle technicien. + - **observeweb.adminApiKey** : la clef de l'API pour accéder aux services d'administrations + - **observeweb.apiUrl** : l'url d'accès aux services web Configuration des bases données accessibles par les utilisateurs des services web ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Le fichier databases.yml liste les bases de données (paramètres de connexion, roles) accessibles par les utilisateurs. + +Le fichier databases.yml liste les bases de données connues par l'application. Par exemple : :: @@ -85,3 +76,22 @@ Par exemple : - login: referentiel password: ref url: jdbc:postgresql://localhost:5432/obstuna + +Configuration des utilisateurs habilités à consommer les services web +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Le fichier users.yml définit les utilisateurs habilités à utiliser les services mis à disposition par l'application web +ainsi que leur niveau de droit (mapping avec les droits des bases de données). Par exemple : + +:: + + users: + - login: myUser + password: a + permissions: + - database: production + role: technicien + +L'utilisateur "myUser" aura le droit d'accéder à la base de production avec le rôle technicien. + +.. _page des configurations: ./config-report.html#detail_observeWeb \ No newline at end of file -- To stop receiving notification emails like this one, please contact codelutin.com SCM administrator <admin+scm@codelutin.com>.