Supabase Google Login su iOS

Introduzione

Questa guida ti aiuterà ad integrare Google Sign-In con l'autenticazione Supabase su iOS. Si presume che tu abbia già completato:

• il setup di Google Login per iOS
• il setup generale di Google Login per Supabase.

Impostazione

L'implementazione completa è disponibile nel file dell'applicazione di esempio. Questa guida spiega i concetti chiave e come utilizzarla. supabaseAuthUtils.ts Utilizzo dell'helper di autenticazione

file dell'app di esempio. Questa guida spiega i concetti chiave e come utilizzarla.

Il authenticateWithGoogleSupabase funzione 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

Per una spiegazione dettagliata di come funziona il flusso di autenticazione, compresa la generazione di nonce, la validazione di JWT e l’accesso a Supabase, vedere la sezione Come Funziona nella guida di configurazione generale.

Caveats importanti

Problemi di caching dei token iOS e nonce

Issue di caching nonce su iOS

Sul dispositivo iOS, Google Sign-In può memorizzare i token, il che può causare il fallimento della validazione della nonce. Il validateJWTToken funzione rileva questo e lo gestisce automaticamente:

1. Rilevamento automatico: La funzione controlla se la nonce nel token corrisponde a quella attesa nonceDigest
2. Ritentativo automatico: Se la validazione fallisce, si esce automaticamente da Google e si tenta nuovamente una volta
3. Gestione degli errori: Se anche il ritentativo fallisce, viene restituito un errore

Perché succede: Google Sign-In su iOS SDK memorizza i token per migliorare le prestazioni. Quando viene restituito un token memorizzato, potrebbe essere stato generato con una nonce diversa (o nessuna nonce), causando un disallineamento.

La soluzione: L'implementazione gestisce automaticamente questo problema loggando fuori e riprovando, il che costringe Google a generare un nuovo token con il nonce corretto.

Manuale Workaround (se la riprova automatica non funziona):

// Logout first to clear cached tokens
await SocialLogin.logout({ provider: 'google' });

// Then authenticate
const result = await authenticateWithGoogleSupabase();

Questo garantisce che venga ottenuto un nuovo token con il nonce corretto.

Per la documentazione completa code vedere la sezione "Documentazione completa code" nella guida di configurazione generale Complete Code Reference section in the General Setup guide.

Sottosezione intitolata "Note importanti"

Sottosezione intitolata "Gestione del nonce"

__CAPGO_KEEP_0__ documentazione di React Native Google Sign In:

• rawNonce va a Supabase’s signInWithIdToken()
• Supabase crea un hash di rawNonce e lo confronta con il nonceDigest che è incluso nel token ID da Google Sign-In
• nonceDigest (hash SHA-256, codificato in esadecimale) va al nonce parametro in Google Sign-In APIs

Mechanismo di Risorsa Automatica

Il authenticateWithGoogleSupabase funzione include un retry parametro:

• Prima chiamata (retry=false): Se la validazione fallisce, si esegue automaticamente il logout e si riprova una volta
• Riprovare la chiamata (retry=true): Se la validazione fallisce nuovamente, restituisce immediatamente un errore

Questo gestisce automaticamente il problema di caching dei token iOS.

Risoluzione dei problemi

Mancanza di nonce

• : La funzione si riprova automaticamente - controlla i log del console per ulteriori dettagli. Se persiste, effettua il logout manuale primaAudience non valido
• : Verifica che gli ID Client Google siano sincronizzati in entrambi Google Cloud Console e Supabase (entrambi gli ID client iOS e Web)Troubleshooting
• La validazione del token fallisce: Assicurati di utilizzare mode: 'online' in l'istanza di inizializzazione per ottenere un idToken
• Configurazione di Info.plist: Assicurati che Info.plist abbia i corretti schemi di URL e GIDClientID
• Recensisci l'applicazione di esempio __CAPGO_KEEP_0__ example app code Continua da Supabase Google Login on iOS

Sottosezione intitolata “Continua da Supabase Google Login on iOS”

Supabase Google Login on iOS Supabase Google Login on iOS per pianificare l'autenticazione e le flussi di account, connettilo con Usando @capgo/capacitor-login-social per la capacità nativa in Usando @capgo/capacitor-login-social, @capgo/capacitor-login-social per il dettaglio di implementazione in @capgo/capacitor-login-social, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-biometric-nativo per il dettaglio di implementazione in @capgo/capacitor-biometric-nativo, e L'autenticazione a due fattori per il dettaglio di implementazione in L'autenticazione a due fattori.