Supabase Google Login su iOS
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Introduzione
Sezione intitolata “Introduzione”Questa guida ti aiuta a integrare Google Sign-In con Supabase Authentication su iOS. Si presume che tu abbia già completato:
Implementazione
Sezione intitolata “Implementazione”L'implementazione completa è disponibile in dell'app di esempio supabaseAuthUtils.ts file. Questa guida spiega i concetti chiave e come usarlo.
Utilizzo dell'Authentication Helper
Sezione intitolata “Uso dell'Authentication Helper”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);}Come funziona
Sezione intitolata “Come funziona”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.
Avvertenze importanti
Sezione intitolata “Avvertenze importanti”Problemi di caching del token e nonce su iOS
Sezione intitolata “Caching dei token e problemi di nonce su iOS”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:
- Rilevamento automatico: la funzione verifica se il nonce nel token corrisponde a quello atteso
nonceDigest - Retry automatico: se la convalida fallisce, esegue automaticamente il logout da Google e riprova una volta
- 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 tokensawait SocialLogin.logout({ provider: 'google' });
// Then authenticateconst 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.
Note importanti
Sezione intitolata “Note importanti”Gestione del nonce
Sezione intitolata “Gestione del nonce”L'implementazione del nonce segue il pattern della documentazione di React Native Google Sign In:
rawNonceviene inviato a SupabasesignInWithIdToken()- Supabase crea un hash di
rawNoncee lo confronta con ilnonceDigestche è incluso nell'ID token di Google Sign-In nonceDigest(hash SHA-256, codificato in esadecimale) va nelnonceparametro nelle API di Google Sign-In
Meccanismo di retry automatico
Sezione intitolata “Meccanismo di retry automatico”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.
Risoluzione problemi
Sezione intitolata “Troubleshooting”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
Continua da Supabase Google Login su iOS
Sezione intitolata “Continua da Supabase Google Login su iOS”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.