Salta al contenuto principale

Google Client ID: cos'è e come crearne uno

Scopri cos'è un client ID Google OAuth, dove trovarlo in Google Cloud Console e come creare credenziali per Web, Android e iOS. Risolvi gli errori di accesso più comuni.

Configurazione del client ID Google OAuth in Google Cloud Console per app Web, Android e iOS

Un Client ID OAuth di Google è l'identificatore pubblico dell'app che Google mostra come una stringa che termina con .apps.googleusercontent.com. Lo crei e lo gestisci in Google Cloud Console sotto Google Auth Platform > Client oppure API e servizi > Credenziali. Quel valore indica a Google quale app registrata sta avviando il Sign in with Google o richiedendo token OAuth.

Probabilmente sei qui perché l'integrazione di Google Sign-In doveva essere veloce, e invece ti ritrovi davanti a una schermata di credenziali chiedendoti perché un tipo di app ti fornisca un client secret e un altro no. È un dubbio comune, specialmente se stai sviluppando con Capacitor, Ionic, Electron o uno stack misto web e native.

La parte che la maggior parte delle guide omette è proprio quella che rompe le implementazioni reali: I Google Client ID sono specifici per piattaforma, e i tipi di app non-web spesso non ricevono un client secret per scelta progettuale. Se crei la credenziale sbagliata solo per forzare un secret nel flusso, di solito ti ritrovi con una configurazione OAuth rotta e molto più difficile da debuggare del dovuto.

Indice dei contenuti

Prima che Google ti consenta di creare client OAuth, il progetto deve registrare l'app per Google Auth. Google ti chiede di completare questa operazione quando apri Google Auth Platform > Client per la prima volta.

Passi tipici:

  1. Apri Google Cloud Console e seleziona il progetto che gestirà il sign-in.
  2. Vai su Piattaforma Google Auth (o API e servizi > Schermata di consenso OAuth nella vecchia navigazione).
  3. Usa Esterno oppure Interno tipo di utente, poi inserisci il nome dell'app, l'email di supporto e il contatto dello sviluppatore.
  4. Aggiungi gli scope che la tua app richiederà (per il sign-in di base, email e profile sono comuni).
  5. Salva e prosegui nel flusso della schermata di consenso finché l'app non è registrata.

Il nome dell'applicazione in questa schermata è quello che gli utenti vedono nel prompt di autorizzazione di Google. Deve corrispondere all'app che hanno installato, non a un nome interno.

Come creare un client ID OAuth 2.0

Google documenta il flusso su Gestisci client OAuth pagina di aiuto. Entrambi questi punti di accesso funzionano:

  1. Google Auth Platform > Client (poi CREA CLIENT)
  2. API e servizi > Credenziali (poi Crea credenziali > ID client OAuth)

Seleziona o crea prima un progetto Cloud. Non disperdere le credenziali di autenticazione tra progetti non correlati.

Una persona che digita su un laptop che mostra la console Google Cloud per creare credenziali client OAuth 2.0.

Client per applicazione web

Usa questo tipo per le app browser e per il ID client Web che molti SDK mobile richiedono come audience del server.

  1. Clicca su CREA CLIENT (o crea un ID client OAuth da Credenziali).
  2. Usa Applicazione web come tipo di applicazione.
  3. Imposta Origini JavaScript autorizzate a ogni origine che esegue la tua UI di accesso (schema, host e porta devono corrispondere esattamente). Usa http://localhost:<port> per lo sviluppo locale. Le origini di produzione devono usare HTTPS tranne localhost, secondo le regole di Google.
  4. Imposta URI di reindirizzamento autorizzati a ciascun URL di callback utilizzato dal tuo server o SPA dopo il reindirizzamento di Google.
  5. Clicca su Crea. Copia il ID Client e conserva il Client secret in modo sicuro. Google potrebbe mostrare il segreto solo una volta.

