Setup Supabase Apple Login di iOS

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

Prerequisites

Panduan ini akan membantu Anda mengintegrasikan Apple Sign-In dengan Supabase Authentication di iOS. Kami mengasumsikan Anda telah menyelesaikan:

halaman Setup Apple Login iOS
halaman Supabase Apple Login - Setup Umum.

Implementasi

Implementasi lengkapnya tersedia di aplikasi contoh supabaseAuthUtils.ts file. Panduan ini menjelaskan konsep utama dan cara menggunakannya.

Menggunakan Authentication Helper

Panduan authenticateWithAppleSupabase fungsi menangani seluruh alur autentikasi:

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);
}

Cara Kerjanya

Di iOS, Apple Sign-In menggunakan implementasi native:

Inisialisasi: Plugin ini otomatis menggunakan bundle ID aplikasi Anda (tidak clientId dibutuhkan)
Native Sign-In: Menggunakan tombol Sign in with Apple native dan alur autentikasi Apple
Token Identitas: Apple mengembalikan identity token (JWT) yang berisi informasi pengguna
Autentikasi Supabase: Identity token dikirim ke Supabase menggunakan signInWithIdToken()

Fungsi helper otomatis mendeteksi platform iOS dan mengonfigurasi semuanya dengan tepat.

Catatan Penting

Konfigurasi Bundle ID

iOS otomatis menggunakan bundle ID aplikasi Anda untuk Apple Sign-In
Pastikan bundle ID Anda sesuai dengan yang dikonfigurasi di Apple Developer Portal
Bundle ID harus memiliki capability “Sign in with Apple” yang aktif

ID Client Supabase

Di Supabase, konfigurasikan provider Apple Anda dengan:

Client ID: iOS App ID Anda (bundle ID) - contohnya, app.capgo.plugin.SocialLogin

Jika Anda juga menggunakan Android/Web, Anda perlu memasukkan App ID dan Service ID di kolom Client ID Supabase (pisahkan dengan koma).

Pemecahan Masalah

Jika autentikasi gagal:

Bundle ID tidak cocok: Pastikan bundle ID cocok di Xcode dan Apple Developer Portal
Capability belum diaktifkan: Pastikan capability “Sign in with Apple” sudah aktif di Xcode
Konfigurasi Supabase: Pastikan App ID sudah dikonfigurasi dengan benar di pengaturan provider Apple di Supabase
Validasi token gagal: Pastikan identity token diterima dari Apple
Tinjau aplikasi contoh code sebagai referensi

Jika Anda menggunakan Setup Supabase Apple Login di iOS untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-social-login untuk kapabilitas native di Menggunakan @capgo/capacitor-social-login, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric, dan Autentikasi dua faktor untuk detail implementasi di autentikasi dua faktor.