o2o-site-AEO/solution/backend/services/auth_service.py
hbyang ca0bea77a7 [feat] solution/backend: 카카오 로그인 — 회원번호로 카톡 채널을 코드 없이 잇는다
★★ 챗봇 웹훅의 user.properties.appUserId 는 카카오 로그인의 회원번호와 **같은 값**이다
(카카오 공식 문서, 봇에 앱키가 물려 있을 때). 그래서 카카오로 로그인만 해 두면 채널에
말을 거는 순간 누구인지 알 수 있고, 6자리 코드 절차가 필요 없어진다.

- external/kakao_identity: 액세스 토큰을 카카오에 되물어 확인한다. ★ 응답의 app_id 를
  우리 앱과 대조하는 것이 구글의 aud 검사에 해당한다 — 이게 없으면 남의 앱 토큰으로
  우리 계정이 된다. 이름·이메일은 동의 항목이라 못 받아도 로그인은 되게 했다
- auth_service.kakao_login: google_login 과 같은 세 갈래. 이메일이 겹쳐도 자동으로
  잇지 않는다(DECISIONS 1 — 계정 선점)
- kakao_link_service.link_by_app_user_id: 자동 매칭. ★ 이미 다른 사장님에게 묶인
  카톡은 빼앗지 않는다 — 조용히 빼앗으면 앞사람이 남의 가게를 보게 된다
- ★ 코드 경로는 그대로 둔다: id/pw·구글 가입자에겐 appUserId 가 없고, 봇에 앱키가
  안 물린 환경에서는 값 자체가 안 온다

★ 함께 고친 것 — services/agent/tools.py 가 사라진 site_payload._DEFAULT_THEME 를
보고 있었다(c690862 템플릿 정의 통합에서 이름이 없어졌는데 이 한 줄만 남았다).
**대화의 섹션 기능이 통째로 죽어 있었고** 웹훅이 AttributeError 를 삼켜 "지금은
처리할 수 없어요" 로만 보였다 — common/template_catalog.industry_of 로 바꿨다.

test_kakao_link·test_kakao_webhook·test_agent_runtime·test_auth 194 passed
(신규 4: 자동 매칭·미가입자·빼앗지 않음·재진입). 남은 1건은 컨테이너에 실제
GOOGLE_CLIENT_ID 가 있어 나는 기존 실패다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-30 16:27:54 +09:00

405 lines
16 KiB
Python

