For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/modules/auth.md (or send Accept: text/markdown).
Autenticazione
Identità e sessioni tramite Better Auth.
Crea e verifica un account reale
Autenticarsi significa dimostrare chi sta utilizzando l'app. Avviare Postgres ed eseguire prima le migrazioni utilizzando la guida del database, quindi lasciare in esecuzione il server Web. Apri http://localhost:3000/auth, scegli la registrazione tramite e-mail/password, inserisci il tuo nome, e-mail e password e invia. Conserva EMAIL_PROVIDER=local per questo primo test.
Quando un flusso richiede un codice email, apri http://localhost:3000/mail-preview in un'altra scheda del browser, trova il messaggio più recente per quell'indirizzo e copiane nuovamente il codice nel modulo di accesso. Richiedi un nuovo codice se scade. Questi messaggi rimangono nella posta in uscita locale; controllando ripetutamente una casella di posta esterna non li troverà. Esci, quindi accedi nuovamente per verificare che l'account supportato dal database funzioni.
Se la registrazione segnala una connessione al database o un errore di tabella mancante, completa la configurazione del database invece di abilitare l'accesso social. I pulsanti Google, GitHub, Apple, X e Microsoft necessitano della propria applicazione provider e delle impostazioni di richiamata; abilitarne uno solo dopo aver completato la guida del fornitore. Better Auth è il motore predefinito fornito e non richiede un account di autenticazione a pagamento per l'accesso e-mail locale.
Scegli i metodi di login abilitati
La base include email/password, OTP e auth social configurabile. Better Auth possiede identità e sessioni, mentre l'applicazione compone la configurazione dei provider e la consegna transazionale degli OTP.
Abilita solo i provider social che hai configurato. I segreti client dei provider e il segreto di auth restano sul server.
Collega l'identità a un workspace
Gli handler autenticati risolvono lo stato della sessione prima di accedere ai record del workspace. Il provisioning del workspace deve restare idempotente così che ripetere un hook del ciclo di vita non crei record di possesso duplicati.
Verifica il comportamento della sessione
Testa login, OTP non validi o scaduti, consumo monouso, logout e accesso anonimo negato. I test con adattatore in memoria coprono la semantica degli handler; la persistenza del database di produzione e i callback reali dei provider richiedono accettazione separata.
Per continuare la configurazione, leggi Configura l'AI.