Supabase tutorial: prima tabella, sicurezza e connessione app

👁 114 letture

Supabase offre un backend completo per la tua applicazione: database, autenticazione utenti, file e API automatiche. La tua prima tabella, da cui l’app legge i dati, sarà pronta in un quarto d’ora.

In questo tutorial ti guido passo dopo passo da un progetto vuoto ai dati visualizzati nell’applicazione, con un passaggio che non puoi assolutamente saltare: la sicurezza della tabella.

I passaggi si basano sulle guide ufficiali di Supabase. Cos’è la piattaforma e perché viene scelta così spesso da chi sviluppa con l’AI l’ho descritto nella guida a Supabase.

Prima di iniziare: pianifica i dati

Prima di creare la tua prima tabella, scrivi su un foglio quali dati conserva l’applicazione e chi può vederli. Ad esempio: le lezioni le vedono tutti, la prenotazione la vede solo chi l’ha fatta e l’istruttore. Da questa nota derivano immediatamente le regole di accesso che poi inserirai nella Row Level Security. Pianificare le regole dopo aver costruito l’app finisce di solito con alcune tabelle completamente prive di protezione.

Passo 1. Progetto

Dopo aver creato l’account, crei un nuovo progetto nel pannello della tua organizzazione. Inserisci il nome, la password del database e la regione. Salva subito la password nel tuo gestore di password, perché servirà per connetterti direttamente al database, e scegli la regione più vicina ai tuoi utenti.

Dopo alcuni minuti il progetto è pronto e sotto gira un normale PostgreSQL che, in caso di migrazione, puoi portare ovunque.

Passo 2. Prima tabella

Puoi creare la tabella nell’editor visuale, cliccando come in un foglio di calcolo, oppure nell’editor SQL. La guida ufficiale mostra la versione con SQL Editor: crei una tabella semplice, ad esempio una lista di strumenti con identificatore e nome, e aggiungi alcune righe di esempio. Anche se non conosci SQL, basta copiare ed eseguire i comandi dalla guida.

Passo 3. Sicurezza della tabella: Row Level Security

Questo è il passaggio da cui dipende la sicurezza dei tuoi dati. La Row Level Security definisce le regole che stabiliscono chi può leggere e modificare quali righe. La guida ufficiale la attiva per la tabella e aggiunge una regola che permette a tutti di leggere solo la lista degli strumenti. Per una lista pubblica va bene. Per i dati dei clienti la regola deve permettere a ciascuno di vedere esclusivamente le proprie righe.

Una tabella senza queste regole, esposta tramite API, è la causa più frequente di fughe di dati nelle applicazioni sviluppate rapidamente. Ne ho scritto più approfonditamente nella guida. La regola è semplice: nessuna tabella con dati utente va in produzione senza regole di accesso attivate.

Passo 4. Indirizzo del progetto e chiave pubblica

L’applicazione ha bisogno di due elementi che trovi nel pannello Connect del progetto: l’indirizzo del progetto e la chiave pubblica. Li incolli nel file di configurazione dell’app. La chiave pubblica può finire nel browser perché l’accesso ai dati è controllato dalle regole del passaggio precedente.

Se l’applicazione non vede i dati, verifica che nelle impostazioni di integrazione sia attivata la Data API.

Passo 5. Connessione con l’app

Supabase ha guide pronte per una decina di tecnologie, da Next.js, React e Vue a Flutter, Python e Laravel. Nel caso di Next.js l’intero avvio si riduce a un singolo comando che crea l’app con la connessione già configurata, incollare indirizzo e chiave, e poi scrivere la pagina che recupera i dati dalla tabella. Dopo aver avviato l’app vedi sulla pagina le righe aggiunte nel secondo passaggio.

Se sviluppi con Lovable o strumenti simili, la maggior parte di questi passaggi li esegue lo strumento per te, ma verificare le regole di accesso resta sempre compito tuo.

Passo 6. Autenticazione e file

Quando la tabella funziona, aggiungi gli altri elementi allo stesso modo. L’autenticazione utenti la attivi nella sezione apposita, scegliendo i metodi, ad esempio email o account Google. I file, come foto profilo o allegati, li conservi nello storage che ha anch’esso le proprie regole di accesso. Per logica più complessa ci sono le funzioni eseguite lato server.

Errori più comuni all’inizio

• Tabella senza regole di accesso esposta nell’applicazione.
• Chiave di servizio nel codice del browser invece della chiave pubblica.
• Regione dall’altra parte del mondo, che rallenta ogni query.
• Mancanza di backup prima di modifiche importanti alla struttura del database.

Quando passare al piano Pro

Il piano gratuito è sufficiente per imparare e per i prototipi, ma i progetti inutilizzati vengono sospesi. Quando l’app ha utenti reali, il progetto non può andare in pausa, e a quel punto il piano Pro smette di essere un’opzione.

Come verificare che i dati siano sicuri

Dopo aver collegato l’applicazione accedi come due persone diverse e verifica che ciascuna veda solo i propri dati. È il test più semplice che individua gli errori più pericolosi. Controlla anche nel pannello l’elenco delle tabelle e assicurati che ognuna esposta tramite API abbia le regole di accesso attivate. Supabase avvisa nel pannello delle tabelle prive di queste regole, quindi vale la pena non ignorare quegli avvisi.

// continua a leggereGumloop tutorial: primo agente AI e automazione no-codeMagazineControlla chi è connesso al tuo WhatsApp in 3 minutiMagazineClaude Opus 5.5 benchmark: tabella completa e note che cambiano tuttoMagazine

Kinetyra