Utilisation

Le module SmartAuth est accessible depuis le menu Outils > SmartAuth dans le menu latéral gauche de Dolibarr.

Tableau de bord

La page d'accueil du module affiche un tableau de bord avec quatre indicateurs clés :

• Jetons actifs -- Nombre total de jetons (access + refresh) actuellement valides, avec la variation sur 7 jours
• Utilisateurs connectés -- Nombre d'utilisateurs distincts ayant au moins un jeton actif
• Blocages rate limit -- Nombre de tentatives bloquées dans les dernières 24 heures et nombre d'adresses IP concernées
• Taux de succès refresh -- Pourcentage de rafraîchissements de jetons réussis dans les dernières 24 heures

Alertes de sécurité

Le tableau de bord affiche automatiquement des alertes lorsqu'il détecte :

• Attaques replay -- Des familles de jetons ont été révoquées suite à une réutilisation suspecte d'un refresh token
• Tentatives DDoS -- Une adresse IP a effectué plus de 50 tentatives échouées en une heure
• Brute force -- Un compte utilisateur a subi plus de 10 tentatives de connexion échouées en une heure

Utilisateurs principaux

Le tableau affiche les 10 utilisateurs les plus actifs avec le nombre de jetons, le nombre d'appareils et la date de dernière activité.

Liens rapides

Le tableau de bord propose des accès directs vers :

• La gestion des jetons
• Les journaux
• La configuration

Statistiques complémentaires

La partie droite du tableau de bord affiche :

• Blocages récents -- Les derniers blocages par rate limiting avec l'adresse IP, l'action et le délai
• Statistiques des familles de jetons -- Familles actives, familles révoquées, moyenne de rafraîchissements et attaques replay détectées

Gestion des jetons

Accessible depuis Outils > SmartAuth > Jetons, cette page liste tous les jetons d'authentification actifs.

Pour chaque jeton, vous consultez :

• L'identifiant du jeton
• L'application associée
• L'utilisateur ou la société liée
• La date de création
• La date de dernière utilisation
• L'adresse IP de la dernière connexion
• La date de péremption

Révoquer un jeton

Pour révoquer un jeton et déconnecter l'appareil associé :

1. Repérez le jeton dans la liste
2. Cliquez sur l'action de révocation
3. Confirmez la révocation

La révocation est immédiate : l'appareil est déconnecté et devra se ré-authentifier.

Gestion des appareils

Accessible depuis Outils > SmartAuth > Périphériques, cette page liste tous les appareils enregistrés.

Pour chaque appareil, vous pouvez :

• Renommer -- Attribuer un nom personnalisé pour faciliter l'identification (exemple : "Téléphone de Jean", "Tablette entrepôt")
• Consulter l'historique -- Voir les dernières activités de l'appareil
• Révoquer -- Déconnecter l'appareil et invalider tous ses jetons

Journaux (logs)

Accessible depuis Outils > SmartAuth > Journaux (Logs), cette page affiche l'historique des connexions et des appels API.

Les journaux contiennent :

• La date et l'heure de la requête
• La méthode HTTP et le point d'accès (endpoint)
• Le statut de la réponse
• L'utilisateur associé
• L'adresse IP source

Attention : La collecte des journaux doit être activée dans la configuration (option SMARTAUTH_COLLECT_LOGS) pour que les entrées apparaissent.

Onglet utilisateur

SmartAuth ajoute un onglet SmartAuth dans la fiche de chaque utilisateur Dolibarr.

Cet onglet affiche :

• Les derniers jetons d'API de l'utilisateur avec un lien vers la liste complète
• L'historique des connexions réalisées par cet utilisateur