Vai al contenuto

Supabase Google Login su iOS

GitHub

Questa guida ti aiuta a integrare Google Sign-In con Supabase Authentication su iOS. Si presume che tu abbia già completato:

L'implementazione completa è disponibile in dell'app di esempio supabaseAuthUtils.ts file. Questa guida spiega i concetti chiave e come usarlo.

Il authenticateWithGoogleSupabase gestisce l'intero flusso di autenticazione:

import { authenticateWithGoogleSupabase } from './supabaseAuthUtils';
const result = await authenticateWithGoogleSupabase();
if (result.success) {
console.log('Signed in:', result.user);
// Navigate to your authenticated area
} else {
console.error('Error:', result.error);
}

Per una spiegazione dettagliata del flusso di autenticazione, inclusi la generazione del nonce, la validazione del JWT e l'accesso tramite Supabase, consulta la sezione Come funziona nella guida Configurazione generale.

Problema di caching del nonce su iOS

Su iOS, Google Sign-In può mettere in cache i token, il che può far fallire la convalida del nonce. La validateJWTToken funzione rileva questa situazione e la gestisce automaticamente:

  1. Rilevamento automatico: la funzione verifica se il nonce nel token corrisponde a quello atteso nonceDigest
  2. Retry automatico: se la convalida fallisce, esegue automaticamente il logout da Google e riprova una volta
  3. Gestione degli errori: se anche il retry fallisce, viene restituito un errore

Perché succede: il Google Sign-In per iOS SDK memorizza i token in cache per le prestazioni. Quando viene restituito un token in cache, potrebbe essere stato generato con un nonce diverso (o senza nonce), causando un mismatch.

La soluzione: l'implementazione gestisce automaticamente questo problema eseguendo il logout e riprovando, costringendo Google a generare un token fresco con il nonce corretto.

Workaround manuale (se il retry automatico non funziona):

// Logout first to clear cached tokens
await SocialLogin.logout({ provider: 'google' });
// Then authenticate
const result = await authenticateWithGoogleSupabase();

Ciò garantisce che venga ottenuto un token fresco con il nonce corretto.

Per il riferimento completo a code, consulta la Sezione Riferimento completo a Code nella guida Configurazione generale.

L'implementazione del nonce segue il pattern della documentazione di React Native Google Sign In:

  • rawNonce viene inviato a Supabase signInWithIdToken()
  • Supabase crea un hash di rawNonce e lo confronta con il nonceDigest che è incluso nell'ID token di Google Sign-In
  • nonceDigest (hash SHA-256, codificato in esadecimale) va nel nonce parametro nelle API di Google Sign-In

Il authenticateWithGoogleSupabase la funzione include un retry parametro:

  • Prima chiamata (retry=false): se la convalida fallisce, esegue automaticamente il logout e riprova una volta
  • Chiamata di retry (retry=true): se la convalida fallisce di nuovo, restituisce immediatamente un errore

Questo gestisce automaticamente il problema di caching dei token su iOS.

Se l'autenticazione fallisce:

  • Nonce non corrispondente: la funzione riprova automaticamente - controlla i log della console per i dettagli. Se il problema persiste, fai prima il logout manualmente
  • Audience non valida: verifica che i Google Client ID corrispondano sia in Google Cloud Console sia in Supabase (sia gli ID client iOS che Web)
  • Validazione del token fallita: assicurati di usare mode: 'online' nella chiamata initialize per ottenere un idToken
  • Configurazione Info.plist: assicurati che Info.plist abbia gli URL scheme corretti e GIDClientID
  • Consulta l' app di esempio code come riferimento

Se stai usando Supabase Google Login su iOS per pianificare i flussi di autenticazione e account, collegandolo a Utilizzo di @capgo/capacitor-social-login per la funzionalità nativa in Utilizzo di @capgo/capacitor-social-login, @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per i dettagli sull'implementazione dell'autenticazione a due fattori.