Service Account vs OAuth per Google Sheets in n8n

Tempo di lettura: 6 minuti — Livello: intermedio
Il bivio che tutti incontrano
Prima o poi ogni automazione tocca un Google Sheet: è il database ufficioso di ogni azienda italiana. E quando in n8n configuri la credenziale Google, ti trovi davanti a un bivio che la documentazione spiega in modo tecnicamente corretto e umanamente incomprensibile: OAuth2 o Service Account?
Ho usato entrambi, ho sbagliato la scelta in entrambe le direzioni, e questa è la spiegazione che avrei voluto trovare io.
La differenza in una metafora
OAuth2 è tu che presti le chiavi di casa: l'automazione agisce come te. Vede quello che vedi tu, modifica quello che puoi modificare tu, e nella cronologia delle modifiche del foglio compare il tuo nome. La configurazione passa dal famoso flusso "Sign in with Google": clicchi, autorizzi, fatto.
Il Service Account è un dipendente robot con una sua identità: un account tecnico (con un suo indirizzo email, tipo automazione@progetto.iam.gserviceaccount.com) che non appartiene a nessun umano. Non ha accesso a niente di tuo: vede solo i fogli che gli condividi esplicitamente, come faresti con un collaboratore esterno.
Quando scegliere cosa
Scegli OAuth2 quando:
-
L'automazione è personale, lavora sui tuoi file, e deve poter accedere a tutto il tuo Drive senza condividere foglio per foglio
-
Vuoi partire in fretta: il flusso di autorizzazione è due click (quando funziona... ci arrivo) Scegli il Service Account quando:
-
L'automazione è di sistema, non di persona: gira di notte, serve un processo aziendale, deve sopravvivere a te
-
Più persone o più workflow toccano gli stessi fogli e vuoi capire dai log chi ha fatto cosa (le modifiche del robot sono firmate dal robot)
-
Vuoi il principio del minimo privilegio: il robot vede tre fogli, non la tua vita digitale intera La regola che mi sono dato dopo un po' di esperienza: le automazioni serie meritano un'identità propria. Se un workflow smette di funzionare perché "l'account di Yuri" ha cambiato password, ha attivato una verifica di sicurezza, o semplicemente Yuri è in ferie e il token è scaduto — quello non era un problema tecnico: era un errore di design. L'automazione aziendale non deve dipendere dal portachiavi di un umano.
Il tallone d'Achille di OAuth in self-hosted
C'è poi un motivo tutto pratico per cui, su n8n self-hosted, il Service Account ti semplifica la vita: il flusso OAuth dietro reverse proxy è fragile. Il "Sign in with Google" richiede che n8n generi un URL di callback corretto verso il tuo dominio pubblico — e come ho raccontato nell'articolo sulle quattro variabili, basta una configurazione proxy incompleta per un "Unauthorized" senza spiegazioni.
Il Service Account tutto questo non lo vive: niente callback, niente redirect, niente browser. L'autenticazione avviene con una coppia di chiavi (un file JSON che scarichi dalla console Google Cloud), firmata direttamente tra server e server. In un setup self-hosted dietro tunnel, è un'intera categoria di problemi che sparisce.
Come si configura, in pratica
Il percorso, senza screenshot che invecchiano male:
- Google Cloud Console → il tuo progetto → IAM e amministrazione → Service Account → Crea
- Crea una chiave JSON per quell'account e scaricala (trattala come una password: è a tutti gli effetti l'identità del robot — vedi l'articolo sui segreti in Docker)
- Abilita le API di Google Sheets (e Drive, se serve) nel progetto
- In n8n: credenziale di tipo "Google Service Account", incolli email del service account e chiave privata dal JSON
- Il passo che tutti dimenticano: condividi il foglio con l'email del service account, come condivideresti con una persona Il punto 5 merita il grassetto perché è la causa del 90% dei "non funziona" con i Service Account: la credenziale è perfetta, l'API abilitata, e il foglio... mai condiviso col robot. L'errore che ricevi (un 403 o un "file not found") non ti dice nulla di utile. Se il tuo Service Account non vede un file, il primo controllo è sempre: il robot è tra le persone con cui il file è condiviso?
L'unica vera controindicazione
Nei contesti Google Workspace aziendali, l'amministratore può limitare la condivisione verso account esterni al dominio — e il service account, tecnicamente, esterno lo è. Se lavori nel Workspace di un cliente, verifica prima che la condivisione verso il service account sia permessa, o preparati a una conversazione con l'IT.
In sintesi
La versione corta: OAuth per te, Service Account per il sistema. E se sei in dubbio, è quasi sempre perché quella che stai costruendo è un'automazione di sistema che stai trattando come uno script personale.
Questo articolo fa parte della serie "Stack & Infrastruttura" su perfetti.tech — dove racconto quello che costruisco davvero, errori compresi.
Hai un problema simile?
Mandami due righe: ti dico se ha senso trasformarlo in uno strumento vero e quanto tempo serve.
ScrivimiAltri articoli
- Webhook n8n aperto a tutti? Come proteggerlo in 4 mosse
Un webhook n8n senza protezioni parte per chiunque conosca l'URL. Quattro mosse semplici, senza codice, per chiuderlo a chiave.
- Copertine con l'AI: automatiche, ma con l'occhio umano
Come ho dato una copertina a 21 articoli con l'AI e automatizzato le prossime: costi, colori da correggere, errori sui dettagli e controllo umano.
- Automazione n8n o agente AI? Quando usare cosa
Che differenza c'è tra un'automazione n8n e un agente AI? Spiegazione semplice, esempi per piccole attività e una guida su quando usare cosa.
Commenti
Ancora nessun commento. Scrivi il primo.