Per le app ibride Capacitor, l'ID client Web supporta spesso la verifica dei token anche quando l'accesso avviene tramite SDK nativi. Vedi Come accedere con Google usando Capacitor per la configurazione mobile completa.

Client Android (package name e SHA-1)

I client OAuth di Android collegano Google Sign-In al tuo nome del pacchetto e il SHA-1 del certificato di firma.

  1. Clicca su CREA CLIENT e seleziona Android.

  2. Inserisci il Nome del package dalla tua app (ad esempio com.example.app, corrispondente a applicationId in Gradle).

  3. Ottieni lo impronta del certificato SHA-1 per il keystore che firma il build che stai testando:

    keytool -list -v -keystore path-to-debug-or-production-keystore -alias your-key-alias

    Per il keystore di debug predefinito, Google segnala che la password è spesso android e il percorso è comunemente ~/.android/debug.keystore.

  4. Incolla l'SHA-1 nel modulo e fai clic su Crea.

  5. Copia l'Android ID Client. Google di solito non hai emette un client secret per questo tipo.

Se l'app è su Google Play, registra anche il Play App Signing SHA-1 da Play Console Integrità dell'app. Play firma di nuovo i rilasci con una chiave diversa rispetto al tuo upload keystore.

Client iOS (bundle ID)

  1. Clicca su CREA CLIENT e seleziona iOS.
  2. Inserisci il Bundle ID da Xcode (lo stesso valore di CFBundleIdentifier nella Info.plist, ad esempio com.example.app).
  3. Aggiungi facoltativamente ID App Store e ID del Team quando Google li richiede.
  4. Clicca su Crea e copia l'ID client iOS ID Client.

Usa questo client con Google Sign-In nativo iOS o con @capgo/capacitor-social-login quando configuri i provider Apple e Google per Capacitor.

Questa guida è un buon riferimento visivo se vuoi confrontare l'interfaccia mentre segui i passaggi:

Dove trovare un client ID esistente

Dopo la creazione, apri Google Auth Platform > Client oppure API e servizi > Credenziali. Ogni riga elenca i Client ID OAuth 2.0 per nome e tipo. Apri un client per copiarne la ID Client stringa (xxxx.apps.googleusercontent.com). I client Web mostrano anche Client secret gestione nella stessa pagina di dettaglio.

La schermata di consenso non è decorativa. Fa parte del perimetro di fiducia. Gli utenti vedono lì il nome della tua applicazione, non il nome interno del progetto.

Client ID vs client secret

Credenziale Chi lo vede Uso tipico
ID Client Pubblico. Sicuro da incorporare in app e front-end. Identifica la tua app presso Google in ogni flusso OAuth.
Client secret Riservato. Solo server o CI. Dimostra che il tuo backend possiede il client Web OAuth durante lo scambio code-for-token.

Google classifica Applicazione web i client che girano sui tuoi server come privati client che possono usare un secret. Android, iOS, e altri installato i client sono pubblico client. Google omette intenzionalmente un secret perché gli utenti possono estrarre qualsiasi cosa inclusa in un APK o IPA.

Non creare un client Web per un'app mobile solo per ottenere un secret. Questo disallineamento causa invalid_client, DEVELOPER_ERROR e fastidiosi errori di audience del token in seguito.

Cos'è un Google Client ID

Un Il client ID di Google OAuth 2.0 è l'identificativo pubblico della tua applicazione nel sistema di autenticazione di Google. Google lo descrive come l'username univoco di un'app quando richiede access token agli endpoint di autenticazione di Google, e precisa che è diverso dalle chiavi API perché viene usato nei flussi OAuth per verificare l'identità dell'app durante lo scambio di token, come spiegato nella documentazione OAuth client di Google Cloud.

Un diagramma che spiega come il Google Client ID funga da identificativo univoco e livello di sicurezza per le applicazioni.

Think of the client ID di Google problemi relativi alla tua app username pubblico.

