SmartAuth

Overview

SmartAuth is a Dolibarr module that provides a complete authentication and authorization system. It acts as the central component of the SmartMaker ecosystem to connect mobile applications, third-party services and machine-to-machine systems to your Dolibarr ERP.

Three authentication modes

JWT API (mobile applications)

SmartAuth generates JWT tokens (access token + refresh token) for SmartMaker mobile applications. Each connected device forms an independent token family, which allows revoking one device without affecting the others.

OAuth2/OIDC (Single Sign-On)

SmartAuth can act as an identity provider (IdP) for SSO. It implements the OAuth2 protocol with OpenID Connect, which allows third-party applications (WordPress, Nextcloud, etc.) to delegate authentication to Dolibarr.

Client Credentials (machine-to-machine)

For server-to-server communication, SmartAuth supports the client_credentials grant type (RFC 6749 Section 4.4). This mode requires no user interaction.

Main features

  • Dashboard -- Overview of active tokens, logged-in users, rate limit blocks and refresh success rate
  • Token management -- List, view and revoke active JWT tokens
  • Device management -- Tracking of registered devices with the ability to rename or revoke
  • Authentication logs -- Complete history of connections and API actions
  • OAuth2/OIDC server -- Standard endpoints (authorization, token, userinfo, discovery, revocation)
  • OAuth clients -- Creation and management of OAuth2 clients (confidential or public with PKCE)
  • Rate limiting -- Protection against brute force attacks (by IP and by user)
  • Token families -- Per-device isolation with cascade revocation
  • Replay attack detection -- Automatic revocation when a refresh token is reused
  • GeoIP -- Optional geolocation of connection IP addresses
  • Security alerts -- Automatic detection of brute force and DDoS attempts
  • Dynamic PWA -- PWA manifest and icons generated dynamically for SmartMaker modules
  • Scheduled task -- Automatic cleanup of expired tokens and logs
  • User tab -- View tokens and history directly from the Dolibarr user record

SmartAuth dashboard with key security indicators and active tokens

Requirements

  • Dolibarr 18.0 or higher
  • PHP 7.4 or higher

Publisher

SmartAuth is developed by CAP-REL.

Support