perfetti.tech

Service Account vs OAuth per Google Sheets in n8n

Yuri Perfetti4 min di lettura1 lettura
Due chiavi davanti a un foglio di calcolo: una con la testa di un robot, una con la sagoma di una persona

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:

  1. Google Cloud Console → il tuo progetto → IAM e amministrazione → Service Account → Crea
  2. 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)
  3. Abilita le API di Google Sheets (e Drive, se serve) nel progetto
  4. In n8n: credenziale di tipo "Google Service Account", incolli email del service account e chiave privata dal JSON
  5. 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.

Condividi

Hai un problema simile?

Mandami due righe: ti dico se ha senso trasformarlo in uno strumento vero e quanto tempo serve.

Scrivimi

Altri articoli

Commenti

Ancora nessun commento. Scrivi il primo.

Lascia un commento

Nome e commento vengono pubblicati sotto l'articolo. Dettagli nella Privacy Policy.

Questo sito è protetto da reCAPTCHA: si applicano la Privacy Policy e i Termini di servizio di Google.

Tutti gli articoli