Supabase Apple Login - Configurazione generale

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Panoramica

Questa guida ti aiuterà a integrare Apple Sign-In con Supabase Authentication. Apple Sign-In offre un metodo di autenticazione sicuro e orientato alla privacy, compatibile con iOS, Android e Web.

Prerequisiti

Prima di iniziare, assicurati di aver:

Creato un progetto Supabase
Leggi la Configurazione generale di Apple Login guida alla configurazione delle credenziali Apple OAuth
Segui le guide specifiche per ogni piattaforma per configurare le credenziali Apple OAuth per il tuo target:
Prima di iniziare il tutorial di Supabase, devi generare i client ID per le piattaforme che intendi utilizzare.
Per iOS, il client ID è lo stesso del tuo app ID. Per Android e Web, il client ID è lo stesso del tuo service ID. Ti serviranno al punto 7 di questa guida.

Abilitare il provider Apple OAuth in Supabase

Vai alla tua Dashboard di Supabase
Clicca sul tuo progetto
Do go to the Authentication menu
Clicca sul Providers scheda
Trova il Apple provider
Abilita il Apple provider
Fill in the client ID configuration:

Se utilizzi l'accesso con Apple su iOS, il client ID coincide con il tuo app ID. Se utilizzi l'accesso con Apple su Android o Web, il client ID coincide con il tuo service ID. Se utilizzi entrambi, devi fornire sia l'app ID che il service ID.
Clicca sul Save pulsante

Tu NON È NECESSARIO configurare Secret key (for OAuth). Implementeremo un backend custom per gestire l'accesso con Apple.

Fatto! Hai abilitato Apple Sign-In con Supabase Authentication 🎉

Utilizzo dell'Authentication Helper

L'implementazione completa include una funzione helper authenticateWithAppleSupabase() che gestisce l'intero flusso di Apple Sign-In con Supabase. Questa funzione:

Inizializza Apple Sign-In con la configurazione specifica della piattaforma
Gestisce il flusso di autenticazione (native su iOS, redirect OAuth su Android/Web)
Estrae l'identity token da Apple
Effettua il login su Supabase con l'identity token

Utilizzo base

import { authenticateWithAppleSupabase } from './supabaseAuthUtils';

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

Come funziona

La funzione helper gestisce automaticamente le differenze tra le piattaforme:

iOS: Utilizza l'Apple Sign-In nativo (non serve una redirect URL, usa automaticamente il bundle ID)
Android: Utilizza il flusso di redirect OAuth con una backend edge function (richiede un Service ID)
Web: Utilizza il flusso OAuth tramite popup (richiede Service ID e l'URL della pagina corrente come redirect)

La funzione restituisce un identity token da Apple, che viene poi usato per l'autenticazione con Supabase tramite supabase.auth.signInWithIdToken().

Se stai usando Supabase Apple Login - Configurazione generale 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.