---
title: "SmartAuth"
weight: 1
description: "Dolibarr authentication and authorization module for SmartMaker mobile applications, with an integrated OAuth2/OIDC server."
source_hash: "b490772b"
---

# 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](screenshots/tableau-de-bord.webp)

## Requirements

- Dolibarr 18.0 or higher
- PHP 7.4 or higher

## Publisher

SmartAuth is developed by [CAP-REL](https://cap-rel.fr/).

## Support

- Support available via the [CAP-REL website](https://cap-rel.fr/)
- Regular updates
