signaturepdf/README.md

Signature de PDF

Logiciel web libre permettant de signer un PDF.

Instances

Liste des instances permettant d'utiliser ce logiciel :

• pdf.24eme.fr
• pdf.libreon.fr
• pdf.hostux.net
• pdf.nebulae.co

License

Logiciel libre sous license AGPL V3

Installation

Debian/Ubuntu

Dépendances :

• php >= 5.6
• rsvg-convert
• pdftk
• imagemagick
• potrace

Installation des dépendances :

sudo aptitude install php librsvg2-bin pdftk imagemagick potrace

Récupération des sources :

git clone https://github.com/24eme/signaturepdf.git

Pour le lancer :

php -S localhost:8000 -t public

Configuration de PHP

upload_max_filesize = 24M # Taille maximum du fichier PDF à signer
post_max_size = 24M # Taille maximum du fichier PDF à signer
max_file_uploads = 201 # Nombre de pages maximum du PDF, ici 200 pages + le PDF d'origine

Configuration d'apache

DocumentRoot /path/to/signaturepdf/public

<Directory /path/to/signaturepdf/public>
    Require all granted
    FallbackResource /index.php
    php_value max_file_uploads 201
    php_value upload_max_filesize 24M
    php_value post_max_size 24M
</Directory>

Déployer avec docker

Construction de l'image

docker build -t signaturepdf .

Lancement d'un conteneur

docker run -d --name=signaturepdf -p 8080:80 signaturepdf

localhost:8080

Configuration

Les variables suivantes permettent de configurer le déployement :

Variable	description	exemple	defaut
SERVERNAME	url de déploiement	pdf.24eme.fr	localhost
UPLOAD_MAX_FILESIZE	Taille maximum du fichier PDF à signer	48M	24M
POST_MAX_SIZE	Taille maximum du fichier PDF à signer	48M	24M
MAX_FILE_UPLOADS	Nombre de pages maximum du PDF, ici 200 pages + le PDF d'origine	401	201
PDF_STORAGE_PATH	chemin vers lequel les fichiers pdf uploadés pourront être stockés	/data

docker run -d --name=signaturepdf -p 8080:80 -e SERVERNAME=pdf.example.org -e UPLOAD_MAX_FILESIZE=48M -e POST_MAX_SIZE=48M -e MAX_FILE_UPLOADS=401 -e PDF_STORAGE_PATH=/data signaturepdf

Alpine

Voici un script permettant d'installer la solution sous Linux Alpine (testé en version 3.15). Pensez à éditer la variable "domain" en début de script pour correspondre à l'URL avec laquelle elle sera appelée.

Les composants principaux sont :

• php 8 + php-fpm
• Nginx
• pdftk (installation "manuelle" nécessitant openjdk8)
• imagick
• potrace
• librsvg

Ce que fait le script :

• Installation des dépendances
• Configuration de php et php-fpm
• Configuration d'Nginx
• Configuration du config.ini
• Git clone du repo

#!/bin/sh

domain='sign.example.com'

apk update 
apk add bash nginx git php8 php8-fpm php8-session php8-gd php8-fileinfo openjdk8 imagemagick potrace librsvg

cd /tmp
wget https://gitlab.com/pdftk-java/pdftk/-/jobs/924565145/artifacts/raw/build/libs/pdftk-all.jar
mv pdftk-all.jar pdftk.jar

cat <<EOF >>pdftk
#!/usr/bin/env bash
/usr/bin/java -jar "\$0.jar" "\$@"
EOF

chmod 775 pdftk*
mv pdftk* /usr/bin

sed -i 's/user = nobody/user = nginx/g' /etc/php8/php-fpm.d/www.conf
sed -i 's/;listen.owner = nginx/listen.owner = nginx/g' /etc/php8/php-fpm.d/www.conf

sed -i 's/post_max_size = 8M/post_max_size = 50M/g' /etc/php8/php.ini
sed -i 's/upload_max_filesize = 2M/upload_max_filesize = 50M/g' /etc/php8/php.ini
sed -i 's/max_file_uploads = 20 /max_file_uploads = 300/g' /etc/php8/php.ini

service php-fpm8 restart

cd /var/www
git clone https://github.com/24eme/signaturepdf.git

