Supabase Apple Login – iOS Setup
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Voraussetzungen
Abschnitt: „Voraussetzungen“Diese Anleitung hilft dir bei der Integration von Apple Sign-In mit Supabase Authentication unter iOS. Wir gehen davon aus, dass du Folgendes bereits erledigt hast:
Implementierung
Abschnitt „Implementierung“Die vollständige Implementierung findest du im der Beispiel-App supabaseAuthUtils.ts Datei. Dieser Guide erklärt die wichtigsten Konzepte und wie du sie verwendest.
Verwendung des Authentication Helpers
Abschnitt mit dem Titel „Verwendung des Authentication Helpers“Der authenticateWithAppleSupabase Funktion übernimmt den gesamten Authentication-Flow:
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);}So funktioniert es
Abschnitt „So funktioniert es“Unter iOS nutzt Apple Sign-In die native Implementierung:
- Initialisierung: Das Plugin verwendet automatisch die Bundle ID deiner App (kein
clientIdbenötigt) - Natives Sign-In: Nutzt Apples nativen „Sign in with Apple“-Button und Authentifizierungs-Flow
- Identity-Token: Apple liefert einen Identity Token (JWT) mit Benutzerinformationen zurück
- Supabase-Authentifizierung: The identity token is sent to Supabase using
signInWithIdToken()
Die Helper-Funktion erkennt die iOS-Plattform automatisch und konfiguriert alles passend.
Wichtige Hinweise
Abschnitt mit dem Titel „Wichtige Hinweise“Bundle-ID-Konfiguration
Abschnitt mit dem Titel „Bundle-ID-Konfiguration“- iOS verwendet automatisch die Bundle ID deiner App für Apple Sign-In
- Stelle sicher, dass deine Bundle ID mit der Konfiguration im Apple Developer Portal übereinstimmt
- Die Bundle ID muss die „Sign in with Apple“-Capability aktiviert haben
Supabase Client ID
Abschnitt mit dem Titel „Supabase Client ID“Konfiguriere deinen Apple-Provider in Supabase mit:
- Client-ID: Deine iOS App ID (Bundle ID) – z. B.
app.capgo.plugin.SocialLogin
Falls du auch Android/Web nutzt, musst du sowohl die App ID als auch die Service ID im Client-ID-Feld von Supabase angeben (kommagetrennt).
Fehlerbehebung
Abschnitt mit dem Titel „Troubleshooting“Falls die Authentifizierung fehlschlägt:
- Bundle ID stimmt nicht überein: Prüfe, ob die Bundle ID in Xcode und im Apple Developer Portal übereinstimmt
- Capability nicht aktiviert: Stelle sicher, dass die „Sign in with Apple“-Capability in Xcode aktiviert ist
- Supabase-Konfiguration: Prüfe, ob deine App ID in den Apple-Provider-Einstellungen von Supabase korrekt konfiguriert ist
- Token-Validierung schlägt fehl: Prüfe, ob das Identity Token von Apple empfangen wird
- Überprüfe die Beispiel-App code als Referenz
Weiter mit: Supabase Apple Login für iOS einrichten
Abschnitt mit dem Titel „Weiter mit dem Supabase Apple Login Setup auf iOS“Wenn du es nutzt Supabase Apple Login – iOS Setup Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-social-login verwenden für die native Funktion bei der Verwendung von @capgo/capacitor-social-login, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, und Zwei-Faktor-Authentifizierung für die Implementierungsdetails zur Zwei-Faktor-Authentifizierung.