Comunica a Google che "questa richiesta proviene da questa applicazione registrata". Questo conta durante il sign-in, il consenso, lo scambio di token e qualsiasi flusso in cui la tua app chiede di agire per conto di un utente. Il client ID deve essere referenziato sia dalla tua app sia dai server di autenticazione di Google.

Quello che confonde è che questa credenziale sta accanto ad altri due concetti che non sono intercambiabili.

ID Client identifica l'app in OAuth.
Chiave API identifica un progetto per determinate chiamate API che non richiedono l'autorizzazione delegata dell'utente.
Client secret è la controparte confidenziale usata solo in flussi e tipi di app che possono conservare i segreti in sicurezza.

Molte integrazioni si rompono quando si trattano questi elementi come varianti della stessa cosa. Non lo sono.

Se ti serve Accedi con Google oppure One Tap, il client ID è il valore che il tuo frontend usa per avviare l'handshake di autenticazione. La documentazione di Google precisa inoltre che l'app deve essere registrata in un progetto Cloud Console dedicato prima che la credenziale possa essere generata, e che le app web richiedono origini JavaScript autorizzate o URI di reindirizzamento configurati con schema e hostname completi.

Per i team che sviluppano app ibride, il modello mentale più sicuro è questo:

  • Usa il client ID per identificare l'app
  • Usa la schermata di consenso per presentare l'app all'utente
  • Usa il tipo di app corretto per capire se un secret fa parte del flusso

Se vuoi una panoramica più ampia su come l'identità dell'app e l'accesso delegato si integrano, questa guida sull'autorizzazione delle app è un ottimo ripasso. Per OAuth2 in Capacitor end-to-end, consulta OAuth2 nelle app Capacitor.

Configurazioni Client ID per piattaforma

Il modo più rapido per compromettere la configurazione del login Google è dare per scontato che un singolo client ID possa coprire ogni piattaforma. Non è possibile. Per le app multi-piattaforma, ogni piattaforma deve registrare il proprio client ID OAuth 2.0 distinto; inoltre, la configurazione Android richiede nello specifico il fingerprint SHA1 per verificare la proprietà, come indicato nelle istruzioni di Google per i client Android.

Il tuo prodotto può essere un'unica app per l'utente, ma per Google sono più client OAuth distinti.

Un web app, un build Android, un build iOS, e un app desktop non offrono le stesse proprietà di sicurezza. Google lo gestisce assegnando a ogni piattaforma il proprio modello di registrazione app.

Ecco la suddivisione pratica da seguire:

  • Web usa un client ID web e un matching rigoroso di origin e URI di redirect.
  • Android usa un client ID Android legato all'identità del package e all'impronta SHA1.
  • iOS usa un client ID iOS legato all'identità del bundle dell'app.
  • Desktop o Electron utilizza spesso un pattern OAuth installato o desktop-style anziché un flusso browser basato su secret.

Tipi di Google Client ID a confronto

Tipo di applicazione Identificativo principale Fornisce Client Secret? Caso d'uso principale
Web Origini JavaScript autorizzate e URI di reindirizzamento Di solito sì App browser e web OAuth con supporto backend
Android Package identity e fingerprint SHA1 Spesso no Sign-in nativo Android
iOS Identità del bundle app Spesso no Sign-in nativo iPhone e iPad
Desktop Identità dell'app installata Spesso no App desktop, inclusi i flussi nativi in stile Electron

Il paradosso del client secret per mobile e desktop

Gli sviluppatori mobile e desktop spesso si aspettano che ogni client OAuth includa sia un client ID e a una client secret. Poi creano una credenziale Applicazione Web credential, perché è l’unico modo in cui possono visualizzare un segreto nella console.

Secondo le linee guida sui client OAuth di Google, i tipi di applicazione non web come Android, iOS e le app installate spesso ricevono intenzionalmente un client ID ma nessun client secret, perché Google non vuole un segreto riservato incorporato in software client-side da cui gli utenti possono estrarlo.

