Handler.cs 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285
  1. using Application.Abstractions.Authentication;
  2. using Application.Abstractions.Cache;
  3. using Application.Abstractions.Crypto;
  4. using Application.Abstractions.Data;
  5. using Application.Abstractions.Messaging;
  6. using Application.Helpers;
  7. using Domain.Entities.Members;
  8. using Domain.Entities.Members.Logs;
  9. using SharedKernel;
  10. using SharedKernel.Results;
  11. using Microsoft.EntityFrameworkCore;
  12. using Microsoft.Extensions.Logging;
  13. using Microsoft.Extensions.Options;
  14. namespace Application.Features.Api.Auth.SocialLogin;
  15. /// <summary>
  16. /// Naver/Kakao 소셜 로그인 (d5 §③④ — d0 확정 반영).
  17. /// 매칭 정책: 이메일로 기존 회원 조회 → 해당 provider 연동(MemberOAuthToken) 있으면 로그인,
  18. /// 없으면 Auth.AccountExists 실패 (자동 계정연결 금지 — 연결은 로그인 후 sns-link 흐름).
  19. /// 기존 회원이 없으면 자동가입 + 연동 행 생성. 카카오 이메일 미동의는 Auth.EmailRequired 실패.
  20. /// </summary>
  21. internal sealed class Handler(
  22. IAppDbContext db,
  23. IJwtTokenProvider jwtTokenProvider,
  24. IEnumerable<ISocialAuthProvider> socialProviders,
  25. IFieldEncryptor fieldEncryptor,
  26. IOptions<AppSettings> options,
  27. ILogger<Handler> logger,
  28. ICacheService cache
  29. ) : ICommandHandler<Command, Result<Response>> {
  30. private const string NaverProvider = "Naver";
  31. private const string KakaoProvider = "Kakao";
  32. private readonly AppSettings.JwtSection _jwt = options.Value.JWT;
  33. private readonly AppSettings.OAuthSection _oauth = options.Value.OAuth;
  34. public async Task<Result<Response>> Handle(Command request, CancellationToken ct)
  35. {
  36. // provider 화이트리스트 (Google 은 기존 google-login 경로 유지 — 여기 미포함)
  37. var providerName = NormalizeProvider(request.Provider);
  38. if (providerName is null)
  39. {
  40. return Result.Failure<Response>(Error.Problem("Auth.UnsupportedProvider", "지원하지 않는 소셜 로그인입니다."));
  41. }
  42. if (string.IsNullOrWhiteSpace(request.Code))
  43. {
  44. return Result.Failure<Response>(Error.Problem("Auth.CodeRequired", "Authorization code 가 필요합니다."));
  45. }
  46. // 네이버는 state 가 스펙상 필수 (CSRF 방어)
  47. if (providerName == NaverProvider && string.IsNullOrWhiteSpace(request.State))
  48. {
  49. return Result.Failure<Response>(Error.Problem("Auth.StateRequired", "state 값이 필요합니다."));
  50. }
  51. var oauthConfig = providerName == NaverProvider ? _oauth.Naver : _oauth.Kakao;
  52. // 키는 DB Config(External, Admin 관리) 우선 — 없으면 appsettings 폴백. RedirectUri 는 환경별 appsettings 유지.
  53. var ext = (await db.Config.AsNoTracking().OrderByDescending(c => c.ID).FirstOrDefaultAsync(ct))?.External;
  54. string Reveal(string? enc) => string.IsNullOrWhiteSpace(enc) ? "" : EncryptedConfigValue.Unprotect(fieldEncryptor, enc);
  55. // 관리자 on/off (Admin /Config/External 체크박스). Config 행이 없으면 도메인 기본(true) 취급.
  56. var isEnabled = providerName == NaverProvider ? (ext?.NaverLoginEnabled ?? true) : (ext?.KakaoLoginEnabled ?? true);
  57. if (!isEnabled)
  58. {
  59. return Result.Failure<Response>(Error.Problem("Auth.SocialDisabled", $"{providerName} 로그인을 사용할 수 없습니다."));
  60. }
  61. var effectiveClientId = providerName == NaverProvider
  62. ? (!string.IsNullOrWhiteSpace(ext?.NaverClientId) ? ext!.NaverClientId! : oauthConfig.ClientId)
  63. : (!string.IsNullOrWhiteSpace(ext?.KakaoRestApiKeyEnc) ? Reveal(ext!.KakaoRestApiKeyEnc) : oauthConfig.ClientId);
  64. // 카카오 client_secret 은 DB 에 별도 모델링하지 않음(선택 항목) → appsettings 유지
  65. var effectiveClientSecret = providerName == NaverProvider
  66. ? (!string.IsNullOrWhiteSpace(ext?.NaverClientSecretEnc) ? Reveal(ext!.NaverClientSecretEnc) : oauthConfig.ClientSecret)
  67. : oauthConfig.ClientSecret;
  68. if (string.IsNullOrWhiteSpace(effectiveClientId))
  69. {
  70. return Result.Failure<Response>(Error.Problem("Auth.SocialNotConfigured", $"{providerName} 로그인이 설정되지 않았습니다."));
  71. }
  72. // 네이버는 client_secret 필수, 카카오는 콘솔 활성화 시에만 전송
  73. if (providerName == NaverProvider && string.IsNullOrWhiteSpace(effectiveClientSecret))
  74. {
  75. return Result.Failure<Response>(Error.Problem("Auth.SocialNotConfigured", $"{providerName} 로그인이 설정되지 않았습니다."));
  76. }
  77. var redirectUri = string.IsNullOrWhiteSpace(request.RedirectUri) ? oauthConfig.RedirectUri : request.RedirectUri;
  78. if (string.IsNullOrWhiteSpace(redirectUri))
  79. {
  80. return Result.Failure<Response>(Error.Problem("Auth.RedirectUriRequired", "Redirect URI 가 필요합니다."));
  81. }
  82. var provider = socialProviders.FirstOrDefault(c => c.Provider == providerName);
  83. if (provider is null)
  84. {
  85. return Result.Failure<Response>(Error.Problem("Auth.UnsupportedProvider", "지원하지 않는 소셜 로그인입니다."));
  86. }
  87. // 승인 코드 → 토큰 교환
  88. var clientSecret = string.IsNullOrWhiteSpace(effectiveClientSecret) ? null : effectiveClientSecret;
  89. var tokens = await provider.ExchangeCodeAsync(request.Code, redirectUri, request.State, effectiveClientId, clientSecret, ct);
  90. if (tokens is null)
  91. {
  92. return Result.Failure<Response>(Error.Unauthorized("Auth.SocialTokenExchangeFailed", $"{providerName} 인증 코드 교환에 실패했습니다."));
  93. }
  94. // 프로필 조회
  95. var userInfo = await provider.GetUserInfoAsync(tokens.AccessToken, ct);
  96. if (userInfo is null)
  97. {
  98. return Result.Failure<Response>(Error.Unauthorized("Auth.SocialUserInfoFailed", $"{providerName} 프로필 조회에 실패했습니다."));
  99. }
  100. // 카카오 이메일 선택동의 미동의 → 프론트가 이메일 보완 화면으로 유도할 수 있게 에러 코드 분리
  101. if (string.IsNullOrWhiteSpace(userInfo.Email))
  102. {
  103. return Result.Failure<Response>(Error.Problem("Auth.EmailRequired", "이메일 제공에 동의해야 가입할 수 있습니다."));
  104. }
  105. var email = userInfo.Email.Trim().ToLower();
  106. var member = await db.Member.FirstOrDefaultAsync(c => c.Email == email, ct);
  107. if (member is null)
  108. {
  109. // 자동 회원가입 (GoogleLogin 시퀀스 재사용)
  110. var accountConfig = await AccountConfigLoader.GetAccountConfigAsync(cache, db, ct);
  111. if (accountConfig.IsRegisterBlock)
  112. {
  113. return Result.Failure<Response>(Error.Problem("Auth.RegisterBlocked", "현재 회원가입이 차단되어 있습니다."));
  114. }
  115. member = Domain.Entities.Members.Member.Create(email);
  116. await db.Member.AddAsync(member, ct);
  117. await db.SaveChangesAsync(ct);
  118. await db.MemberApprove.AddAsync(MemberApprove.Create(member.ID), ct);
  119. await db.MemberStats.AddAsync(MemberStats.Create(member.ID), ct);
  120. await db.Wallet.AddAsync(Domain.Entities.Wallets.Wallet.Create(member.ID), ct);
  121. // provider 가 검증을 보장하는 이메일만 인증 완료 처리 (카카오 is_email_verified)
  122. // 네이버는 연락처 이메일이라 미검증 유지 → 기존 이메일 인증(resend-email) 흐름으로 보완
  123. if (userInfo.EmailVerified)
  124. {
  125. member.MarkEmailVerified();
  126. }
  127. await db.SaveChangesAsync(ct);
  128. // 가입 축하 보상 (멱등 — RefID "signup:{memberID}")
  129. await SignupRewardGranter.GrantAsync(db, cache, member.ID, ct);
  130. await db.SaveChangesAsync(ct);
  131. logger.LogInformation("{Provider} 자동 회원가입: {Email}", providerName, email);
  132. }
  133. else
  134. {
  135. // 탈퇴 회원 거부
  136. if (member.IsWithdraw)
  137. {
  138. await LogLoginAttempt(member.ID, false, email, $"탈퇴 회원 ({providerName})", request, ct);
  139. return Result.Failure<Response>(Error.Problem("Auth.MemberWithdrawn", "탈퇴한 회원은 이용할 수 없습니다."));
  140. }
  141. // 차단 회원 거부
  142. if (member.IsDenied)
  143. {
  144. await LogLoginAttempt(member.ID, false, email, $"차단 회원 ({providerName})", request, ct);
  145. return Result.Failure<Response>(Error.Problem("Auth.MemberDenied", "차단된 회원이므로 이용할 수 없습니다."));
  146. }
  147. // 자동 계정연결 금지 (d0 §5-⑦): 같은 이메일의 기존 계정이 있어도 해당 provider 연동이 없으면 로그인 불가
  148. var hasLink = await db.MemberOAuthToken.AnyAsync(c => c.MemberID == member.ID && c.Provider == providerName, ct);
  149. if (!hasLink)
  150. {
  151. await LogLoginAttempt(member.ID, false, email, $"미연동 소셜 로그인 시도 ({providerName})", request, ct);
  152. return Result.Failure<Response>(Error.Conflict("Auth.AccountExists", "이미 가입된 이메일입니다. 기존 계정으로 로그인 후 SNS 연동을 이용해주세요."));
  153. }
  154. }
  155. // 연동 토큰 upsert (신규 저장분은 IFieldEncryptor 암호화 — d5 R2)
  156. // ProviderUserKey(카카오 id, 네이버 response.id) 를 함께 저장/backfill — disconnect webhook 매칭용
  157. await UpsertOAuthToken(member.ID, providerName, tokens, userInfo.ProviderUserKey, ct);
  158. // JWT 토큰 생성
  159. var accessToken = jwtTokenProvider.CreateAccessToken(member.ID, member.Email, member.Name);
  160. var refreshToken = jwtTokenProvider.CreateRefreshToken();
  161. var expiresAt = DateTime.UtcNow.AddMinutes(_jwt.AccessTokenExpiration);
  162. // RefreshToken 저장
  163. var refreshTokenEntity = Domain.Entities.Members.RefreshToken.Create(
  164. member.ID,
  165. refreshToken,
  166. DateTime.UtcNow.AddDays(_jwt.RefreshTokenExpiration)
  167. );
  168. await db.RefreshToken.AddAsync(refreshTokenEntity, ct);
  169. // 로그인 횟수 증가
  170. var memberStats = await db.MemberStats.FirstOrDefaultAsync(c => c.MemberID == member.ID, ct);
  171. if (memberStats is not null)
  172. {
  173. memberStats.LoginCount++;
  174. }
  175. // 최종 접속 정보 갱신
  176. member.RecordLogin(request.IpAddress, request.UserAgent);
  177. // 성공 로그 기록
  178. await LogLoginAttempt(member.ID, true, email, providerName, request, ct);
  179. await db.SaveChangesAsync(ct);
  180. logger.LogInformation("{Email} {Provider} 로그인", member.Email, providerName);
  181. return Result.Success(new Response(accessToken, refreshToken, expiresAt));
  182. }
  183. private static string? NormalizeProvider(string? provider)
  184. {
  185. return provider?.Trim().ToLowerInvariant() switch
  186. {
  187. "naver" => NaverProvider,
  188. "kakao" => KakaoProvider,
  189. _ => null
  190. };
  191. }
  192. private async Task UpsertOAuthToken(int memberID, string providerName, SocialTokens tokens, string? providerUserKey, CancellationToken ct)
  193. {
  194. var accessTokenEnc = fieldEncryptor.Encrypt(tokens.AccessToken);
  195. var refreshTokenEnc = tokens.RefreshToken is null ? null : fieldEncryptor.Encrypt(tokens.RefreshToken);
  196. var scopes = string.Join(" ", tokens.Scopes);
  197. var existing = await db.MemberOAuthToken.FirstOrDefaultAsync(c => c.MemberID == memberID && c.Provider == providerName, ct);
  198. if (existing is null)
  199. {
  200. var token = MemberOAuthToken.Create(
  201. memberID,
  202. providerName,
  203. accessTokenEnc,
  204. refreshTokenEnc,
  205. tokens.ExpiresAt,
  206. scopes,
  207. providerUserKey
  208. );
  209. db.MemberOAuthToken.Add(token);
  210. }
  211. else
  212. {
  213. existing.UpdateTokens(accessTokenEnc, refreshTokenEnc, tokens.ExpiresAt, scopes, providerUserKey);
  214. }
  215. }
  216. private async Task LogLoginAttempt(int? memberID, bool success, string account, string? reason, Command request, CancellationToken ct)
  217. {
  218. var log = MemberLoginLog.Create(
  219. memberID,
  220. success,
  221. account,
  222. reason,
  223. ipAddress: request.IpAddress,
  224. userAgent: request.UserAgent
  225. );
  226. await db.MemberLoginLog.AddAsync(log, ct);
  227. await db.SaveChangesAsync(ct);
  228. }
  229. }