diff --git a/api/admin-api/build.gradle.kts b/api/admin-api/build.gradle.kts index 3d4528146..c945c556b 100644 --- a/api/admin-api/build.gradle.kts +++ b/api/admin-api/build.gradle.kts @@ -7,6 +7,7 @@ description = "운영진 콘솔 — ADMIN, /v1/admin/**" dependencies { implementation(project(":api:common-api")) implementation(project(":core:common")) + implementation(project(":core:domain:auth")) implementation(project(":core:domain:event")) implementation(project(":core:domain:file")) implementation(project(":core:domain:internal")) diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthApi.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthApi.java new file mode 100644 index 000000000..1ee56a372 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthApi.java @@ -0,0 +1,37 @@ +package kr.ac.kookmin.stream.api.admin.core.auth; + +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import kr.ac.kookmin.stream.api.admin.AdminApiUser; +import kr.ac.kookmin.stream.api.admin.core.auth.request.AdminLoginRequest; +import kr.ac.kookmin.stream.api.admin.core.auth.request.SharedPasswordChangeRequest; +import kr.ac.kookmin.stream.api.admin.core.auth.response.AdminLoginResponse; +import kr.ac.kookmin.stream.api.common.dto.ApiResponse; +import kr.ac.kookmin.stream.api.common.openapi.ApiErrorCode; +import kr.ac.kookmin.stream.auth.domain.admin.domain.AdminAuthErrorCode; +import kr.ac.kookmin.stream.common.CommonErrorCode; + +/** + * 운영진 인증 API의 문서 명세. 구현은 {@link AdminAuthController}가 맡는다. + */ +@Tag(name = "운영진 인증", description = "운영진 콘솔 로그인·공용 비밀번호 관리") +public interface AdminAuthApi { + + /** 학번 + 공용 비밀번호 로그인. 인증 없이 호출한다. */ + @Operation(summary = "운영진 로그인", + description = """ + 학번과 운영진 공용 비밀번호로 로그인한다. role이 ADMIN이고 학생회 부서가 있는 회원만 로그인할 수 있다. + 회원이 없거나, 운영진이 아니거나, 비밀번호가 틀리면 모두 INVALID_ADMIN_CREDENTIALS로 응답한다.""") + @ApiErrorCode(type = CommonErrorCode.class, codes = {"INVALID_INPUT"}) + @ApiErrorCode(type = AdminAuthErrorCode.class, codes = {"INVALID_ADMIN_CREDENTIALS"}) + ApiResponse login(AdminLoginRequest request); + + /** 공용 비밀번호 변경. 회장단만 바꿀 수 있다. */ + @Operation(summary = "운영진 공용 비밀번호 변경", + description = """ + 현재 공용 비밀번호를 확인한 뒤 새 비밀번호로 바꾼다. 회장단만 호출할 수 있다. + 새 비밀번호는 8~16자의 영문·숫자·기호만 쓸 수 있다. 이미 발급된 토큰은 만료될 때까지 그대로 쓸 수 있다.""") + @ApiErrorCode(type = CommonErrorCode.class, codes = {"INVALID_INPUT", "FORBIDDEN"}) + @ApiErrorCode(type = AdminAuthErrorCode.class, codes = {"ADMIN_PASSWORD_MISMATCH"}) + ApiResponse changeSharedPassword(AdminApiUser apiUser, SharedPasswordChangeRequest request); +} diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthController.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthController.java new file mode 100644 index 000000000..46df6b3d6 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthController.java @@ -0,0 +1,44 @@ +package kr.ac.kookmin.stream.api.admin.core.auth; + +import jakarta.validation.Valid; +import kr.ac.kookmin.stream.api.admin.AdminApiUser; +import kr.ac.kookmin.stream.api.admin.core.auth.request.AdminLoginRequest; +import kr.ac.kookmin.stream.api.admin.core.auth.request.SharedPasswordChangeRequest; +import kr.ac.kookmin.stream.api.admin.core.auth.response.AdminLoginResponse; +import kr.ac.kookmin.stream.api.admin.core.auth.usecase.AdminLoginUseCase; +import kr.ac.kookmin.stream.api.admin.core.auth.usecase.SharedPasswordChangeUseCase; +import kr.ac.kookmin.stream.api.admin.security.RequireDepartment; +import kr.ac.kookmin.stream.api.common.dto.ApiResponse; +import kr.ac.kookmin.stream.common.CouncilDepartment; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/v1/admin/auth") +@RequiredArgsConstructor +public class AdminAuthController implements AdminAuthApi { + + private final AdminLoginUseCase adminLoginUseCase; + private final SharedPasswordChangeUseCase sharedPasswordChangeUseCase; + + @Override + @PostMapping("/login") + public ApiResponse login(@Valid @RequestBody AdminLoginRequest request) { + return ApiResponse.success(adminLoginUseCase.login(request.studentId(), request.password())); + } + + @Override + @PutMapping("/shared-password") + @RequireDepartment(CouncilDepartment.PRESIDENCY) + public ApiResponse changeSharedPassword( + AdminApiUser apiUser, + @Valid @RequestBody SharedPasswordChangeRequest request + ) { + sharedPasswordChangeUseCase.change(request.currentPassword(), request.newPassword()); + return ApiResponse.success(); + } +} diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/AdminLoginRequest.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/AdminLoginRequest.java new file mode 100644 index 000000000..e9f851161 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/AdminLoginRequest.java @@ -0,0 +1,15 @@ +package kr.ac.kookmin.stream.api.admin.core.auth.request; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotBlank; + +public record AdminLoginRequest( + @Schema(description = "학번", example = "20231234") + @NotBlank(message = "학번을 입력해 주세요.") + String studentId, + + @Schema(description = "운영진 공용 비밀번호") + @NotBlank(message = "비밀번호를 입력해 주세요.") + String password +) { +} diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/SharedPasswordChangeRequest.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/SharedPasswordChangeRequest.java new file mode 100644 index 000000000..0371e88d2 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/SharedPasswordChangeRequest.java @@ -0,0 +1,20 @@ +package kr.ac.kookmin.stream.api.admin.core.auth.request; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Pattern; +import jakarta.validation.constraints.Size; + +public record SharedPasswordChangeRequest( + @Schema(description = "현재 공용 비밀번호") + @NotBlank(message = "현재 비밀번호를 입력해 주세요.") + String currentPassword, + + // 공백 없는 ASCII(영문 대소문자·숫자·기호)만 받는다. 16자 이하 ASCII라 BCrypt의 72바이트 제한에 걸리지 않는다 + @Schema(description = "새 공용 비밀번호 (8~16자, 영문·숫자·기호)") + @NotBlank(message = "새 비밀번호를 입력해 주세요.") + @Size(min = 8, max = 16, message = "새 비밀번호는 8~16자로 입력해 주세요.") + @Pattern(regexp = "^[\\x21-\\x7E]+$", message = "새 비밀번호는 영문·숫자·기호만 쓸 수 있습니다.") + String newPassword +) { +} diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/response/AdminLoginResponse.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/response/AdminLoginResponse.java new file mode 100644 index 000000000..434e575d3 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/response/AdminLoginResponse.java @@ -0,0 +1,9 @@ +package kr.ac.kookmin.stream.api.admin.core.auth.response; + +import kr.ac.kookmin.stream.common.CouncilDepartment; + +public record AdminLoginResponse( + String accessToken, + String name, + CouncilDepartment councilDepartment +) {} diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/AdminLoginUseCase.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/AdminLoginUseCase.java new file mode 100644 index 000000000..198ef6f35 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/AdminLoginUseCase.java @@ -0,0 +1,55 @@ +package kr.ac.kookmin.stream.api.admin.core.auth.usecase; + +import kr.ac.kookmin.stream.api.admin.core.auth.response.AdminLoginResponse; +import kr.ac.kookmin.stream.auth.domain.admin.domain.AdminAuthConfigKeys; +import kr.ac.kookmin.stream.auth.domain.admin.domain.AdminAuthErrorCode; +import kr.ac.kookmin.stream.common.BusinessException; +import kr.ac.kookmin.stream.common.Role; +import kr.ac.kookmin.stream.internal.domain.config.service.AdminConfigValueService; +import kr.ac.kookmin.stream.member.domain.member.domain.Member; +import kr.ac.kookmin.stream.member.domain.member.service.MemberService; +import kr.ac.kookmin.stream.security.AuthTokenIssuer; +import kr.ac.kookmin.stream.security.PasswordHasher; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +/** + * 학번과 운영진 공용 비밀번호로 로그인한다. role이 ADMIN이고 학생회 부서가 있는 회원만 로그인할 수 있다. + *

+ * 실패 이유(회원 없음·운영진 아님·비밀번호 불일치)는 모두 같은 에러로 응답한다. + * 비밀번호를 회원 조회보다 먼저 확인한다. 회원이 없을 때 BCrypt 비교를 건너뛰면 응답 시간 차이로 운영진 여부가 드러나기 때문이다. + */ +@Component +@RequiredArgsConstructor +public class AdminLoginUseCase { + + private final AdminConfigValueService adminConfigValueService; + private final MemberService memberService; + private final PasswordHasher passwordHasher; + private final AuthTokenIssuer authTokenIssuer; + + public AdminLoginResponse login(String studentId, String password) { + validatePassword(password); + Member member = memberService.findByStudentId(studentId) + .orElseThrow(() -> new BusinessException(AdminAuthErrorCode.INVALID_ADMIN_CREDENTIALS)); + validateAdmin(member); + + String accessToken = authTokenIssuer.issue(member.getId(), member.getRole(), member.getCouncilDepartment()); + return new AdminLoginResponse(accessToken, member.getName(), member.getCouncilDepartment()); + } + + private void validatePassword(String password) { + // 해시가 없으면 아무도 로그인할 수 없는 운영 설정 누락이라 500으로 드러낸다 + String passwordHash = adminConfigValueService.getValue(AdminAuthConfigKeys.PASSWORD_HASH) + .orElseThrow(() -> new IllegalStateException("운영진 공용 비밀번호가 설정되지 않았습니다.")); + if (!passwordHasher.matches(password, passwordHash)) { + throw new BusinessException(AdminAuthErrorCode.INVALID_ADMIN_CREDENTIALS); + } + } + + private void validateAdmin(Member member) { + if (member.getRole() != Role.ADMIN || member.getCouncilDepartment() == null) { + throw new BusinessException(AdminAuthErrorCode.INVALID_ADMIN_CREDENTIALS); + } + } +} diff --git a/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/SharedPasswordChangeUseCase.java b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/SharedPasswordChangeUseCase.java new file mode 100644 index 000000000..bc3851431 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/SharedPasswordChangeUseCase.java @@ -0,0 +1,34 @@ +package kr.ac.kookmin.stream.api.admin.core.auth.usecase; + +import kr.ac.kookmin.stream.auth.domain.admin.domain.AdminAuthConfigKeys; +import kr.ac.kookmin.stream.auth.domain.admin.domain.AdminAuthErrorCode; +import kr.ac.kookmin.stream.common.BusinessException; +import kr.ac.kookmin.stream.internal.domain.config.service.AdminConfigValueService; +import kr.ac.kookmin.stream.security.PasswordHasher; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Component; + +/** + * 운영진 공용 비밀번호를 바꾼다. 현재 비밀번호가 맞을 때만 새 비밀번호의 해시로 덮어쓴다. + * 이미 발급된 토큰은 만료될 때까지 그대로 쓸 수 있다. + */ +@Component +@RequiredArgsConstructor +public class SharedPasswordChangeUseCase { + + private final AdminConfigValueService adminConfigValueService; + private final PasswordHasher passwordHasher; + + public void change(String currentPassword, String newPassword) { + validateCurrentPassword(currentPassword); + adminConfigValueService.upsertValue(AdminAuthConfigKeys.PASSWORD_HASH, passwordHasher.hash(newPassword)); + } + + private void validateCurrentPassword(String currentPassword) { + String passwordHash = adminConfigValueService.getValue(AdminAuthConfigKeys.PASSWORD_HASH) + .orElseThrow(() -> new IllegalStateException("운영진 공용 비밀번호가 설정되지 않았습니다.")); + if (!passwordHasher.matches(currentPassword, passwordHash)) { + throw new BusinessException(AdminAuthErrorCode.ADMIN_PASSWORD_MISMATCH); + } + } +} diff --git a/core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthConfigKeys.java b/core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthConfigKeys.java new file mode 100644 index 000000000..255d4194d --- /dev/null +++ b/core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthConfigKeys.java @@ -0,0 +1,9 @@ +package kr.ac.kookmin.stream.auth.domain.admin.domain; + +// admin_config_values에 저장되는 운영진 인증 관련 키. 공용 비밀번호는 평문이 아니라 BCrypt 해시로만 저장한다. +public final class AdminAuthConfigKeys { + + public static final String PASSWORD_HASH = "ADMIN_PASSWORD_HASH"; + + private AdminAuthConfigKeys() {} +} diff --git a/core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthErrorCode.java b/core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthErrorCode.java new file mode 100644 index 000000000..64b8f6aab --- /dev/null +++ b/core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthErrorCode.java @@ -0,0 +1,21 @@ +package kr.ac.kookmin.stream.auth.domain.admin.domain; + +import kr.ac.kookmin.stream.common.ErrorCode; +import kr.ac.kookmin.stream.common.ErrorStatus; +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.experimental.Accessors; + +@Getter +@Accessors(fluent = true) +@AllArgsConstructor +public enum AdminAuthErrorCode implements ErrorCode { + + // 회원 없음·운영진 아님·비밀번호 불일치를 구분하지 않는다. 학번으로 운영진 여부를 알아내지 못하게 하기 위함 + INVALID_ADMIN_CREDENTIALS(ErrorStatus.UNAUTHORIZED, "학번 또는 비밀번호가 올바르지 않습니다."), + // 로그인한 상태에서 내는 에러라 401이 아니라 400이다. 401이면 콘솔이 토큰 만료로 보고 로그아웃시킬 수 있다 + ADMIN_PASSWORD_MISMATCH(ErrorStatus.BAD_REQUEST, "현재 비밀번호가 올바르지 않습니다."); + + private final int status; + private final String message; +} diff --git a/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/MemberService.java b/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/MemberService.java index a115d0eeb..fb9ea1b06 100644 --- a/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/MemberService.java +++ b/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/MemberService.java @@ -2,6 +2,7 @@ import java.util.List; import java.util.Map; +import java.util.Optional; import java.util.Set; import kr.ac.kookmin.stream.member.domain.member.domain.Member; import kr.ac.kookmin.stream.member.domain.member.domain.MemberPhoneNumberUpdateCommand; @@ -10,6 +11,8 @@ public interface MemberService { Member getById(Long id); + /** 학번으로 회원을 찾는다. 탈퇴한 회원은 찾지 않는다. */ + Optional findByStudentId(String studentId); List findAllByIds(List ids); Map getMapByIds(List ids); /** diff --git a/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/impl/MemberServiceImpl.java b/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/impl/MemberServiceImpl.java index 778bdc633..dc3045d0d 100644 --- a/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/impl/MemberServiceImpl.java +++ b/core/domain/member/src/main/java/kr/ac/kookmin/stream/member/domain/member/service/impl/MemberServiceImpl.java @@ -33,6 +33,11 @@ public Member getById(Long id) { .orElseThrow(() -> new BusinessException(MemberErrorCode.MEMBER_NOT_FOUND)); } + @Override + public Optional findByStudentId(String studentId) { + return memberRepository.findByStudentId(studentId); + } + @Override public List findAllByIds(List ids) { return memberRepository.findAllByIds(ids); diff --git a/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PasswordHasher.java b/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PasswordHasher.java new file mode 100644 index 000000000..5d3d9a639 --- /dev/null +++ b/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PasswordHasher.java @@ -0,0 +1,23 @@ +package kr.ac.kookmin.stream.security; + +import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.stereotype.Component; + +/** + * 비밀번호를 BCrypt로 해시하고 비교한다. + * BCrypt 구현(spring-security-crypto)은 gateway:auth에만 있어, api 모듈이 Security 타입을 몰라도 쓰도록 여기서 감싼다. + */ +@Component +public class PasswordHasher { + + private final PasswordEncoder passwordEncoder = new BCryptPasswordEncoder(); + + public String hash(String rawPassword) { + return passwordEncoder.encode(rawPassword); + } + + public boolean matches(String rawPassword, String hashedPassword) { + return passwordEncoder.matches(rawPassword, hashedPassword); + } +} diff --git a/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PublicEndpoints.java b/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PublicEndpoints.java index 2f775c68f..f50720551 100644 --- a/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PublicEndpoints.java +++ b/gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PublicEndpoints.java @@ -25,6 +25,9 @@ public enum PublicEndpoints { )), AUTH(List.of( "/v1/auth/login/*" + )), + ADMIN_AUTH(List.of( + "/v1/admin/auth/login" )); private static final List ALL_PATH_PATTERNS = Arrays.stream(values())