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

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

Fichier .env complet par environnement :

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

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

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

Licence

MIT