Handler.cs 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277
  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. var effectiveClientId = providerName == NaverProvider
  56. ? (!string.IsNullOrWhiteSpace(ext?.NaverClientId) ? ext!.NaverClientId! : oauthConfig.ClientId)
  57. : (!string.IsNullOrWhiteSpace(ext?.KakaoRestApiKeyEnc) ? Reveal(ext!.KakaoRestApiKeyEnc) : oauthConfig.ClientId);
  58. // 카카오 client_secret 은 DB 에 별도 모델링하지 않음(선택 항목) → appsettings 유지
  59. var effectiveClientSecret = providerName == NaverProvider
  60. ? (!string.IsNullOrWhiteSpace(ext?.NaverClientSecretEnc) ? Reveal(ext!.NaverClientSecretEnc) : oauthConfig.ClientSecret)
  61. : oauthConfig.ClientSecret;
  62. if (string.IsNullOrWhiteSpace(effectiveClientId))
  63. {
  64. return Result.Failure<Response>(Error.Problem("Auth.SocialNotConfigured", $"{providerName} 로그인이 설정되지 않았습니다."));
  65. }
  66. // 네이버는 client_secret 필수, 카카오는 콘솔 활성화 시에만 전송
  67. if (providerName == NaverProvider && string.IsNullOrWhiteSpace(effectiveClientSecret))
  68. {
  69. return Result.Failure<Response>(Error.Problem("Auth.SocialNotConfigured", $"{providerName} 로그인이 설정되지 않았습니다."));
  70. }
  71. var redirectUri = string.IsNullOrWhiteSpace(request.RedirectUri) ? oauthConfig.RedirectUri : request.RedirectUri;
  72. if (string.IsNullOrWhiteSpace(redirectUri))
  73. {
  74. return Result.Failure<Response>(Error.Problem("Auth.RedirectUriRequired", "Redirect URI 가 필요합니다."));
  75. }
  76. var provider = socialProviders.FirstOrDefault(c => c.Provider == providerName);
  77. if (provider is null)
  78. {
  79. return Result.Failure<Response>(Error.Problem("Auth.UnsupportedProvider", "지원하지 않는 소셜 로그인입니다."));
  80. }
  81. // 승인 코드 → 토큰 교환
  82. var clientSecret = string.IsNullOrWhiteSpace(effectiveClientSecret) ? null : effectiveClientSecret;
  83. var tokens = await provider.ExchangeCodeAsync(request.Code, redirectUri, request.State, effectiveClientId, clientSecret, ct);
  84. if (tokens is null)
  85. {
  86. return Result.Failure<Response>(Error.Unauthorized("Auth.SocialTokenExchangeFailed", $"{providerName} 인증 코드 교환에 실패했습니다."));
  87. }
  88. // 프로필 조회
  89. var userInfo = await provider.GetUserInfoAsync(tokens.AccessToken, ct);
  90. if (userInfo is null)
  91. {
  92. return Result.Failure<Response>(Error.Unauthorized("Auth.SocialUserInfoFailed", $"{providerName} 프로필 조회에 실패했습니다."));
  93. }
  94. // 카카오 이메일 선택동의 미동의 → 프론트가 이메일 보완 화면으로 유도할 수 있게 에러 코드 분리
  95. if (string.IsNullOrWhiteSpace(userInfo.Email))
  96. {
  97. return Result.Failure<Response>(Error.Problem("Auth.EmailRequired", "이메일 제공에 동의해야 가입할 수 있습니다."));
  98. }
  99. var email = userInfo.Email.Trim().ToLower();
  100. var member = await db.Member.FirstOrDefaultAsync(c => c.Email == email, ct);
  101. if (member is null)
  102. {
  103. // 자동 회원가입 (GoogleLogin 시퀀스 재사용)
  104. var accountConfig = await AccountConfigLoader.GetAccountConfigAsync(cache, db, ct);
  105. if (accountConfig.IsRegisterBlock)
  106. {
  107. return Result.Failure<Response>(Error.Problem("Auth.RegisterBlocked", "현재 회원가입이 차단되어 있습니다."));
  108. }
  109. member = Domain.Entities.Members.Member.Create(email);
  110. await db.Member.AddAsync(member, ct);
  111. await db.SaveChangesAsync(ct);
  112. await db.MemberApprove.AddAsync(MemberApprove.Create(member.ID), ct);
  113. await db.MemberStats.AddAsync(MemberStats.Create(member.ID), ct);
  114. await db.Wallet.AddAsync(Domain.Entities.Wallets.Wallet.Create(member.ID), ct);
  115. // provider 가 검증을 보장하는 이메일만 인증 완료 처리 (카카오 is_email_verified)
  116. // 네이버는 연락처 이메일이라 미검증 유지 → 기존 이메일 인증(resend-email) 흐름으로 보완
  117. if (userInfo.EmailVerified)
  118. {
  119. member.MarkEmailVerified();
  120. }
  121. await db.SaveChangesAsync(ct);
  122. // 가입 축하 보상 (멱등 — RefID "signup:{memberID}")
  123. await SignupRewardGranter.GrantAsync(db, cache, member.ID, ct);
  124. await db.SaveChangesAsync(ct);
  125. logger.LogInformation("{Provider} 자동 회원가입: {Email}", providerName, email);
  126. }
  127. else
  128. {
  129. // 탈퇴 회원 거부
  130. if (member.IsWithdraw)
  131. {
  132. await LogLoginAttempt(member.ID, false, email, $"탈퇴 회원 ({providerName})", request, ct);
  133. return Result.Failure<Response>(Error.Problem("Auth.MemberWithdrawn", "탈퇴한 회원은 이용할 수 없습니다."));
  134. }
  135. // 차단 회원 거부
  136. if (member.IsDenied)
  137. {
  138. await LogLoginAttempt(member.ID, false, email, $"차단 회원 ({providerName})", request, ct);
  139. return Result.Failure<Response>(Error.Problem("Auth.MemberDenied", "차단된 회원이므로 이용할 수 없습니다."));
  140. }
  141. // 자동 계정연결 금지 (d0 §5-⑦): 같은 이메일의 기존 계정이 있어도 해당 provider 연동이 없으면 로그인 불가
  142. var hasLink = await db.MemberOAuthToken.AnyAsync(c => c.MemberID == member.ID && c.Provider == providerName, ct);
  143. if (!hasLink)
  144. {
  145. await LogLoginAttempt(member.ID, false, email, $"미연동 소셜 로그인 시도 ({providerName})", request, ct);
  146. return Result.Failure<Response>(Error.Conflict("Auth.AccountExists", "이미 가입된 이메일입니다. 기존 계정으로 로그인 후 SNS 연동을 이용해주세요."));
  147. }
  148. }
  149. // 연동 토큰 upsert (신규 저장분은 IFieldEncryptor 암호화 — d5 R2)
  150. // ProviderUserKey(카카오 id, 네이버 response.id) 를 함께 저장/backfill — disconnect webhook 매칭용
  151. await UpsertOAuthToken(member.ID, providerName, tokens, userInfo.ProviderUserKey, ct);
  152. // JWT 토큰 생성
  153. var accessToken = jwtTokenProvider.CreateAccessToken(member.ID, member.Email, member.Name);
  154. var refreshToken = jwtTokenProvider.CreateRefreshToken();
  155. var expiresAt = DateTime.UtcNow.AddMinutes(_jwt.AccessTokenExpiration);
  156. // RefreshToken 저장
  157. var refreshTokenEntity = Domain.Entities.Members.RefreshToken.Create(
  158. member.ID,
  159. refreshToken,
  160. DateTime.UtcNow.AddDays(_jwt.RefreshTokenExpiration)
  161. );
  162. await db.RefreshToken.AddAsync(refreshTokenEntity, ct);
  163. // 로그인 횟수 증가
  164. var memberStats = await db.MemberStats.FirstOrDefaultAsync(c => c.MemberID == member.ID, ct);
  165. if (memberStats is not null)
  166. {
  167. memberStats.LoginCount++;
  168. }
  169. // 최종 접속 정보 갱신
  170. member.RecordLogin(request.IpAddress, request.UserAgent);
  171. // 성공 로그 기록
  172. await LogLoginAttempt(member.ID, true, email, providerName, request, ct);
  173. await db.SaveChangesAsync(ct);
  174. logger.LogInformation("{Email} {Provider} 로그인", member.Email, providerName);
  175. return Result.Success(new Response(accessToken, refreshToken, expiresAt));
  176. }
  177. private static string? NormalizeProvider(string? provider)
  178. {
  179. return provider?.Trim().ToLowerInvariant() switch
  180. {
  181. "naver" => NaverProvider,
  182. "kakao" => KakaoProvider,
  183. _ => null
  184. };
  185. }
  186. private async Task UpsertOAuthToken(int memberID, string providerName, SocialTokens tokens, string? providerUserKey, CancellationToken ct)
  187. {
  188. var accessTokenEnc = fieldEncryptor.Encrypt(tokens.AccessToken);
  189. var refreshTokenEnc = tokens.RefreshToken is null ? null : fieldEncryptor.Encrypt(tokens.RefreshToken);
  190. var scopes = string.Join(" ", tokens.Scopes);
  191. var existing = await db.MemberOAuthToken.FirstOrDefaultAsync(c => c.MemberID == memberID && c.Provider == providerName, ct);
  192. if (existing is null)
  193. {
  194. var token = MemberOAuthToken.Create(
  195. memberID,
  196. providerName,
  197. accessTokenEnc,
  198. refreshTokenEnc,
  199. tokens.ExpiresAt,
  200. scopes,
  201. providerUserKey
  202. );
  203. db.MemberOAuthToken.Add(token);
  204. }
  205. else
  206. {
  207. existing.UpdateTokens(accessTokenEnc, refreshTokenEnc, tokens.ExpiresAt, scopes, providerUserKey);
  208. }
  209. }
  210. private async Task LogLoginAttempt(int? memberID, bool success, string account, string? reason, Command request, CancellationToken ct)
  211. {
  212. var log = MemberLoginLog.Create(
  213. memberID,
  214. success,
  215. account,
  216. reason,
  217. ipAddress: request.IpAddress,
  218. userAgent: request.UserAgent
  219. );
  220. await db.MemberLoginLog.AddAsync(log, ct);
  221. await db.SaveChangesAsync(ct);
  222. }
  223. }