Per i team Capacitor, questo di solito si manifesta in uno dei due pattern problematici:

  1. L'app avvia un flusso basato su browser usando un client web e poi cerca di comportarsi come un server confidenziale.
  2. L'app invia un client secret dal code incluso nel bundle, vanificando lo scopo di avere un segreto.

L'approccio migliore è trattare le app mobile e desktop come client pubblici. Se il tuo backend è coinvolto, mantieni le operazioni riservate sul backend e limita l'app nativa a ciò che un client pubblico dovrebbe fare.

Un altro dettaglio sottile conta per il sign-in Android basato su Firebase. In quella configurazione, il client ID di tipo web application viene utilizzato come client ID OAuth del server backend, mentre l'app Android mantiene la propria identità specifica della piattaforma. Svolgono ruoli diversi.

Se devi ricordare una sola regola, usa questa: scegli il tipo di client che corrisponde a dove gira code, non la forma delle credenziali che vorresti avere.

Proteggere le tue credenziali Google API

La maggior parte degli incidenti OAuth non deriva da attacchi complessi. I team fanno trapelare credenziali, allargano troppo le impostazioni di redirect o mettono segreti in posti dove non sono mai stati al sicuro.

Le linee guida OAuth di Google trattano client secrets come credenziali riservate che vanno tenute su server che controlli. Client ID sono identificatori pubblici, ma dovresti comunque registrarli con attenzione. Per le app web, Google verifica il client ID rispetto alle URI di redirect pre-registrate. Se l'URI di redirect non corrisponde esattamente, Google rifiuta la richiesta.

Un professionista seduto a una scrivania che esamina le credenziali di sicurezza su due monitor in ufficio.

Se vuoi fare solo poche cose bene, fai queste:

  • Non includere mai un client secret nel code dell'app. Web bundle, binari mobile e pacchetti Electron sono ispezionabili dagli utenti.
  • Registra gli URI di redirect esatti. L'approssimazione non basta. Google richiede corrispondenze esatte per i web flow.
  • Mantieni le origin ristrette. Non autorizzare domini ampi solo per superare gli attriti della configurazione.
  • Separa le credenziali per piattaforma. Non farti spingere dalla comodità a usare un'unica credenziale per Android, iOS e web.

I team che restano fuori dai guai trattano le credenziali OAuth come qualsiasi altro segreto di produzione. Tengono i client secret web sul backend, li iniettano tramite la gestione degli ambienti e verificano chi ha accesso alla console. Se stai ripulendo la tua release pipeline, questa guida su gestire i segreti nelle pipeline CI/CD merita di essere applicata anche al tuo setup di auth.

Risoluzione dei comuni errori del Client ID

La maggior parte dei fallimenti di Google OAuth deriva da un piccolo set di errori di configurazione. Il messaggio di errore non è sempre chiaro, ma il problema di fondo è solitamente semplice una volta capito dove guardare.

redirect_uri_mismatch

La tua app sta inviando una redirect URI che non corrisponde esattamente a quella registrata per quel web client. Controlla scheme, host, path ed eventuali differenze finali.

invalid_client

Di solito significa che l'app sta inviando il client ID sbagliato, il secret errato per quel client, o che sta mescolando le credenziali tra piattaforme.

origin_mismatch (Flussi JavaScript)

L'origine della pagina non è elencata sotto Origini JavaScript autorizzate per il Web client.

È richiesto almeno un client id quando il sign-in Google è abilitato (dashboard come Supabase, Firebase e simili)

L'interruttore del provider è attivo ma il ID client Web campo è vuoto o incollato dal progetto sbagliato. Crea i client OAuth in Google Cloud Console. Per Supabase, inserisci gli ID client Web, Android e iOS come elenco separato da virgole, con l'ID client Web per primo, quando rilasci quelle piattaforme. Configura i client nativi, poi salva. Per Supabase con Capacitor, segui Configurazione del social login di Capacitor con Supabase.

