본문 바로가기

iOS에서 Supabase Google Login

GitHub

이 가이드는 iOS에서 Google Sign-In을 Supabase Authentication과 통합하는 방법을 안내합니다. 다음 단계는 이미 완료했다고 가정합니다:

구현 방법

“구현” 섹션

전체 구현 코드는 예제 앱의 supabaseAuthUtils.ts 파일에서 확인할 수 있습니다. 이 가이드에서는 핵심 개념과 사용 방법을 설명합니다.

Authentication Helper 사용하기

“Authentication Helper 사용” 섹션

이 authenticateWithGoogleSupabase 함수는 전체 인증 흐름을 처리합니다:

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

nonce 생성, JWT 검증, Supabase 로그인 등 인증 플로우의 상세한 작동 원리는 General Setup 가이드의 How It Works 섹션을 참고하세요.

중요 유의 사항

“Important Caveats” 섹션

iOS 토큰 캐싱 및 Nonce 이슈

“iOS Token Caching and Nonce Issues” 섹션

iOS Nonce 캐싱 문제

iOS에서는 Google Sign-In이 토큰을 캐시하여 nonce 검증이 실패할 수 있습니다. validateJWTToken 함수가 이를 감지하고 자동으로 처리합니다:

  1. 자동 감지: 토큰의 nonce가 예상 값과 일치하는지 확인합니다 nonceDigest
  2. 자동 재시도: 검증에 실패하면 Google에서 자동으로 로그아웃한 뒤 한 번 재시도합니다
  3. 에러 핸들링: 재시도도 실패하면 오류를 반환합니다

발생 원인: iOS Google Sign-In SDK은 성능을 위해 토큰을 캐시합니다. 캐시된 토큰이 반환되면 다른 nonce(또는 nonce 없음)로 생성되었을 수 있어 불일치가 발생합니다.

해결 방법: 로그아웃 후 재시도하여 Google이 올바른 nonce로 새 토큰을 생성하도록 강제하는 방식으로 자동으로 처리합니다.

수동 우회 방법 (자동 재시도가 작동하지 않을 경우):

// Logout first to clear cached tokens
await SocialLogin.logout({ provider: 'google' });
// Then authenticate
const result = await authenticateWithGoogleSupabase();

이로써 올바른 nonce와 함께 새로운 토큰이 발급되도록 보장합니다.

전체 code 레퍼런스는 다음을 참고하세요. General Setup 가이드의 Complete Code Reference 섹션.

nonce 구현은 다음 패턴을 따릅니다. React Native Google Sign In 문서:

  • rawNonce Supabase의 signInWithIdToken()
  • Supabase는 rawNonce 그리고 이를 다음과 비교합니다 nonceDigest Google Sign-In의 ID 토큰에 포함된
  • nonceDigest (SHA-256 해시, hex 인코딩)은 Google Sign-In API의 nonce 파라미터로 전달됩니다

자동 재시도 메커니즘

“자동 재시도 메커니즘” 섹션

이 authenticateWithGoogleSupabase 함수에는 retry 파라미터가 있습니다:

  • 첫 번째 호출 (retry=false): 검증에 실패하면 자동으로 로그아웃하고 한 번 재시도합니다.
  • 재시도 호출 (retry=true): 검증에 다시 실패하면 즉시 에러를 반환합니다.

이 방식은 iOS 토큰 캐싱 문제를 자동으로 해결합니다.

인증에 실패하는 경우:

  • Nonce 불일치: 함수가 자동으로 재시도합니다 - 자세한 내용은 콘솔 로그를 확인하세요. 문제가 지속되면 먼저 수동으로 로그아웃하세요
  • 잘못된 audience: Google Cloud Console과 Supabase(모두 iOS 및 Web 클라이언트 ID)에서 Google Client ID가 일치하는지 확인하세요
  • Token 검증 실패: 다음을 사용 중인지 확인하세요: mode: 'online' idToken을 받으려면 initialize 호출에서
  • Info.plist 설정: Info.plist에 올바른 URL 스킴과 GIDClientID가 있는지 확인하세요
  • 다음을 참고하세요: 예제 앱 code 참고용

iOS에서 Supabase Google Login 계속 진행하기

“iOS에서 Supabase Google 로그인 계속하기” 섹션

사용 중이라면 iOS에서 Supabase Google Login 인증 및 계정 흐름을 설계할 때, 이를 다음 항목과 연결하세요: @capgo/capacitor-social-login 사용하기 @capgo/capacitor-social-login 사용 시 네이티브 기능을 위해, @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 사항은, @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 사항은 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric의 구현 세부 사항은, 2단계 인증 2단계 인증의 구현 세부 사항에 대해서는