머니큐브 개발일지 5편: 구글·네이버·카카오 로그인 3종과 무상태 HMAC 세션 설계
요약
- 구조: 인증 시작과 콜백을 제공자별 함수로 나누고, 세션은 HMAC 서명 쿠키 하나로 처리
- 저장: 서버나 데이터베이스에 계정 정보를 두지 않음, 쿠키는 7일 뒤 자동 만료
- 제공자 차이: 네이버는 검수 전 개발 상태, 카카오는 비즈앱 전이라 이메일 권한이 없음
- 남은 것: 세 제공자 모두 실제 계정으로 끝까지 로그인하는 왕복 확인
로그인의 범위
계산기 사이트에서 로그인은 필수 기능이 아닙니다. 계산은 로그인 없이 되고, 개인정보를 받지 않는 것이 장점이기도 합니다. 그래도 버튼을 둔 이유는 뉴스레터와 계정 표시를 한 흐름으로 묶고, 나중에 계산 기록을 계정에 붙일 여지를 남기기 위해서입니다. 받는 정보는 이름과 이메일, 프로필 사진으로 한정했습니다.
화면은 전 페이지 헤더 버튼으로 열리는 공용 모달입니다. 연동이 끝난 제공자만 버튼이 보입니다. 로그인 상태에서는 버튼이 프로필 사진과 이름으로 바뀌고, 누르면 계정 패널이 열립니다.
무상태 세션: 서명 쿠키 하나
세션은 base64url로 인코딩한 JSON과 그 값의 HMAC-SHA256 서명을 점으로 이은 문자열입니다. 쿠키에는 이 문자열만 들어가고, 서버는 비밀 키로 서명을 검증한 뒤 만료 시각을 확인합니다. 통과하면 로그인, 아니면 로그아웃 상태입니다.
장점은 저장소가 없다는 것입니다. 데이터베이스도 세션 테이블도 정리 작업도 필요 없습니다. 대신 비밀 키가 바뀌면 모든 세션이 한 번에 무효가 되고, 개별 취소 기능은 없습니다. 7일 만료와 로그아웃 시 쿠키 삭제로 그 한계를 감당합니다.
쿠키 속성은 HttpOnly, Secure, SameSite=Lax, Path=/입니다. 자바스크립트에서 읽을 수 없고 HTTPS에서만 전송되며, 콜백 같은 최상위 이동에도 실립니다. 로그인 요청 위조를 막는 state는 별도 쿠키에 10분만 담고 콜백에서 한 번만 비교합니다.
여기서 한 번 크게 막혔습니다. 세션 비밀 키를 처음 등록할 때 값이 비어 들어가 서명 검증이 실패했고, 세션이 만들어지지 않아 로그인해도 계속 비로그인 상태로 보였습니다. 32바이트 난수를 hex로 만들어 운영과 프리뷰에 다시 넣고 재배포한 뒤에야 정상이 되었습니다. 시크릿은 저장만으로 반영되지 않고 재배포가 필요합니다.
구글 로그인
구글은 OpenID Connect를 씁니다. 인증 시작 함수가 state를 쿠키에 담아 구글 인증 주소로 보내고, 콜백이 state를 비교하고 코드를 토큰으로 바꾼 뒤 사용자 정보를 조회해 세션을 만듭니다. 실패는 사유 코드를 붙여 메인으로 돌려보내고 화면에서 안내합니다. 구글 클라우드 쪽은 외부 사용자 유형으로 프로덕션 게시하고, 승인 도메인·자바스크립트 원본·리디렉션 주소를 실제 주소와 똑같이 등록했습니다.
네이버 로그인
네이버는 주소 체계가 구글과 다르고, 토큰 오류를 HTTP 200에 오류 본문으로 돌려주기도 합니다. 그래서 상태 코드만 보지 않고 토큰 존재와 결과 코드를 함께 봅니다. 리디렉션 주소는 등록 값과 글자까지 비교하므로 코드에 고정값으로 두었습니다.
개발자센터에서는 이름·이메일을 필수, 프로필 사진을 추가로 설정했습니다. 이메일은 계정에서 고유하지 않을 수 있다는 안내가 있어 식별은 응답의 id로 합니다. 지금은 검수 전이라 등록 계정과 테스터만 로그인됩니다. 검수에는 로고 이미지와 제공 정보가 보이는 화면 캡처, 로그인 단계별 캡처가 필요하고 그중 일부는 실제 계정으로 로그인해야 만들 수 있습니다.
카카오 로그인
카카오는 REST API 키로 서버에서 처리합니다. 앱을 만들고 카카오 로그인을 켠 뒤 리디렉션 주소를 등록하고 클라이언트 시크릿을 사용 설정했습니다. 동의 항목은 닉네임 필수, 프로필 사진 선택입니다.
문제는 이메일이었습니다. 카카오 계정 이메일은 비즈앱 전환 전에는 권한이 없어 콘솔에서 고를 수 없습니다. 그래서 콜백에서 이메일이 있으면 세션에 담고, 없으면 빈 값으로 두고 로그인을 성립시킵니다. 식별은 카카오 회원번호로 하고, scope도 넘기지 않아 콘솔 설정을 그대로 따릅니다. 콘솔 개편으로 웹 사이트 도메인 메뉴는 없어졌지만, REST API 기반 서버 사이드 로그인에는 도메인 등록이 필요 없습니다.
검증한 것과 못 한 것
라이브에서는 인증 시작의 302와 state 쿠키, 콜백의 오류 경로(코드 없음·state 불일치·취소·토큰 실패), 세션 조회 응답, 로그아웃의 쿠키 만료, 변조한 서명의 거부를 확인했습니다. 제공자 자격증명은 각 토큰 주소에 가짜 코드를 보내 거절 응답을 받아 간접 확인했습니다.
끝까지 확인하지 못한 것이 있습니다. 세 제공자 모두 실제 계정으로 로그인하는 왕복입니다. 구글 계정은 2단계 인증이 패스키로 설정되어 패스키가 있는 기기에서만 진행할 수 있고, 네이버는 비밀번호 입력이, 카카오는 동의 화면에서 직접 동의가 필요합니다. 자동화 환경에서 대신할 수 없는 단계라 남겨 두었습니다. 프리뷰 주소에서는 리디렉션 주소를 운영 도메인으로 고정해 등록했기 때문에 로그인이 완성되지 않습니다.
시리즈를 마치며
개인정보처리방침에는 제공자별 수집 항목과 위탁, 쿠키 만료 안내를 반영했습니다. 이번 작업 뒤 테스트는 1,254개이고 양쪽 화면 모두 가로 넘침은 0입니다.
다섯 편에 걸쳐 계산기, 발행기, 배포 환경, 뉴스레터, 로그인을 정리했습니다. 단계마다 확인한 것과 못 한 것을 구분해 두려 했습니다. 다음 시리즈에서는 검색 유입과 심사 결과 같은 운영 지표를 다룰 예정입니다.