import re
import uuid
from fastapi import Depends
from common.database.db_session_manager import DB_SESSION_MNG
from common.database.model.models import users
from common.enums import AuthProvider, DBWRType, ErrorType, UserRole, UserStatus
from common.logger import LOG
from common.models.gmodel import UserInfo
from crud.user_crud import IUserCRUD, UserCRUD
from router.v1.auth.protocol import (
Req_GoogleLogin,
Req_KakaoLogin,
Req_Signup,
Req_UpdateMe,
Res_Login,
Res_Me,
Res_RefreshToken,
)
from router.v1.validator.dependencies import (
CreateAccessToken,
CreateRefreshToken,
DecodeRefreshToken,
GetHashedPW,
VerifyPW,
)
from services.external.kakao_identity import (
KakaoAccount,
KakaoNotConfigured,
KakaoTokenInvalid,
verify_access_token as verify_kakao_token,
)
from services.external.google_identity import (
GoogleAccount,
GoogleNotConfigured,
GoogleTokenInvalid,
verify_id_token,
)
# 로그인 아이디: 영문으로 시작하는 4~20자.
_LOGIN_ID_RE = re.compile(r"^[a-zA-Z][a-zA-Z0-9._-]{3,19}$")
# 형식만 본다 — 이메일 소유 증명은 여기 없다(Req_Signup 주석).
_EMAIL_RE = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")
_MIN_PASSWORD_LEN = 8
# 구글 계정의 로그인 아이디 접두어.
_SOCIAL_ID_PREFIX = "google_"
def _google_login_id(sub: str) -> str:
"""구글 계정의 로그인 아이디."""
return f"{_SOCIAL_ID_PREFIX}{sub}"
def _kakao_login_id(uid: str) -> str:
"""카카오 계정의 로그인 아이디. 구글과 접두어를 달리해 **수단이 섞이지 않게** 한다."""
return f"kakao_{uid}"
def _fit(value: str | None, limit: int) -> str | None:
"""컬럼 길이에 맞춰 자른다."""
if value is None:
return None
return value[:limit]
class AuthService:
"""비즈니스 로직 계층 (MVC 의 컨트롤러-서비스 분리에서 서비스)."""
def __init__(self, user_crud: IUserCRUD = Depends(UserCRUD)):
self.user_crud = user_crud
@staticmethod
def _user_info(user: users) -> UserInfo:
# uuid → str (JWT json 직렬화 위해).
return UserInfo(
user_id=str(user.user_id),
id=user.id,
role=user.role,
token_version=user.token_version,
)
async def _finish_login(self, user: users) -> Res_Login:
"""신원이 확인된 뒤의 마지막 단계 — id/pw 와 구글이 공유한다."""
res = Res_Login()
if user.status != UserStatus.ACTIVE.value:
res.result.SetResult(ErrorType.ACCOUNT_BLOCKED_USER)
return res
user_info = self._user_info(user)
res.access_token = CreateAccessToken(user_info)
res.refresh_token = CreateRefreshToken(user_info)
err_type = await DB_SESSION_MNG.execute_lambda_run(
[users.DBType()],
[lambda s: self.user_crud.update_last_accessed(s, user.user_id)],
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(err_type)
return res
async def attempt_login(self, login_id: str, password: str, connect_ip: str) -> Res_Login:
LOG.i(f"LOGIN : id={login_id}")
res = Res_Login()
# 1) 계정 조회 (Read DB)
err_type, user = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_login_id(s, login_id),
)
if err_type != ErrorType.SUCCESS:
# 계정 없음/조회 실패 모두 로그인 실패로 일반화
res.result.SetResult(ErrorType.ACCOUNT_INVALID_INFO)
return res
user: users
# 2) 소셜 계정에는 대조할 비밀번호가 없다.
if user.provider != AuthProvider.LOCAL.value or not user.password:
res.result.SetResult(ErrorType.ACCOUNT_PROVIDER_CONFLICT)
return res
# 3) 비밀번호 검증
if not await VerifyPW(password, user.password):
res.result.SetResult(ErrorType.ACCOUNT_INVALID_INFO)
return res
return await self._finish_login(user)
# 가입
async def _create_account(
self,
*,
login_id: str,
password_hash: str | None,
name: str | None,
email: str | None,
provider: AuthProvider,
provider_uid: str | None,
) -> tuple[ErrorType, users]:
"""계정 1개를 만든다."""
user = users(
user_id=uuid.uuid4(),
id=login_id,
password=password_hash,
name=_fit(name, 50),
email=_fit(email, 255),
status=UserStatus.ACTIVE.value,
role=UserRole.USER.value,
provider=provider.value,
provider_uid=provider_uid,
)
err_type = await DB_SESSION_MNG.execute_lambda_run(
[users.DBType()],
[lambda s: self.user_crud.add_user(s, user)],
)
if err_type != ErrorType.SUCCESS:
return err_type, None
return ErrorType.SUCCESS, user
async def _email_taken(self, email: str) -> bool:
err_type, existing = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_email(s, email),
)
return err_type == ErrorType.SUCCESS and existing is not None
async def signup(self, req: Req_Signup) -> Res_Login:
"""id/pw 가입."""
res = Res_Login()
login_id = req.id.strip()
email = (req.email or "").strip().lower()
name = (req.name or "").strip() or None
if not _LOGIN_ID_RE.match(login_id) or login_id.lower().startswith(_SOCIAL_ID_PREFIX):
res.result.SetResult(ErrorType.INVALID_REQUEST_DATA)
return res
if len(req.password) < _MIN_PASSWORD_LEN:
res.result.SetResult(ErrorType.INVALID_REQUEST_DATA)
return res
if not _EMAIL_RE.match(email):
res.result.SetResult(ErrorType.INVALID_REQUEST_DATA)
return res
# 아이디 중복.
dup = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.is_user(s, login_id),
)
if dup != ErrorType.SUCCESS:
res.result.SetResult(ErrorType.ACCOUNT_ALREADY_EXIST)
return res
# 이메일 중복 — 구글로 이미 가입한 사람이 같은 이메일로 계정을 하나 더 만드는 걸 막는다.
if await self._email_taken(email):
res.result.SetResult(ErrorType.ACCOUNT_ALREADY_EXIST)
return res
err_type, user = await self._create_account(
login_id=login_id,
password_hash=await GetHashedPW(req.password),
name=name,
email=email,
provider=AuthProvider.LOCAL,
provider_uid=None,
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(err_type)
return res
LOG.i(f"SIGNUP : id={login_id}")
return await self._finish_login(user)
# 구글 로그인
async def google_login(self, req: Req_GoogleLogin) -> Res_Login:
"""구글 ID 토큰 → 우리 세션."""
res = Res_Login()
try:
account: GoogleAccount = await verify_id_token(req.credential)
except GoogleNotConfigured:
res.result.SetResult(ErrorType.OAUTH_NOT_CONFIGURED)
return res
except GoogleTokenInvalid:
res.result.SetResult(ErrorType.OAUTH_INVALID_TOKEN)
return res
# 1) 이미 있는 구글 계정인가 — 판정 키는 sub 다(이메일이 바뀌어도 같은 사람).
err_type, user = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_provider_uid(s, AuthProvider.GOOGLE.value, account.sub),
)
if err_type == ErrorType.SUCCESS and user is not None:
LOG.i(f"LOGIN(google) : sub={account.sub}")
return await self._finish_login(user)
# 2) 같은 이메일이 다른 수단으로 이미 가입돼 있으면 **잇지 않는다.** 자동으로 이으면, 남의 이메일로 먼저 만들어 둔 id/pw 계정에 그 사람의 구글 로그인이 그대로 들어간다(계정 선점).
if account.email and await self._email_taken(account.email):
res.result.SetResult(ErrorType.ACCOUNT_PROVIDER_CONFLICT)
return res
# 3) 첫 방문 — 계정을 만든다.
err_type, user = await self._create_account(
login_id=_google_login_id(account.sub),
password_hash=None,
name=account.name or None,
email=account.email or None,
provider=AuthProvider.GOOGLE,
provider_uid=account.sub,
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(err_type)
return res
LOG.i(f"SIGNUP(google) : sub={account.sub}")
return await self._finish_login(user)
async def kakao_login(self, req: Req_KakaoLogin) -> Res_Login:
"""카카오 액세스 토큰 → 우리 세션.
★ google_login 과 **같은 세 갈래**다(기존 계정 → 이메일 충돌 → 신규). 규칙을 한 벌로
유지하려고 모양을 맞췄다 — 여기만 다르게 두면 "어느 쪽이 맞나" 를 매번 되짚게 된다.
★★ 판정 키는 카카오 **회원번호**다. 이 값이 챗봇 웹훅의 `appUserId` 와 같아서,
로그인만 해 두면 채널에 말을 거는 순간 자동으로 이어진다
(services/kakao_link_service.link_by_app_user_id)."""
res = Res_Login()
try:
account: KakaoAccount = await verify_kakao_token(req.access_token)
except KakaoNotConfigured:
res.result.SetResult(ErrorType.OAUTH_NOT_CONFIGURED)
return res
except KakaoTokenInvalid:
res.result.SetResult(ErrorType.OAUTH_INVALID_TOKEN)
return res
err_type, user = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_provider_uid(s, AuthProvider.KAKAO.value, account.uid),
)
if err_type == ErrorType.SUCCESS and user is not None:
LOG.i("LOGIN(kakao)")
return await self._finish_login(user)
# ★ 같은 이메일이 다른 수단으로 가입돼 있으면 **잇지 않는다**(DECISIONS 1절).
# 자동으로 이으면 남이 먼저 만들어 둔 계정에 그 사람의 카카오 로그인이 들어간다.
if account.email and await self._email_taken(account.email):
res.result.SetResult(ErrorType.ACCOUNT_PROVIDER_CONFLICT)
return res
err_type, user = await self._create_account(
login_id=_kakao_login_id(account.uid),
password_hash=None,
name=account.name or None,
email=account.email or None,
provider=AuthProvider.KAKAO,
provider_uid=account.uid,
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(err_type)
return res
LOG.i("SIGNUP(kakao)")
return await self._finish_login(user)
async def get_me(self, user_info: UserInfo) -> Res_Me:
res = Res_Me()
# 1) 유저 조회
err_type, user = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_login_id(s, user_info.id),
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(ErrorType.ACCOUNT_INVALID_INFO)
return res
user: users
res.user_id = str(user.user_id)
res.id = user.id
res.name = user.name
res.email = user.email
res.contact_number = user.contact_number
res.role = UserRole(user.role)
res.provider = AuthProvider(user.provider)
return res
async def update_me(self, user_info: UserInfo, req: Req_UpdateMe) -> Res_Me:
res = Res_Me()
data = req.model_dump(exclude_unset=True)
# 비밀번호: 값 있으면 해시 교체, 비었으면 변경 안 함.
if data.get("password"):
# 구글 계정에 비밀번호를 심으면 id/pw 로도 열리는 반쪽 계정이 된다 — 로그인 수단이 둘인데 어느 쪽도 상대를 모르는 상태다.
if len(data["password"]) < _MIN_PASSWORD_LEN:
res.result.SetResult(ErrorType.INVALID_REQUEST_DATA)
return res
err_type, me = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_login_id(s, user_info.id),
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(ErrorType.ACCOUNT_NOT_FOUND)
return res
if me.provider != AuthProvider.LOCAL.value:
res.result.SetResult(ErrorType.ACCOUNT_PROVIDER_CONFLICT)
return res
data["password"] = await GetHashedPW(data["password"])
# 비밀번호를 바꾸면 그 전에 나간 refresh 토큰을 전부 무효화한다 — 안 그러면 누군가 비번을 훔쳐 넣어 둔 refresh 토큰이 이 사람이 비번을 바꾼 뒤로도 계속 살아 있다(auth_service.refresh_token 이 이 값을 대조한다).
data["token_version"] = (me.token_version or 1) + 1
else:
data.pop("password", None)
# 빈 문자열은 NULL 로 저장(미입력 = 값 비움).
for k in ("name", "email", "contact_number"):
if k in data and data[k] == "":
data[k] = None
if data:
err_type = await DB_SESSION_MNG.execute_lambda_run(
[users.DBType()],
[lambda s: self.user_crud.update_user(s, uuid.UUID(user_info.user_id), data)],
)
if err_type != ErrorType.SUCCESS:
res.result.SetResult(err_type)
return res
# 갱신 후 최신 정보로 응답(프론트가 스토어 갱신에 사용).
return await self.get_me(user_info)
async def refresh_token(self, refresh_token: str) -> Res_RefreshToken:
"""refresh 토큰 → 새 access 토큰."""
res = Res_RefreshToken()
# refresh 토큰 검증은 라우터 Depends(IsValidRefreshToken) 에서 1차 수행됨(서명·만료).
user_info = DecodeRefreshToken(refresh_token)
err_type, user = await DB_SESSION_MNG.execute_lambda(
users.DBType(),
DBWRType.DB_READ.value,
lambda s: self.user_crud.get_user_by_login_id(s, user_info.id),
)
if err_type != ErrorType.SUCCESS or user is None:
res.result.SetResult(ErrorType.ACCOUNT_NOT_FOUND)
return res
user: users
if user.status != UserStatus.ACTIVE.value:
res.result.SetResult(ErrorType.ACCOUNT_BLOCKED_USER)
return res
# 구버전 토큰(token_version 없이 발급됨)은 UserInfo 기본값 1 로 읽힌다 — DB 컬럼 기본값도 1 이라 배포 직후에는 전부 통과한다.
if user_info.token_version != user.token_version:
res.result.SetResult(ErrorType.ACCOUNT_SESSION_REVOKED)
return res
# 최신 DB 값으로 다시 만든다 — role 이 바뀌었으면 그것도 여기서 따라온다.
res.access_token = CreateAccessToken(self._user_info(user))
return res