Authentification OIDC : tests, docker-compose et .env.example

- Tests avec un fournisseur OIDC simulé (RS256, ES256, HS256) : flux complet,
  groupes, state forgé, claims invalides, alg none, cookie altéré.
- Tests des modes AUTH_MODE dans cmd/server.
- docker-compose.yml et .env.example : AUTH_MODE, OIDC_*, SESSION_*.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018GBsBpHJW7GxFDBV7z1zmo

.env.example

@@ -1,6 +1,20 @@
 EXCALIDRAW_PORT=8080
+# local (Basic si AUTH_USER/AUTH_PASSWORD) ou oidc
+AUTH_MODE=local
 AUTH_USER=
 AUTH_PASSWORD=
+# AUTH_MODE=oidc. Émetteur, ex. Authentik : https://auth.example.org/application/o/excalicloud/
+# Keycloak : https://sso.example.org/realms/<realm>
+OIDC_ISSUER=
+OIDC_CLIENT_ID=
+OIDC_CLIENT_SECRET=
+OIDC_REDIRECT_URL=
+OIDC_SCOPES=openid profile email
+OIDC_ALLOWED_GROUPS=
+OIDC_GROUPS_CLAIM=groups
+OIDC_LOGOUT=true
+SESSION_TTL=24h
+SESSION_SECRET=
 MAX_BODY_MB=50
 UPDATE_CHECK=true
 UPDATE_CHECK_INTERVAL=12h

cmd/server/main_test.go

@@ -1,8 +1,10 @@
 package main
 
 import (
+	"context"
 	"net/http"
 	"net/http/httptest"
+	"strings"
 	"testing"
 )
 
@@ -36,3 +38,46 @@ func TestBasicAuthPublicPaths(t *testing.T) {
 		t.Errorf("authentifié : %d", rec.Code)
 	}
 }
+
+func TestAuthenticateModes(t *testing.T) {
+	me := func(t *testing.T, h http.Handler, user string) string {
+		rec := httptest.NewRecorder()
+		req := httptest.NewRequest("GET", "/api/me", nil)
+		if user != "" {
+			req.SetBasicAuth(user, "p")
+		}
+		h.ServeHTTP(rec, req)
+		return strings.TrimSpace(rec.Body.String())
+	}
+
+	t.Run("local sans identifiants", func(t *testing.T) {
+		t.Setenv("AUTH_MODE", "")
+		t.Setenv("AUTH_USER", "")
+		h, err := authenticate(context.Background(), http.NewServeMux(), t.TempDir())
+		if err != nil || me(t, h, "") != `{"mode":"none"}` {
+			t.Fatalf("%v %s", err, me(t, h, ""))
+		}
+	})
+	t.Run("local Basic", func(t *testing.T) {
+		t.Setenv("AUTH_MODE", "local")
+		t.Setenv("AUTH_USER", "u")
+		t.Setenv("AUTH_PASSWORD", "p")
+		h, err := authenticate(context.Background(), http.NewServeMux(), t.TempDir())
+		if err != nil || !strings.Contains(me(t, h, "u"), `"mode":"local"`) {
+			t.Fatalf("%v %s", err, me(t, h, "u"))
+		}
+	})
+	t.Run("oidc sans émetteur", func(t *testing.T) {
+		t.Setenv("AUTH_MODE", "oidc")
+		t.Setenv("OIDC_ISSUER", "")
+		if _, err := authenticate(context.Background(), http.NewServeMux(), t.TempDir()); err == nil {
+			t.Fatal("configuration incomplète acceptée")
+		}
+	})
+	t.Run("mode inconnu", func(t *testing.T) {
+		t.Setenv("AUTH_MODE", "ldap")
+		if _, err := authenticate(context.Background(), http.NewServeMux(), t.TempDir()); err == nil {
+			t.Fatal("AUTH_MODE inconnu accepté")
+		}
+	})
+}

docker-compose.yml

@@ -11,10 +11,29 @@ services:
 #    ports:
 #      - "${EXCALIDRAW_PORT:-8080}:8080"
     environment:
-      # Authentification Basic optionnelle (laisser vide pour la désactiver,
-      # par exemple derrière un reverse proxy qui gère déjà l'authentification).
+      # Authentification : local (Basic avec AUTH_USER/AUTH_PASSWORD, aucune si
+      # vides, ex. derrière un reverse proxy avec SSO) ou oidc (OIDC_* ci-dessous).
+      AUTH_MODE: ${AUTH_MODE:-local}
       AUTH_USER: ${AUTH_USER:-}
       AUTH_PASSWORD: ${AUTH_PASSWORD:-}
+      # Mode oidc : fournisseur OpenID Connect (Authentik, Keycloak...). Client
+      # confidentiel (secret) ou public (PKCE seul) ; URI de redirection à
+      # déclarer chez le fournisseur : https://<hôte>/auth/callback.
+      OIDC_ISSUER: ${OIDC_ISSUER:-}
+      OIDC_CLIENT_ID: ${OIDC_CLIENT_ID:-}
+      OIDC_CLIENT_SECRET: ${OIDC_CLIENT_SECRET:-}
+      # Vide : déduite de la requête (en-têtes X-Forwarded-* du reverse proxy).
+      OIDC_REDIRECT_URL: ${OIDC_REDIRECT_URL:-}
+      OIDC_SCOPES: ${OIDC_SCOPES:-openid profile email}
+      # Groupes autorisés, séparés par des virgules (vide : tout compte authentifié).
+      OIDC_ALLOWED_GROUPS: ${OIDC_ALLOWED_GROUPS:-}
+      OIDC_GROUPS_CLAIM: ${OIDC_GROUPS_CLAIM:-groups}
+      # Déconnexion propagée au fournisseur (end_session_endpoint).
+      OIDC_LOGOUT: ${OIDC_LOGOUT:-true}
+      # Session : durée d'inactivité max, clé de signature des cookies (16 car.
+      # min. ; vide : clé aléatoire générée dans DATA_DIR/.session-secret).
+      SESSION_TTL: ${SESSION_TTL:-24h}
+      SESSION_SECRET: ${SESSION_SECRET:-}
       # Taille max d'un schéma (images embarquées en base64 comprises).
       MAX_BODY_MB: ${MAX_BODY_MB:-50}
       # Icône « mise à jour d'Excalidraw disponible » (interroge registry.npmjs.org).