CH05 · 실전 서비스로 키우기 (심화·보너스)

5-2. 소셜 로그인 (OAuth)

설명 영상이 챕터를 영상으로 먼저 훑어보세요 · 6분 55초

앞 클립(5-1)에서 데이터를 진짜 DB에 쌓고, 마지막에 RLS(줄 단위 보안)로 "내 데이터만 보이게" 잠가 두며 끝냈죠. 그런데 그 잠금장치엔 빠진 조각이 하나 있었어요. "이 줄의 주인이 누구냐"를 정해 줄 '로그인'입니다. 이번 클립이 바로 그 조각을 끼웁니다. 무서운 건 보안인데, 다행히 우리는 비밀번호를 직접 만들지도, 보관하지도 않습니다. 구글·카카오에게 "이 사람 맞아?"를 대신 물어보는 방식(소셜 로그인)을 쓰거든요. 오늘의 한 줄도 똑같습니다. 로그인 보안을 직접 만들지 말고, 에이전트와 Supabase에 시킨다.


1. OAuth, 한 문장으로 — "비밀번호 대신 '확인'을 빌린다"

소셜 로그인 글마다 등장하는 단어가 OAuth(오스, 오어쓰)입니다. 이름은 낯설지만 원리는 정말 단순해요. 한 장면으로 그려 보겠습니다.

🪪
OAuth = 우리가 사용자의 비밀번호를 직접 받지 않고, "구글·카카오에게 대신 신원을 확인받는" 방식
클럽 입구에서 신분증을 직접 검사하지 않고, 믿을 만한 경비실(구글·카카오)에 "이 사람 맞아요?"를 물어 도장만 받아 오는 것과 같아요. 사용자의 비밀번호는 끝까지 구글·카카오 안에만 있고, 우리 앱은 "맞다"는 확인 도장(토큰)만 건네받습니다.

즉 우리 앱은 사용자의 비밀번호를 한 번도 보지 않습니다. "구글로 로그인" 버튼을 누르면, 사용자는 익숙한 구글 화면에서 로그인하고, 구글이 우리 앱에게 "이 사람 본인 맞아요, 이메일은 이거예요"라고 살짝 알려 줄 뿐이죠. 비밀번호라는 가장 위험한 물건을 우리가 만지지 않는다 — 이것이 OAuth의 핵심입니다.

2. 왜 소셜 로그인을 쓰나 — 보안↓·전환율↑·관리부담↓

직접 "아이디 + 비밀번호" 가입을 만들 수도 있습니다. 하지만 비개발자가 처음 만드는 서비스라면, 소셜 로그인이 거의 항상 더 나은 선택입니다. 이유가 셋이에요.

① 보안 위험이 확 줄어든다

비밀번호를 우리가 보관하지 않으니, 해킹당해 비번이 새어 나갈 일 자체가 없습니다. "비밀번호를 안전하게 암호화해서 저장하는" 어려운 일을 구글·카카오가 대신 책임져 주는 셈이에요. 초보자가 가장 사고 치기 쉬운 부분을 통째로 넘기는 거죠.

② 가입 전환율이 올라간다

사용자 입장에선 버튼 한 번이면 끝입니다. 새 이메일·새 비번을 만들고 인증메일을 기다리는 번거로움이 없어요. 가입 단계가 짧을수록 중간에 떠나는 사람이 줄고, 실제로 가입을 끝내는 비율(전환율)이 올라갑니다.

③ 관리 부담이 사라진다

"비밀번호를 잊었어요" 처리, 비번 재설정 메일, 비번 규칙 검사… 직접 만들면 끝없이 신경 쓸 일이 소셜 로그인엔 아예 없습니다. 그 처리를 전부 구글·카카오가 알아서 합니다.

3. Supabase Auth로 붙이기 — provider만 켜면 절반은 끝

5-1에서 우리는 이미 Supabase에 프로젝트를 만들고 DB까지 연동해 뒀습니다. 반가운 소식은, 로그인(Auth)도 같은 Supabase 안에 이미 들어 있다는 거예요. 따로 다른 서비스에 가입할 필요가 없습니다.

🔌
Supabase Auth = 구글·카카오 등 여러 로그인 제공자(provider)를 "스위치 켜듯" 붙일 수 있는 로그인 창구
Supabase 대시보드의 Authentication → Sign In / Providers 화면에 구글·카카오·깃허브·애플 같은 목록이 줄지어 있어요. 우리가 쓸 것만 토글로 켜고, 거기에 "열쇠(키)" 몇 개를 넣어 주면 로그인 창구가 열립니다.

여기서 솔직하게 짚고 갈 게 하나 있습니다. 로그인 화면을 그리고 버튼을 다는 코드는 전부 에이전트가 짜 줍니다. 그런데 그 스위치를 켜는 데 필요한 "열쇠"는, 안타깝게도 사람이 직접 구글·카카오 콘솔에 가서 발급받아 와야 해요. 이 부분만큼은 자동화가 안 됩니다. 그래서 다음 섹션에서 그 과정을 차분히 짚습니다 — 겁먹지 마세요, 클릭 몇 번이면 됩니다.

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에 시킨다.

다음 클립
5-3. 결제 시스템 붙이기
이어보기 →