카카오 로그인을 Firebase에 붙이기 — 커스텀 토큰 연동 실전

왜 커스텀 토큰이 필요한가

Firebase 인증은 구글·애플 등은 기본 지원하지만 카카오는 없습니다. 그래서 카카오로 로그인한 사용자를 Firebase가 인정하게 하려면, 서버에서 Firebase 커스텀 토큰을 만들어 앱에 돌려주는 다리가 필요합니다.

전체 흐름

1. 앱: 카카오 SDK로 로그인 → 카카오 액세스 토큰 획득
2. 앱 → 서버: 액세스 토큰을 Cloud Function으로 전달
3. 서버: 카카오 API로 사용자 정보 조회 → kakao_(카카오ID) 형태의 Firebase UID로 커스텀 토큰 발급
4. 서버 → 앱: 커스텀 토큰 반환
5. 앱: signInWithCustomToken으로 Firebase 로그인 완료

// Cloud Function (핵심만)
const admin = require('firebase-admin');
exports.kakaoLogin = functions.https.onCall(async (data) => {
  const kakaoToken = data.accessToken;
  // 1) 카카오 사용자 조회
  const me = await fetch('https://kapi.kakao.com/v2/user/me',
    { headers: { Authorization: 'Bearer ' + kakaoToken } }).then(r=>r.json());
  const uid = 'kakao_' + me.id;
  // 2) 최초면 유저 문서 생성 (createUser 누락 주의)
  await admin.firestore().doc('users/'+uid)
    .set({ provider:'kakao', name: me.properties?.nickname||'' }, {merge:true});
  // 3) 커스텀 토큰 발급
  return { token: await admin.auth().createCustomToken(uid) };
});

자주 나는 함정

• 유저 문서 생성 누락 — 커스텀 토큰만 만들고 users 문서를 안 만들면, 이후 프로필·권한 로직이 “문서 없음”으로 깨집니다. 최초 로그인 시 문서를 함께 생성하세요.
• 키 해시 미등록 — 안드로이드는 앱 서명 키 해시를 카카오 개발자 콘솔에 등록해야 합니다. 구글 플레이 앱 서명을 쓰면 Play가 생성한 키 해시도 따로 등록해야 합니다.
• UID 규칙 불일치 — 커스텀 토큰의 UID 형식(kakao_...)과 보안 규칙의 uid 대조가 맞는지 확인하세요.

자주 묻는 질문

함께 읽기: 앱 심사 거절 사유 · 앱 유지보수 서비스