README

Un starter kit Laravel léger basé sur Mary UI, inspiré de mary-ui-starter-kit, simplifié pour une intégration sans laravel-permission et avec un module optionnel d'authentification Kerberos (SSO).

Stack technique

Composant	Version
PHP	^8.2
Laravel	v12
Livewire	v4
Mary UI	v2
Tailwind CSS	v4
DaisyUI	v5
Laravel Fortify	v1
Pest	v3

Fonctionnalités incluses

Authentification complète via Fortify : connexion, inscription, mot de passe oublié, réinitialisation, vérification e-mail
Double authentification (2FA) : activation, désactivation, codes de récupération
Page de paramètres : profil, mot de passe, apparence, 2FA
Layout avec sidebar responsive (Mary UI) avec navigation mobile
Module Kerberos optionnel : SSO via REMOTE_USER (Apache/Nginx)
Tests Pest préconfigurés
Formatage avec Laravel Pint

Démarrage rapide

composer create-project moko-github/maryui-simple-starter-kit mon-app
cd mon-app
npm install && npm run build

L'installateur interactif vous proposera d'activer le module Kerberos pendant la création du projet.

Installation manuelle

git clone https://github.com/moko-github/maryui-simple-starter-kit.git mon-app
cd mon-app
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install && npm run build

Développement

# Démarre le serveur, la queue et Vite en parallèle
composer run dev

# Lancer les tests
php artisan test

# Formater le code
vendor/bin/pint

Module optionnel : Authentification Kerberos (SSO)

Ce starter kit intègre un module d'authentification unique (SSO) via Kerberos, activable à l'installation ou à tout moment.

Activation

php artisan app:install

L'installateur copie les fichiers nécessaires, configure le middleware et les routes, ajoute les variables d'environnement et exécute les migrations.

Variables d'environnement

Variable	Défaut	Description
`KERBEROS_ENABLED`	`false`	Active/désactive l'authentification Kerberos globalement
`KERBEROS_SERVER_VAR`	`REMOTE_USER`	Nom de la variable serveur contenant l'identifiant Kerberos
`KERBEROS_FALLBACK_AUTH`	`true`	Autorise le formulaire login/password si Kerberos est indisponible
`KERBEROS_SIMULATION_MODE`	`false`	Active le widget de simulation en local (ignoré si `APP_ENV=production`)
`KERBEROS_ADMIN_EMAILS`	(vide)	Emails des admins notifiés (vide = tous les admins en BDD)
`KERBEROS_AUTO_CLEANUP_DAYS`	`30`	Rétention des tentatives de connexion en jours
`KERBEROS_ALLOWED_DOMAINS`	(vide)	Whitelist des domaines Kerberos acceptés (vide = tous)
`KERBEROS_ADMIN_NOTIFICATION_MODE`	`immediate`	Mode de notification : `immediate`, `digest` ou `disabled`

Fichier .env complet par environnement :

Local (développement)

KERBEROS_ENABLED=true
KERBEROS_SIMULATION_MODE=true
KERBEROS_FALLBACK_AUTH=true
KERBEROS_AUTO_CLEANUP_DAYS=7
KERBEROS_ADMIN_NOTIFICATION_MODE=disabled

Production

KERBEROS_ENABLED=true
KERBEROS_SERVER_VAR=REMOTE_USER
KERBEROS_FALLBACK_AUTH=true
KERBEROS_SIMULATION_MODE=false
KERBEROS_ADMIN_EMAILS=security@exemple.fr,admin@exemple.fr
KERBEROS_AUTO_CLEANUP_DAYS=30
KERBEROS_ALLOWED_DOMAINS=corp.exemple.fr
KERBEROS_ADMIN_NOTIFICATION_MODE=immediate

Scénarios d'authentification

Scénario	Condition	Résultat
Succès	`REMOTE_USER` correspond à un utilisateur avec un rôle	Connexion automatique
Sans rôle	`REMOTE_USER` correspond à un utilisateur sans rôle	Formulaire de demande d'accès
Inconnu	`REMOTE_USER` introuvable en base de données	Accès refusé + notification admin
Sans Kerberos	`REMOTE_USER` est vide	Formulaire de connexion classique

Configuration serveur web

Apache :

<Location />
    AuthType Kerberos
    AuthName "Connexion Kerberos"
    KrbAuthRealm EXEMPLE.FR
    Krb5Keytab /etc/apache2/http.keytab
    KrbMethodNegotiate On
    KrbMethodK5Passwd Off
    require valid-user
</Location>

Nginx :

location / {
    auth_gss on;
    auth_gss_realm EXEMPLE.FR;
    auth_gss_keytab /etc/nginx/http.keytab;
    auth_gss_service_name HTTP;
}

Pour les détails complets, voir INSTALL.md.

Différences avec mary-ui-starter-kit

Fonctionnalité	mary-ui-starter-kit	Ce projet
Gestion des rôles	`laravel-permission` (Spatie)	Simple colonne `role_id` (optionnel via Kerberos)
SSO Kerberos	Non	Oui (module optionnel)
Complexité	Plus complète	Allégée, plus facile à personnaliser

Licence

MIT

moko-github / maryui-simple-starter-kit

Maintainers

Package info

Statistics

Security