Configuration

Les réglages sont accessibles depuis Accueil > Configuration > Modules > Capliboo (onglet Configuration).

Page de configuration de Capliboo avec les réglages de jeton, de verrou, d'extensions et de sécurité

Réglages disponibles

Durée de vie du jeton : durée de validité d'un jeton de capacité, en secondes (30 minutes par défaut). Le jeton circule dans l'URL du document : gardez cette durée courte.
Délai d'expiration du verrou : durée de vie d'un verrou WebDAV. La suite bureautique rafraîchit le verrou tant que le document reste ouvert.
Extensions éditables : liste des extensions de fichiers ouvrables en édition, séparées par des virgules.
Taille maximale : taille du plus grand document accepté à l'enregistrement, en octets. Un envoi plus gros est refusé proprement.
Versions conservées : nombre de copies précédentes conservées par document à chaque enregistrement (0 désactive le versionnage). Les copies sont rangées dans un sous-dossier .dolidav_versions à côté du document.
Budget de taille du dossier de versions : taille cumulée maximale, en octets, du dossier .dolidav_versions d'un document. Les sauvegardes les plus anciennes sont supprimées en premier une fois le budget dépassé (0 désactive cette garde ; seul le nombre de copies conservées s'applique alors).
Suite bureautique : LibreOffice (par défaut) ou MS Office. Avec MS Office, les fichiers OOXML utilisent les schémas ms-word, ms-excel et ms-powerpoint.
Bloquer les documents générés : refuse l'édition des documents générés par Dolibarr (factures, devis...), qui seraient écrasés à la prochaine régénération.
Liste blanche d'IP : liste optionnelle d'adresses IP autorisées à atteindre l'endpoint WebDAV. Vide = tout autorisé.
Lier le jeton à l'IP : rejette un jeton rejoué depuis une adresse IP autre que celle qui l'a émis. Activé par défaut. À ne désactiver que si le client d'édition et le navigateur atteignent Dolibarr par des adresses IP différentes.
Édition exclusive : refuse l'ouverture en écriture d'un document tant qu'un autre utilisateur détient une session d'écriture active dessus. Désactivé par défaut : les éditions concurrentes sont autorisées et le dernier enregistrement gagne (les versions précédentes sont conservées).
Journal d'audit : enregistre chaque ouverture et chaque enregistrement réussi comme un événement d'agenda Dolibarr (qui, quel document, lecture ou écriture, quand, depuis quelle IP). Désactivé par défaut ; peut générer beaucoup d'événements.
Accepter le PDF compagnon : autorise la suite bureautique du poste à déposer un PDF de même nom que le document édité dans le dossier documents de l'objet (Fichier > Exporter au format PDF vers le dossier distant). Le serveur n'a besoin d'aucun LibreOffice : c'est le poste qui convertit. Le PDF devient ainsi attachable à un mail depuis Dolibarr. Désactivé par défaut. Seul un vrai PDF portant le nom du document édité est accepté.

Sécurité du jeton dans l'URL

Le jeton de capacité circule dans l'URL du document (c'est ce qui permet à la suite bureautique de l'ouvrir). Cette URL peut apparaître dans les journaux d'accès du serveur web ou d'un proxy. Le jeton est atténué par plusieurs mesures : durée de vie courte, portée limitée à un seul fichier, révocation possible, et liaison à l'IP émettrice (voir ci-dessus). Recommandations d'exploitation :

Gardez la durée de vie du jeton courte (30 minutes ou moins).
Servez toujours l'endpoint WebDAV en HTTPS.
Mettez en place une rotation et une purge régulières des journaux d'accès du serveur web et des proxys.
Laissez la liaison à l'IP activée lorsque c'est possible.

Droits

Trois permissions sont fournies :

Ouvrir un document en lecture dans la suite bureautique.
Ouvrir un document en édition et l'enregistrer.
Administrer les sessions d'édition et libérer les verrous.

Attribuez ces droits aux groupes ou utilisateurs concernés depuis la fiche utilisateur ou groupe.

Sessions d'édition

L'onglet Sessions d'édition (page de configuration) liste les jetons actifs et les verrous en cours. Un administrateur peut y révoquer un jeton ou libérer un verrou resté en place après un poste bloqué.

Onglet Sessions d'édition listant les jetons actifs et les verrous en cours, avec les boutons de révocation et de déverrouillage

Purge automatique

Une tâche planifiée supprime chaque jour les jetons expirés. Elle est déclarée à l'activation du module ; vous pouvez ajuster sa fréquence dans Accueil > Configuration > Modules > Travaux planifiés.