VoidAuth

VoidAuth est un serveur d'authentification OAuth 2.0 / OpenID Connect minimaliste, pensé pour les utilisateurs qui veulent ajouter une couche SSO à quelques applications self-hostées sans déployer un Keycloak ou un Authentik complet. Le nom « Void » reflète l'approche : pas de fonctionnalités superf

Description

L'application supporte les flux standards OIDC (Authorization Code, Client Credentials, Refresh Token), permet la gestion d'utilisateurs avec mots de passe hachés (bcrypt/argon2) et offre une interface d'administration simple pour enregistrer les clients OAuth. Elle s'intègre nativement avec les applications qui consomment du standard OIDC (Grafana, Nextcloud, Portainer, Wekan, etc.).

Idéal pour les petits homelabs ou les déploiements mono-utilisateur/multi-services où un IdM complet serait disproportionné. Léger, rapide à installer, configuration en fichier plat.

Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  voidauth:
    image: ghcr.io/voidauth/voidauth:latest
    ports:
      - "3000:3000"
    volumes:
      - voidauth-data:/app/data
    environment:
      VOIDAUTH_SECRET: changez-moi-en-production
      VOIDAUTH_URL: https://auth.example.com
    restart: unless-stopped
volumes:
  voidauth-data:

Installation manuelle

Cloner le repo, installer Node.js 20+, lancer npm ci && npm run build && npm start. Prévoir un reverse proxy (Traefik, Caddy) pour HTTPS en production.

Configuration

Clients OAuth : enregistrement via l'admin UI ou fichier YAML
Utilisateurs : stockés en SQLite par défaut, exportable
Scopes : configuration fine des permissions par client
Sessions : cookies signés, durée configurable
Reverse proxy : intégration X-Forwarded-For pour IP réelle

Alternatives

oauth2-proxy — reverse proxy OIDC, encore plus minimal
Authelia — ajoute 2FA et ACL, plus complet
authentik — IdM complet avec UI moderne

Sécurité

Toujours servir via HTTPS avec un reverse proxy
Régénérer VOIDAUTH_SECRET à l'installation (32+ caractères)
Activer le rate limiting sur l'endpoint token
Sauvegarder régulièrement le volume voidauth-data

Ressources

Site officiel : https://voidauth.io
Repository GitHub : https://github.com/voidauth/voidauth
Documentation : https://voidauth.io/docs