DEVELOPER_ERROR, errore 10, o l'accesso funziona in debug ma fallisce in produzione su Android

Il client OAuth Android manca oppure la coppia package name / SHA-1 non corrisponde al keystore che ha firmato l'APK usato dagli utenti. Aggiungi l'impronta del certificato di Play App Signing per le build dello store. Verifica che il tuo plugin usi il ID client Web dove SDK si aspetta un server client ID, come descritto nella documentazione di Capgo Social Login.

Google Sign-In funziona sul web ma fallisce su mobile

Controlla prima il tipo di client. Una credenziale web non può sostituire un client Android o iOS per i flussi nativi.

La schermata di consenso sembra sbagliata

Verifica il nome dell'app e il branding nella schermata di consenso OAuth in Google Cloud Console.

L'ordine pratico per il debugging è semplice: controlla prima il tipo di client, poi reindirizza le impostazioni, poi gli identificativi della piattaforma e infine se un segreto debba far parte del flusso.

FAQ

Il client ID Web e il client ID Android devono appartenere allo stesso progetto Google Cloud?

Sì. Per Google Sign-In su Android, crea il client Android (nome pacchetto e SHA-1) e il client Web application nello stesso progetto Google Cloud. L'app passa l'ID client Web come server client ID, e Google verifica che il client Android appartenga allo stesso progetto. Un mismatch è una causa comune di DEVELOPER_ERROR. Il plugin di social login Capgo la documentazione mostra la configurazione.

Cos'è un Google client ID?

È l'identificativo pubblico OAuth 2.0 che Google assegna quando crei le credenziali per la tua app. Di solito appare così: 123456789012-abcdefg.apps.googleusercontent.comGoogle lo utilizza ogni volta che l'app avvia "Sign in with Google" o scambia i codici di autorizzazione con i token.

Dove trovo il mio Google client ID?

In Google Cloud Console, apri Google Auth Platform > Client oppure API e servizi > Credenziali, quindi apri il tuo client OAuth 2.0. Il ID Client campo contiene la stringa completa da copiare.

I client Android e iOS includono un client secret?

Di solito no. Le app installate sono client OAuth pubblici. Usa un client secret solo su un server che controlli, di solito con un Applicazione web client OAuth.

Perché il mio backend dice che è richiesto almeno un client id?

Il sign-in di Google è abilitato nel dashboard, ma non è salvato alcun client ID. Crea i client OAuth in Google Cloud Console e incolla almeno il client ID Web nella configurazione del provider prima di abilitare la funzione per gli utenti.

Come si risolve DEVELOPER_ERROR su Android?

Registra un client OAuth Android con il package name corretto e la SHA-1 della chiave di firma sul dispositivo. Se distribuisci tramite Google Play, includi la SHA-1 di Play App Signing. Allinea il client ID Web a quello che il tuo auth SDK si aspetta.

Posso riutilizzare lo stesso client ID su tutte le piattaforme?

No. Crea client OAuth separati per Web, Android e iOS. Le app Capacitor configurano spesso tutti e tre, anche quando gli utenti vedono un unico prodotto.


Se il tuo team rilascia app Capacitor o Electron, i bug di auth raramente restano isolati. Di solito emergono insieme alla pressione dei rilasci, alla necessità di rollback e alle correzioni specifiche dell'ambiente. Capgo aiuta i team a pubblicare aggiornamenti mirati per app code e asset senza attendere la revisione degli store, rendendo molto più semplice correggere i flussi di login, la gestione dei callback e i problemi di autenticazione lato client quando finiscono in produzione.

Live updates per le app Capacitor

Quando un bug nel web-layer è live, rilascia la fix tramite Capgo invece di aspettare giorni l'approvazione degli store. Gli utenti ricevono l'update in background, mentre le modifiche native restano nel normale processo di review.

Ultimi articoli dal blog

Capgo ti offre gli insight migliori che ti servono per creare un'app mobile davvero professionale.