5-2. 소셜 로그인 (OAuth)
앞 클립(5-1)에서 데이터를 진짜 DB에 쌓고, 마지막에 RLS(줄 단위 보안)로 "내 데이터만 보이게" 잠가 두며 끝냈죠. 그런데 그 잠금장치엔 빠진 조각이 하나 있었어요. "이 줄의 주인이 누구냐"를 정해 줄 '로그인'입니다. 이번 클립이 바로 그 조각을 끼웁니다. 무서운 건 보안인데, 다행히 우리는 비밀번호를 직접 만들지도, 보관하지도 않습니다. 구글·카카오에게 "이 사람 맞아?"를 대신 물어보는 방식(소셜 로그인)을 쓰거든요. 오늘의 한 줄도 똑같습니다. 로그인 보안을 직접 만들지 말고, 에이전트와 Supabase에 시킨다.
1. OAuth, 한 문장으로 — "비밀번호 대신 '확인'을 빌린다"
소셜 로그인 글마다 등장하는 단어가 OAuth(오스, 오어쓰)입니다. 이름은 낯설지만 원리는 정말 단순해요. 한 장면으로 그려 보겠습니다.
즉 우리 앱은 사용자의 비밀번호를 한 번도 보지 않습니다. "구글로 로그인" 버튼을 누르면, 사용자는 익숙한 구글 화면에서 로그인하고, 구글이 우리 앱에게 "이 사람 본인 맞아요, 이메일은 이거예요"라고 살짝 알려 줄 뿐이죠. 비밀번호라는 가장 위험한 물건을 우리가 만지지 않는다 — 이것이 OAuth의 핵심입니다.
2. 왜 소셜 로그인을 쓰나 — 보안↓·전환율↑·관리부담↓
직접 "아이디 + 비밀번호" 가입을 만들 수도 있습니다. 하지만 비개발자가 처음 만드는 서비스라면, 소셜 로그인이 거의 항상 더 나은 선택입니다. 이유가 셋이에요.
① 보안 위험이 확 줄어든다
비밀번호를 우리가 보관하지 않으니, 해킹당해 비번이 새어 나갈 일 자체가 없습니다. "비밀번호를 안전하게 암호화해서 저장하는" 어려운 일을 구글·카카오가 대신 책임져 주는 셈이에요. 초보자가 가장 사고 치기 쉬운 부분을 통째로 넘기는 거죠.
② 가입 전환율이 올라간다
사용자 입장에선 버튼 한 번이면 끝입니다. 새 이메일·새 비번을 만들고 인증메일을 기다리는 번거로움이 없어요. 가입 단계가 짧을수록 중간에 떠나는 사람이 줄고, 실제로 가입을 끝내는 비율(전환율)이 올라갑니다.
③ 관리 부담이 사라진다
"비밀번호를 잊었어요" 처리, 비번 재설정 메일, 비번 규칙 검사… 직접 만들면 끝없이 신경 쓸 일이 소셜 로그인엔 아예 없습니다. 그 처리를 전부 구글·카카오가 알아서 합니다.
3. Supabase Auth로 붙이기 — provider만 켜면 절반은 끝
5-1에서 우리는 이미 Supabase에 프로젝트를 만들고 DB까지 연동해 뒀습니다. 반가운 소식은, 로그인(Auth)도 같은 Supabase 안에 이미 들어 있다는 거예요. 따로 다른 서비스에 가입할 필요가 없습니다.
여기서 솔직하게 짚고 갈 게 하나 있습니다. 로그인 화면을 그리고 버튼을 다는 코드는 전부 에이전트가 짜 줍니다. 그런데 그 스위치를 켜는 데 필요한 "열쇠"는, 안타깝게도 사람이 직접 구글·카카오 콘솔에 가서 발급받아 와야 해요. 이 부분만큼은 자동화가 안 됩니다. 그래서 다음 섹션에서 그 과정을 차분히 짚습니다 — 겁먹지 마세요, 클릭 몇 번이면 됩니다.
4. ★ 정직한 부분 — '앱 등록'은 사람이 콘솔에서 한다
여기가 이 클립에서 가장 헷갈리는 대목이라, 천천히 갑니다. 핵심은 "열쇠는 콘솔 → Supabase 방향, 콜백 주소는 Supabase → 콘솔 방향"으로 서로 한 번씩 주고받는다는 것. 양쪽이 서로를 알아봐야 로그인이 통하거든요.
동의화면(브랜딩) 만들기: console.cloud.google.com 접속 → 프로젝트 하나 만들고 → 왼쪽 메뉴에서 "Google 인증 플랫폼(Google Auth Platform)"으로 들어갑니다. 예전 자료의 "OAuth 동의화면" 메뉴가 지금은 이 안의 브랜딩(Branding)·대상(Audience)·데이터 액세스(Data Access)로 나뉘어 있어요. 처음 들어가면 나오는 시작 마법사에서 사용자에게 보일 앱 이름·지원 이메일을 적고, 대상은 외부(External)를 고르면 됩니다. (이걸 안 해 두면 나중에 동의화면 관련 에러가 납니다.)
클라이언트 ID·시크릿 발급: 같은 Google 인증 플랫폼의 "클라이언트(Clients)" 메뉴에서 클라이언트 만들기를 누르고, 유형은 웹 애플리케이션을 고릅니다. "승인된 JavaScript 원본" 칸에는 내 사이트 주소(예: 배포한 https://내앱.vercel.app, 내 컴퓨터에서 테스트한다면 http://localhost:8080처럼 실제로 쓰는 주소)를 넣어 둡니다. 만들고 나면 클라이언트 ID와 클라이언트 시크릿 두 값이 나옵니다. 이게 우리가 Supabase에 넣을 "열쇠"예요. (시크릿은 만들 때 한 번만 보여 줄 수 있으니 바로 복사해 두세요.)
콜백 주소를 거꾸로 등록: Supabase의 Authentication → Sign In / Providers → Google 화면을 펼치면 "콜백(Redirect) 주소"가 하나 표시됩니다. 그 주소를 그대로 복사해, 방금 ②에서 만든 구글 클라이언트의 "승인된 리디렉션 URI" 칸에 붙여넣습니다. (이 한 줄을 빠뜨리는 게 가장 흔한 실수예요.)
열쇠를 Supabase에 넣기: 마지막으로, ②의 클라이언트 ID·시크릿을 Supabase의 같은 Google provider 화면에 입력하고 토글을 On으로 켭니다. 이제 구글이 우리 앱을, 우리 앱이 구글을 서로 알아봅니다.
앱 생성 & REST 키: developers.kakao.com 접속 → 로그인 → "앱" 메뉴에서 앱 만들기로 앱을 하나 만듭니다. 그다음 앱 설정 → 앱 → 플랫폼 키(Platform Key)로 가면 REST API 키가 있어요. 그 키를 눌러 들어가면 카카오 로그인 Client Secret도 볼 수 있는데, 이것도 사용함으로 켜 두세요. (카카오는 이 REST 키와 Client Secret을 Supabase에 넣습니다.)
카카오 로그인 활성화: 제품 설정 → 카카오 로그인 → 일반에서 사용 상태를 ON으로 켜고, 제품 설정 → 카카오 로그인 → 동의항목에서 닉네임·프로필 사진 같은 항목을 설정합니다. 이걸 켜야 로그인 창구가 열려요. 단, 이메일(account_email)을 "필수 동의"로 받으려면 사업자 정보를 등록해 비즈 앱으로 전환해야 합니다. 연습할 때는 이메일을 "선택 동의"로 두거나 닉네임만으로 진행하면 충분해요.
Redirect URI를 거꾸로 등록: 구글과 똑같습니다. Supabase의 Authentication → Sign In / Providers → Kakao 화면에 표시되는 콜백 주소를 복사해, 카카오의 앱 설정 → 앱 → 플랫폼 키 → REST API 키 편집 화면에 있는 "카카오 로그인 리다이렉트 URI" 칸에 그대로 붙여넣고 저장합니다.
열쇠를 Supabase에 넣기: 카카오의 키 값을 Supabase의 Kakao provider 화면에 입력하고 토글을 On으로. 끝입니다.
★ 방향만 외우면 안 헷갈립니다. "열쇠(클라이언트 ID·시크릿·REST 키)"는 콘솔에서 발급받아 → Supabase에 넣고, "콜백 주소"는 반대로 Supabase 화면에 뜬 걸 복사해 → 콘솔에 등록합니다. 콜백 주소는 우리가 지어내는 게 아니라, Supabase가 화면에 보여 주는 그 주소를 그대로 복사하는 것 — 이 점만 기억하세요. 이 한 쌍의 주고받기가 끝나면 양쪽이 서로를 인식합니다.
5. 로그인 후 화면 분기 — RLS와 손잡는 지점
로그인을 붙이는 진짜 이유가 여기서 드러납니다. 5-1에서 켠 RLS는 "로그인한 사용자의 줄만 보여 주는" 잠금장치였죠. 그러니 이제 화면이 두 갈래로 나뉘어야 합니다.
"내 데이터" 화면
- 구글·카카오로 신원이 확인된 상태
- RLS가 그 사람 줄만 골라 보여 줌(5-1과 직접 연결)
- 화면에 자기 기록 + 로그아웃 버튼이 보임
"로그인 해주세요" 화면
- 아직 "누구"인지 모르는 상태
- 데이터는 한 줄도 안 보임(RLS가 막음 — 정상입니다)
- "구글로 로그인 · 카카오로 로그인" 버튼만 보임
다시 말해 "로그인했냐 안 했냐"에 따라 보여 줄 화면을 바꾸는 것이 오늘의 마지막 코드 작업입니다. 그리고 이 분기가 있어야, 5-1에서 "데이터가 안 보여요"였던 장면이 "로그인하니 내 데이터가 뜬다"로 완성됩니다.
6. 복붙 프롬프트 ① — 구글 로그인 버튼 + Supabase Auth 연동
이제 손을 움직입니다. 아래 프롬프트는 프로젝트 폴더에서 실행 중인 코딩 에이전트(터미널의 Claude Code 등)에 붙여넣습니다. 4번에서 구글 콘솔 열쇠를 Supabase에 이미 넣어 뒀다는 전제예요(코드 전에 그 등록부터 끝내 두세요).
"이 앱에 Supabase Auth로 '구글로 로그인' 기능을 붙여줘. 진행 순서: ① 화면 위쪽에 '구글로 로그인' 버튼을 하나 추가해줘. ② 그 버튼을 누르면 Supabase의 signInWithOAuth로 구글 로그인 창이 뜨도록 연결해줘(provider는 google). ③ 로그인이 끝나고 돌아오면 현재 로그인한 사용자 정보를 가져와서, 화면 한쪽에 '○○님 환영합니다'처럼 이름이나 이메일을 보여줘. Supabase URL·Publishable key(sb_publishable_로 시작하는 공개 키)는 코드에 박지 말고 5-1에서 쓰던 환경변수를 그대로 쓰고, 한 번에 다 하지 말고 ①→②→③ 순서로 내가 확인할 수 있게 멈춰줘."
성공하면 이렇게 보입니다: "구글로 로그인" 버튼을 누르면 익숙한 구글 로그인 창이 뜨고, 계정을 고르면 다시 내 앱으로 돌아오면서 화면에 "○○님 환영합니다"가 표시됩니다. Supabase 대시보드의 Authentication → Users 목록에도 방금 로그인한 사용자가 새로 한 줄 추가된 게 보여요. 비밀번호를 한 번도 만들지 않고 로그인이 된 순간입니다.
7. 복붙 프롬프트 ② — 카카오 로그인 추가하기
구글이 됐다면 카카오는 거의 똑같습니다. provider 이름만 바뀔 뿐이에요. 4번 B에서 카카오 키 등록을 끝냈다는 전제로, 버튼만 하나 더 답니다.
"방금 만든 구글 로그인 옆에 '카카오로 로그인' 버튼도 추가해줘. 같은 방식으로 Supabase signInWithOAuth를 쓰되 provider만 kakao로 바꿔줘. 두 버튼이 나란히 보이게 정리하고, 카카오 버튼은 노란색 계열로 카카오답게 스타일을 입혀줘. 로그인 성공 후 동작은 구글과 똑같이 처리해줘."
성공하면 이렇게 보입니다: 로그인 화면에 "구글로 로그인 · 카카오로 로그인" 두 버튼이 나란히 떠 있고, 카카오 버튼을 누르면 카카오 로그인 창으로 넘어갑니다. 어느 쪽으로 들어와도 같은 "내 데이터" 화면으로 도착해요.
8. 복붙 프롬프트 ③ — 로그인 상태로 화면 분기 + 로그아웃
마지막 조각입니다. 5번에서 그린 "두 갈래 화면"을 실제로 코드에 심고, 로그아웃 버튼까지 답니다. 이게 끝나면 5-1의 RLS가 비로소 제대로 작동해요.
"앱을 열 때마다 Supabase에서 '지금 로그인된 사용자가 있는지'를 먼저 확인하고 화면을 둘로 나눠줘. ① 로그인된 상태면: 5-1에서 만든 habits 데이터를 RLS에 따라 내 것만 불러와 화면에 그리고, 위쪽에 '로그아웃' 버튼을 보여줘. ② 로그인 안 된 상태면: 데이터 영역은 숨기고 '구글로 로그인 · 카카오로 로그인' 버튼만 보여줘. ③ 로그아웃 버튼을 누르면 Supabase signOut으로 로그아웃하고 다시 로그인 화면으로 돌아가게 해줘. 로그인/로그아웃으로 상태가 바뀌면 화면이 자동으로 다시 그려지게 해줘."
성공하면 이렇게 보입니다: 로그아웃 상태로 앱을 열면 로그인 버튼만 보이고, 로그인하면 그제야 5-1에서 쌓은 내 기록이 좌르르 떠오릅니다. 다른 계정으로 로그인하면 그 사람 데이터만 보이고 내 기록은 안 보이죠 — RLS와 로그인이 짝꿍이 되어 "각자 자기 칸만 여는" 진짜 서비스가 완성된 순간입니다.
9. 막히면 이렇게 — 트러블슈팅
소셜 로그인은 "양쪽 설정이 서로 맞아야" 돌아가는 일이라, 처음엔 한두 번 어긋나는 게 정상입니다. 가장 흔한 순서대로 점검하세요.
💡 ① 로그인 누르면 "redirect URI 불일치" 에러 (가장 흔함) → Supabase 화면에 뜬 콜백 주소를 구글/카카오 콘솔의 리디렉션 URI 칸에 그대로(오타·앞뒤 공백 없이) 넣었는지 확인하세요. 한 글자라도 다르면 막힙니다. 지어낸 주소가 아니라 "Supabase가 보여 준 그 주소"를 복사하는 게 핵심이에요.
💡 ② "이 앱은 확인되지 않았습니다 / 동의화면" 관련 에러 → 구글은 동의화면(Google 인증 플랫폼의 브랜딩·대상)을 만들어 두지 않으면 막힙니다. 앱이 아직 "테스트" 상태라면 대상(Audience) 메뉴의 "테스트 사용자"에 내 이메일을 넣어 두면 됩니다.
💡 ③ 로그인은 됐는데 데이터가 안 보여요 → 십중팔구 RLS·사용자 매칭 문제입니다. 5-1에서 켠 RLS 정책이 "로그인한 사용자의 user_id가 적힌 줄"만 보여 주도록 돼 있는데, 저장할 때 그 줄에 로그인한 사용자의 id가 제대로 들어갔는지 확인하세요. 에이전트에게 "새 기록을 저장할 때 현재 로그인한 사용자의 id를 user_id 칸에 함께 넣어줘"라고 보강하면 대개 해결됩니다.
💡 ④ 그래도 모르겠으면 → 브라우저 콘솔(맥
Cmd+Option+I/ 윈도우F12)의 빨간 에러를 통째로 복사해서 "이 에러가 뜨는데 고쳐줘"라고 에이전트에게 주세요. 콘솔에 뜬 에러 메시지가 곧 가장 정확한 단서입니다.
소셜 로그인은 비밀번호를 우리가 직접 만지지 않고, 구글·카카오에게 "이 사람 맞아?"를 대신 물어보는 방식(OAuth)입니다. 로그인 화면·버튼 코드는 에이전트가 짜 주지만, '앱 등록'(콘솔에서 열쇠 발급)만큼은 사람이 해야 해요 — 이때 열쇠는 콘솔→Supabase, 콜백 주소는 Supabase→콘솔로 한 번씩 주고받는다는 방향만 기억하면 됩니다. 그리고 이 로그인이 붙어야 비로소 5-1의 RLS가 "이 줄의 주인이 누구냐"를 알아 각자 자기 데이터만 보게 됩니다. 핵심은 늘 같아요 — 로그인 보안을 직접 만들지 말고, 에이전트와 Supabase에 시킨다.