---
title: "Configuration"
weight: 20
description: "Réglages du module capliboo : jetons, verrous, extensions, suite bureautique."
---

# 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é](screenshots/configuration-generale.webp)

## 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](screenshots/sessions-edition.webp)

## 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.