Authentification
Cette application exécute son propre Better Auth à
/api/auth/*, en se fédérant au broker d'authentification Grok partagé (auth.grok.me)
via le plugin genericOAuth. Ce modèle intègre Google et X.
Méthodes de connexion prises en charge — utilisez UNIQUEMENT ces trois méthodes ; rien d'autre n'est pris en charge :
Google, X et email/mot de passe. Aucun autre fournisseur social/OAuth (GitHub, Apple,
Discord, …), aucun lien magique, clé d'accès, OTP, téléphone/SMS ou connexion anonyme. Ne pas
ajouter d'entrées à GROK_PROVIDERS. Détail des méthodes et l'interrupteur email/mot de passe
(modifier uniquement src/lib/auth/email-password.ts) : references/sign-in-methods.md.
Exception — les spectateurs de la porte sont déjà connectés ; NE JAMAIS afficher de boutons de connexion/ré-authentification pour eux. Applications connecteur / données d'application : UNIQUEMENT la porte « Continuer avec Grok », pas de boutons Google/X : references/grok-identity.md.
La connexion est DÉSACTIVÉE par défaut — le modèle fournit .grok/app-env.json avec
{"VITE_AUTH_ENABLED": "false"}, donc n'ajoutez des comptes que lorsque la demande l'exige
(AGENTS.md §0.5). L'activer correspond à « Activer la connexion » ci-dessous.
Une fois activée, la connexion est RÉELLE — y compris dans l'aperçu en direct du sandbox. Ne
PAS créer d'utilisateurs de démonstration/maquette/codés en dur. Aperçu : popup + client d'aperçu intégré ;
déployé : client par application + DATABASE_URL + connexion porte sans clic
(references/prewired-and-env.md).
Lorsqu'elle est DÉSACTIVÉE (VITE_AUTH_ENABLED=false), un utilisateur de développement est renvoyé pour qu'une
application sans authentification s'affiche sans visiteur connecté — développement et aperçu uniquement.
Lorsqu'elle est déployée, le drapeau est celui de la plateforme (toujours "true"), donc requireUserId
rejette tout visiteur — les applications sans authentification ne l'utilisent ni n'utilisent authMiddleware.
Tout est préinstallé et pré-câblé dans src/lib/auth/ — ne pas
npm install quoi que ce soit ; better-auth est le seul package d'authentification (jamais
@neondatabase/*, @stackframe/*, ou @clerk/*). Ne pas modifier ni réécrire de
fichier dans src/lib/auth/ — server.ts encore moins — sauf
email-password.ts pour son unique drapeau. Carte par fichier :
references/prewired-and-env.md.
/auth/popup est déjà géré par le plugin Vite du modèle
(vite.config.ts → popup.server.ts) : il n'affiche jamais l'application React. Ne PAS
créer src/routes/auth/popup.tsx (ni aucune page React / OAuth client à ce
chemin) — cela affiche l'application complète dans la popup, le mode d'échec courant.
Ne jamais écrire de fichier .env / .env.local / .env.example dans ce sandbox :
l'aperçu en direct a besoin de zéro configuration d'environnement et une application déployée reçoit ses variables
injectées par la plateforme. Les boutons existants se trouvent dans
references/prewired-and-env.md — ne jamais exposer une variable non VITE_ au client.
migrations/auth/0001_auth.sql est le schéma Better Auth — ne pas modifier. Il
se trouve en dehors du répertoire migrations/ (aucun applicateur ne descend), donc
il n'est pas appliqué aux applications sans connexion ; « Activer la connexion » le copie vers le haut.
Activer la connexion
Faites tout cela — les routes seules affichent la branche désactivée :
- Drapeau : supprimez la clé
VITE_AUTH_ENABLEDde.grok/app-env.jsonet redémarrez le serveur de développement. Vite lit l'environnement au démarrage, donc HMR ne le détectera pas.npm run dev,npm run buildetnpm run previewlisent tous ce fichier viascripts/with-app-env.mjs, donc l'aperçu et la sortie compilée basculent ensemble — ne démarrez jamais Vite directement. - Schéma :
cp migrations/auth/0001_auth.sql migrations/0001_auth.sql, puis redémarrez pour qu'il s'applique. Il est suivi par nom de base dans_migrations, donc une base de données qui l'a déjà ne le réexécutera pas. - Routes : ajoutez
src/routes/api/auth/$.ts+src/routes/login.tsx— copiez les deux depuisreferences/wiring.md(la route API générique est ce qui rend/api/auth/*et le rappel du broker fonctionnels). - Déconnexion : une connexion sans moyen de sortie n'est pas terminée — affichez
<UserButton />depuis@/lib/auth/gates(câblesignOut(); masque la déconnexion pour les sessions de porte). - Données existantes : enveloppez les fonctions serveur de l'application dans
authMiddleware(une application sans authentification n'a pas dû l'utiliser — voir la compétenceneon). Les lignes antérieures à l'existence de la connexion sont des données de développement : supprimez-les et recréez-les sauf si l'utilisateur dit le contraire — ne les remettez pas à celui qui se connecte en premier.
Construire dessus une fois qu'il est activé
- Connexion / Déconnexion :
signIn(providerId)etsignOut()depuis@/lib/auth/client;GROK_PROVIDERSaffiche les boutons. La popup, le transfert de jeton porteur et l'attachement de requête sont internes — laissez-les tranquilles. Préférez<UserButton />(il gère les états en attente et d'échec) ;signOut()rejette lorsqu'il est déployé si le serveur ne confirme jamais — interceptez-le. Ne jamaisauthClient.signOut(): il laisse le jeton porteur d'aperçu attaché à chaque requête ultérieure, donc le visiteur reste connecté. - Lire l'utilisateur :
useCurrentUser()est en lecture seule (nullsignifie chargement OU déconnecté, donc ne redirigez jamais uniquement sur celui-ci) ; protégez-vous avecuseCurrentUserState()'sisPendingà la place. Les portes (SignedIn,SignedOut,SignInGate,RedirectToSignIn,UserButton) vivent dans@/lib/auth/gates. Règles strictes pour l'appel à l'action, le squelette et le SSR sans flash avec cookie :references/session-ui.md. - Données par utilisateur (obligatoire) : chaque fonction serveur qui touche aux données par utilisateur
doit utiliser le
authMiddlewarepré-câblé et limiter chaque lecture et écriture àcontext.userId— un pilote Postgres a un accès complet à la base de données, donc rien d'autre ne limite la requête. Conservez les colonnesuser_idenTEXT; ne faites jamais confiance à un identifiant utilisateur fourni par le client ; en mode déconnecté, le middleware lèveUnauthorizedError(401). Code et sémantique en mode désactivé :references/per-user-data.md. - Modèle de sécurité : broker sans tête, cookies
__Host-+trustedOrigins, et isolation des frères Fetch-Metadata sont déjà câblés — ne les affaiblissez jamais pour faire disparaître une erreur (references/sign-in-methods.mdcouvre le modèle et le correctif « Invalid origin »).