cat <<EOF >>/etc/nginx/http.d/signaturepdf.conf
server {

        listen 80 default_server;
        listen [::]:80 default_server;

        server_name ${domain};

        client_max_body_size 0;
    
        root /var/www/signaturepdf/public/;

        index           index.php index.html;

        location / {
        # URLs to attempt, including pretty ones.
        try_files   \$uri \$uri/ /index.php?\$query_string;
        }

        location ~ [^/]\.php(/|$) {
                root /var/www/signaturepdf/public/;

                fastcgi_split_path_info  ^(.+\.php)(/.+)$;
                fastcgi_index            index.php;
                include                  fastcgi_params;

                fastcgi_buffer_size 128k;
                fastcgi_buffers 128 128k;
                fastcgi_param   PATH_INFO       \$fastcgi_path_info;
                fastcgi_param   SCRIPT_FILENAME \$document_root\$fastcgi_script_name;
                fastcgi_pass 127.0.0.1:9000;        

        }

}
EOF

rm /etc/nginx/http.d/default.conf
rm -R /var/www/localhost

service nginx restart

rc-update add nginx
rc-update add php-fpm8

mkdir /var/www/signaturepdf/tmp
chown nginx /var/www/signaturepdf/tmp

cat <<EOF >>/var/www/signaturepdf/config/config.ini
PDF_STORAGE_PATH=/var/www/signaturepdf/tmp
EOF

Configuration

Activation et configuration du mode partage de signature à plusieurs

Ce mode permet de proposer la signature d'un pdf à plusieurs personnes mais il nécessite que les PDF soient stockés sur le serveur, il convient donc de définir un dossier qui contiendra ces PDF.

Il n'est pas obligatoire d'activer ce mode pour que l'application fonctionne c'est une option.

Créer le fichier config/config.ini

cp config/config.ini{.example,}

Dans ce fichier config/config.ini, il suffit ce configurer la variable PDF_STORAGE_PATH avec le chemin vers lequel les fichiers pdf uploadés pourront être stockés :

PDF_STORAGE_PATH=/path/to/folder

Créer ce dossier :

mkdir /path/to/folder

Le serveur web devra avoir les droits en écriture sur ce dossier.

Par exemple pour apache :

chown www-data /path/to/folder/to/store/pdf

Mise à jour

La dernière version stable est sur la branche master, pour la mise à jour il suffit de récupérer les dernières modifications :

git pull -r

Tests

Pour exécuter les tests fonctionnels :

make test

Les tests sont réalisés avec puppeteer et jest.

Pour lancer les tests et voir le navigateur (en mode debug) :

DEBUG=1 make test

Librairies utilisées

• Fat-Free micro framework PHP : https://github.com/bcosca/fatfree (GPLv3)
• Bootstrap framework html, css et javascript : https://getbootstrap.com/ (MIT)
• PDF.js librairie de lecture de PDF dans un canvas HTML : https://github.com/mozilla/pdf.js (Apache-2.0)
• Fabric.js librairie pour manipuler un canvas HTML : https://github.com/fabricjs/fabric.js (MIT)
• PDFtk outils de manipulation de PDF (GPL)
• librsvg outils de manipulation de SVG : https://gitlab.gnome.org/GNOME/librsvg (LGPL-2+)
• potrace outils de transformation d'image bitamp en image vectorisé : http://potrace.sourceforge.net/ (GPLv2)
• OpenType.js outils de transformation d'un texte et sa police en chemin : https://github.com/opentypejs/opentype.js (MIT)
• ImageMagick ensemble d'outils de manipulation d'images : https://imagemagick.org/ (Apache-2.0)
• Caveat police de caractères style écriture à la main : https://github.com/googlefonts/caveat (OFL-1.1)

Pour les tests :

• Jest Framework de Test Javascript : https://jestjs.io/ (MIT)
• Puppeteer librairie Node.js pour contrôler un navigateur : https://github.com/puppeteer/puppeteer (Apache-2.0)

Contributeurs

• Vincent LAURENT (24ème)
• Le Metayer Jean-Baptiste (24ème)
• Xavier Garnier (Logilab)
• Simon Chabot (Logilab)
• Gabriel POMA (24ème)

Logilab a apporté une contribution financière de 1 365 € TTC à la société 24ème pour développer le mode multi signature.

Le développement du logiciel a principalement été réalisé sur le temps de travail de salariés du 24ème.