Configuration
La configuration du module est accessible depuis Accueil > Configuration > Modules > SmartAuth. Elle est organisée en quatre onglets.
Paramètres généraux
L'onglet Paramètres regroupe les réglages principaux du module.
Durée de vie des jetons
| Option | Description |
|---|---|
| SMARTAUTH_TOKEN_EOL_DAYS | Délai (en jours) au bout duquel un jeton est périmé. Valeurs possibles : 10, 20, 30 ou 90 jours. Par défaut : 30 jours. |
Les jetons périmés sont automatiquement nettoyés par la tâche planifiée si le nettoyage est activé.
Utilisateur par défaut
| Option | Description |
|---|---|
| SMARTAUTH_DEFAULT_USER | Utilisateur Dolibarr à utiliser pour les actions anonymes. Sert également de fallback global pour les appels machine-à-machine (client credentials) si aucun utilisateur de service n'est défini sur le client OAuth. |
Mode debug
| Option | Description |
|---|---|
| SMARTAUTH_DEBUG | Active les logs de débogage dans le fichier dolibarr.log. Utile pour diagnostiquer les problèmes d'authentification, de jetons ou de PWA. Désactivez cette option en production. |
Journaux (logs)
| Option | Description |
|---|---|
| SMARTAUTH_COLLECT_LOGS | Active la collecte des journaux web. Chaque requête sur l'API est consignée en base de données. Vous consultez l'historique des actions réalisées via l'API depuis le menu Outils > SmartAuth > Journaux (Logs). |
| SMARTAUTH_CLEAN_LOGS | Active le nettoyage automatique des journaux par la tâche planifiée. |
| SMARTAUTH_LAST_LOGS | Durée de conservation des journaux si le nettoyage automatique est actif. Valeurs possibles : 10, 20, 30, 90, 180 ou 365 jours. |
Proxies de confiance
| Option | Description |
|---|---|
| SMARTAUTH_TRUSTED_PROXIES | Liste des adresses IP de vos proxies de confiance, séparées par des virgules (exemple : 10.0.0.1,172.17.0.1). Lorsqu'une requête provient d'une de ces adresses, l'en-tête X-Forwarded-For est utilisé pour déterminer l'adresse IP réelle du client. Les adresses IP privées (127.x, 10.x, 172.16-31.x, 192.168.x) sont automatiquement considérées comme de confiance. Laissez vide si vous n'utilisez pas de reverse proxy avec une adresse IP publique. |
Tâche planifiée
SmartAuth enregistre une tâche planifiée (cron) qui s'exécute une fois par jour. Elle effectue le nettoyage des jetons expirés et des journaux anciens (si le nettoyage automatique est activé).
Pour vérifier ou modifier la fréquence d'exécution :
- Allez dans Accueil > Configuration > Tâches planifiées
- Recherchez la tâche "SmartAuth"
- Activez-la si elle ne l'est pas déjà
Attention : La tâche planifiée est désactivée par défaut. Activez-la manuellement après l'installation du module.