웹에서 Supabase Google Login
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
소개
“소개” 섹션이 가이드는 웹 환경에서 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);}중요: 리다이렉트 처리
“중요: 리다이렉트 처리” 섹션중요: 리다이렉트 처리
웹에서 Google 로그인을 사용할 때는 반드시 리다이렉트 발생 시 플러그인의 함수를 호출하여 플러그인을 초기화해야 합니다. 그래야 리다이렉트를 처리하고 팝업 창을 닫을 수 있습니다. 다음 중 하나를 호출하면 됩니다. isLoggedIn() 또는 initialize() - 두 방법 모두 리다이렉트 처리를 트리거합니다.
OAuth 팝업 플로우가 정상적으로 작동하려면 이 과정이 필수적입니다.
구현 예시
“구현 예시” 섹션Google Sign-In을 처리하는 컴포넌트에 다음 코드를 추가하세요:
import { useEffect } from 'react';import { SocialLogin } from '@capgo/capacitor-social-login';
function SupabasePage() { // Check Google login status on mount to invoke redirect handling // This doesn't serve any functional purpose in the UI but ensures // that any pending OAuth redirects are properly processed useEffect(() => { const checkGoogleLoginStatus = async () => { try { await SocialLogin.isLoggedIn({ provider: 'google' }); // We don't use the result, this is just to trigger redirect handling } catch (error) { // Ignore errors - this is just for redirect handling console.log('Google login status check completed (redirect handling)'); } };
checkGoogleLoginStatus(); }, []);
// ... rest of your component}참고하세요: 예제 앱의 SupabasePage.tsx 전체 예시를 확인하려면 참고하세요.
작동 원리
“How It Works” 섹션nonce 생성, JWT 검증, Supabase 로그인 등 인증 흐름에 대한 자세한 설명은 General Setup 가이드의 How It Works 섹션을 확인하세요.
전체 code 레퍼런스는 General Setup 가이드의 Complete Code Reference 섹션을 확인하세요.
다음 내용도 참고하세요:
- SupabasePage.tsx - 리다이렉트 처리가 포함된 예시 컴포넌트
- SupabaseCreateAccountPage.tsx - 계정 생성 페이지 예시
주의사항
“중요 사항” 섹션리다이렉트 처리
“Redirect Handling” 섹션웹에서 Google 로그인을 사용할 때는 반드시 리다이렉트 발생 시 플러그인의 함수를 호출하여 플러그인을 초기화해야 합니다. 그래야 플러그인이 리다이렉트를 처리하고 팝업 창을 닫을 수 있습니다. 다음 중 하나를 호출하면 됩니다. isLoggedIn() 또는 initialize() - 둘 다 리다이렉트 처리를 트리거합니다.
OAuth 팝업 흐름이 올바르게 작동하려면 이 과정이 필수적입니다. 이 설정이 없으면 인증 후에도 팝업 창이 닫히지 않습니다.
Nonce 처리
“Nonce 처리” 섹션nonce 구현은 다음 패턴을 따릅니다: React Native Google Sign In 문서:
rawNonceSupabase의signInWithIdToken()- Supabase는 다음을 해싱합니다:
rawNonce및 이를 다음 값과 비교합니다:nonceDigestGoogle Sign-In의 ID token에 포함된 값 nonceDigest(SHA-256 해시, hex 인코딩)은 Google Sign-In API의nonce파라미터로 전달됩니다
자동 재시도
“자동 재시도” 섹션구현에는 자동 재시도 로직이 포함되어 있습니다:
- 첫 시도에서 JWT 검증이 실패하면 로그아웃하고 한 번 재시도합니다.
- 캐시된 토큰의 nonce가 잘못된 경우를 처리합니다.
- 재시도마저 실패하면 에러를 반환합니다.
문제 해결
“문제 해결” 섹션인증에 실패하는 경우:
- 리다이렉트가 작동하지 않을 때: 다음 함수를 호출하고 있는지 확인하세요
isLoggedIn()컴포넌트 마운트 시점에 (위 예시 참고) - 잘못된 audience: Google Cloud Console과 Supabase 양쪽에서 Google Client ID가 일치하는지 확인하세요
- 승인된 리다이렉트 URL: Google Cloud Console과 Supabase 양쪽에 승인된 리다이렉트 URL이 설정되어 있는지 확인하세요
- Nonce 불일치: 콘솔 로그를 확인하세요. 함수가 자동으로 재시도하지만, 필요하면 먼저 수동으로 로그아웃해도 됩니다.
- Token 검증 실패: 다음을 사용 중인지 확인하세요:
mode: 'online'idToken을 받으려면 initialize 호출에서 - 다음을 참고하세요: 예제 앱 code 참고용
Web에서 Supabase Google Login 계속하기
“웹에서 Supabase Google Login 후 계속하기” 섹션사용 중이라면 웹에서 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단계 인증의 구현 세부 사항에 대해서는