Installation pour Debian / ubuntu

Configuration serveur

	Veuillez prendre connaissance des prérequis avant de commencer.

Installation de l'environnement nécessaire à Maarch Parapheur

	Pensez à vérifier l'espace disque de votre environnement en tapant la commande : df -h

Installation de quelques utilitaires

apt-get update && apt-get upgrade && apt-get dist-upgrade -y
apt-get install apache2

Création d'un utilisateur et d'un groupe dédié à l'application

groupadd --gid 1001 maarch
useradd --uid 1001 --gid 1001 maarch --shell /bin/bash

Positionner l’utilisateur « maarch » comme membre du groupe d’exécution d’Apache www-data :

usermod --groups www-data maarch

L’instruction « useradd » ne permettant pas de spécifier le mot de passe de l’utilisateur, spécifier le avec l’instruction suivante :

passwd maarch

Installation des prérequis

Apache

Faire en sorte qu'Apache se lance automatiquement au démarrage du système

systemctl start apache2
systemctl enable apache2

Activer le mode de ré-écriture d'Apache, et la gestion des headers :

a2enmod rewrite
a2enmod headers

Autoriser la lecture / écriture dans les répertoires web

cd /var/www/html/
chown -R maarch. .
find . -type f -exec chmod 0644 {} \;
find . -type d -exec chmod 0755 {} \;

Modification du propriétaire lançant apache :

nano /etc/apache2/envvars

Modifiez les lignes :

export APACHE_RUN_USER=www-data
export APACHE_RUN_GROUP=www-data

Par :

export APACHE_RUN_USER=maarch
export APACHE_RUN_GROUP=maarch

Modification du propriétaire du répertoire de sessions :

chown maarch. -R /var/lib/php/sessions/

Installation de Postgresql

apt-get install postgresql postgresql-contrib
systemctl start postgresql
systemctl enable postgresql

Créer l'utilisateur base de données Maarch :

su postgres
psql
CREATE USER maarch WITH ENCRYPTED PASSWORD 'maarch';
ALTER ROLE maarch WITH CREATEDB;
ALTER USER maarch WITH SUPERUSER;
\q
exit

Installation des paquets nécessaires à l'environnement MaarchParapheur

apt-get install php8.1 libapache2-mod-php8.1 php8.1-cli php8.1-pgsql php8.1-curl php8.1-xml php8.1-zip php-imagick imagemagick git

Vérifier la configuration de imageMagick

sudo nano /etc/ImageMagick-6/policy.xml

Remplacer <policy domain="coder" rights="none" pattern="PDF" /> par <policy domain="coder" rights="read" pattern="PDF" />

Configuration du vhost

Créer le fichier /etc/apache2/sites-available/maarch.conf

nano /etc/apache2/sites-available/maarch.conf

contenant :

<VirtualHost *:80>
    <Directory /var/www/html/>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
    </Directory>
    <Directory "/var/www/html/MaarchParapheur">
        AllowOverride All
        Options -Indexes 
        Options FollowSymLinks Includes ExecCGI
        SetEnv MAARCH_TMP_DIR "/tmp/"
        SetEnv CONFIG_DIR "/var/www/html/MaarchParapheur/config/"
    </Directory>
</VirtualHost>

À partir d'Apache 2.4, il faut éditer le fichier /etc/apache2/apache2.conf, et modifier cette partie comme ceci :

<Directory /var/www>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Vérifier l'application des paramètres suivants dans le php.ini

À faire dans /etc/php/8.1/apache2/php.ini et /etc/php/8.1/cli/php.ini

max_execution_time = 300
max_input_time = 300
memory_limit = 1024M
error_reporting = E_ALL & ~E_DEPRECATED
display_errors = On
short_open_tag = On
post_max_size = 128M
upload_max_filesize = 128M
max_file_uploads = 100
error_log = php_errors.log

Une fois les modifications effectuées, vous devez redémarrer Apache

service apache2 restart

Extraction de Maarch Parapheur depuis les dépôts GIT

cd /var/www/html
mkdir MaarchParapheur
cd MaarchParapheur
git clone -b main https://labs.maarch.org/maarch/MaarchParapheur .
git checkout tags/$(git tag --sort=committerdate | grep -E '2301\.([0-9]+)\.([0-9]+)$' | tail -1) -b $(git tag --sort=committerdate | grep -E '2301\.([0-9]+)\.([0-9]+)$' | tail -1)

	Si vous utilisez un proxy, il faut exécuter cette commande en l'adaptant selon votre environnement : git config --global http.proxy http://proxyuser:proxypwd@proxy.server.com:8080

Comme le serveur Apache devra écrire des fichiers dans les dossiers de l'application, nous allons devoir mettre l'utilisateur Apache comme propriétaire de ces dossiers, et uniquement lui.

chown -R maarch. /var/www/html/MaarchParapheur
cd /var/www/html/MaarchParapheur
find . -type f -exec chmod 0644 {} \;
find . -type d -exec chmod 0755 {} \;

Création d'un répertoire dédié pour stocker les documents de MaarchParapheur

mkdir -p /opt/maarchparapheur/docservers/documents/
mkdir -p /opt/maarchparapheur/docservers/attachments/
mkdir -p /opt/maarchparapheur/docservers/signatures/
mkdir -p /opt/maarchparapheur/docservers/esigned_documents/
mkdir -p /opt/maarchparapheur/docservers/original_documents/
cd /opt/maarchparapheur
chown -R maarch:maarch .
find . -type f -exec chmod 0644 {} \;
find . -type d -exec chmod 0755 {} \;

Base de données

• Créer la base de données "maarchparapheur"

  CREATE DATABASE maarchparapheur WITH OWNER = maarch ENCODING = 'UTF8' TABLESPACE pg_default;
  

• Importer le fichier sql/structure.sql

• Importer le fichier sql/data_fr.sql

Configuration de l'application

cd /var/www/html/MaarchParapheur
cp config/config.default.json config/config.json
nano config/config.json

et renseigner les informations de votre base de données dans le fichier config.json :

{
  "database": [
    {
      "server": "localhost",
      "port": 5432,
      "type": "POSTGRESQL",
      "name": "maarchparapheur",
      "user": "maarch",
      "password": "maarch"
    }
  ]
}

!! IMPORTANT !!

Vous devez créer une clé secrète et la déposée dans un fichier (par exemple dans /var/www/html/MaarchParapheur/config/secret.key).

Ce fichier doit contenir une simple chaine de caractère (par exemple, "Security Key Maarch Parapheur #2008" est pris par défaut).

Le chemin de cette clé doit être renseigné dans le fichier config.json, par exemple :

{
  "config": {
    "privateKeyPath": "/var/www/html/MaarchParapheur/config/secret.key"
  }
}

Pour améliorer la sécurité, nous vous conseillons de donner le droit de lecture à ce fichier uniquement à l'utilisateur maarch.

Cette clé est utilisée pour chiffrer les mots de passe dans la base de données ainsi que pour chiffrer les valeurs dans le token de connexion.
Si ce n'est pas modifié, cela compromet fortement la sécurité de l'application.