From 732d958b5bdd9bed712d6fddfd9f67a60d5655c4 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Tue, 3 Nov 2026 18:43:30 +0900 Subject: [PATCH 1/5] =?UTF-8?q?feat:=20=EB=B9=84=EB=B0=80=EB=B2=88?= =?UTF-8?q?=ED=98=B8=20=ED=95=B4=EC=8B=9C=EA=B8=B0=20PasswordHasher=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../stream/security/PasswordHasher.java | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PasswordHasher.java 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); + } +} From 64459b9fdb7aac1867b75ae883a68d2fe82537ba Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Tue, 3 Nov 2026 18:43:30 +0900 Subject: [PATCH 2/5] =?UTF-8?q?feat:=20=EC=9A=B4=EC=98=81=EC=A7=84=20?= =?UTF-8?q?=EC=9D=B8=EC=A6=9D=20=EC=97=90=EB=9F=AC=20=EC=BD=94=EB=93=9C?= =?UTF-8?q?=EC=99=80=20=EA=B3=B5=EC=9A=A9=20=EB=B9=84=EB=B0=80=EB=B2=88?= =?UTF-8?q?=ED=98=B8=20=EC=84=A4=EC=A0=95=20=ED=82=A4=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../admin/domain/AdminAuthConfigKeys.java | 9 ++++++++ .../admin/domain/AdminAuthErrorCode.java | 21 +++++++++++++++++++ 2 files changed, 30 insertions(+) create mode 100644 core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthConfigKeys.java create mode 100644 core/domain/auth/src/main/java/kr/ac/kookmin/stream/auth/domain/admin/domain/AdminAuthErrorCode.java 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; +} From 68693a0656019da99dda62498c70cde78724ea6a Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Tue, 3 Nov 2026 18:43:30 +0900 Subject: [PATCH 3/5] =?UTF-8?q?feat:=20=ED=95=99=EB=B2=88=EC=9C=BC?= =?UTF-8?q?=EB=A1=9C=20=ED=9A=8C=EC=9B=90=20=EC=A1=B0=ED=9A=8C=20=EC=84=9C?= =?UTF-8?q?=EB=B9=84=EC=8A=A4=20=EB=A9=94=EC=84=9C=EB=93=9C=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../stream/member/domain/member/service/MemberService.java | 3 +++ .../member/domain/member/service/impl/MemberServiceImpl.java | 5 +++++ 2 files changed, 8 insertions(+) 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); From 1ac87b7bc5a5fd0429c29cb9d96c00ba9ce7e8cc Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Tue, 3 Nov 2026 18:43:59 +0900 Subject: [PATCH 4/5] =?UTF-8?q?feat:=20=EC=9A=B4=EC=98=81=EC=A7=84=20?= =?UTF-8?q?=EB=A1=9C=EA=B7=B8=EC=9D=B8=20API=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- api/admin-api/build.gradle.kts | 1 + .../api/admin/core/auth/AdminAuthApi.java | 26 +++++++++ .../admin/core/auth/AdminAuthController.java | 26 +++++++++ .../core/auth/request/AdminLoginRequest.java | 15 +++++ .../auth/response/AdminLoginResponse.java | 9 +++ .../core/auth/usecase/AdminLoginUseCase.java | 55 +++++++++++++++++++ .../stream/security/PublicEndpoints.java | 3 + 7 files changed, 135 insertions(+) create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthApi.java create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthController.java create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/AdminLoginRequest.java create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/response/AdminLoginResponse.java create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/AdminLoginUseCase.java 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..e6e71c645 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthApi.java @@ -0,0 +1,26 @@ +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.core.auth.request.AdminLoginRequest; +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); +} 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..012eebec8 --- /dev/null +++ b/api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/AdminAuthController.java @@ -0,0 +1,26 @@ +package kr.ac.kookmin.stream.api.admin.core.auth; + +import jakarta.validation.Valid; +import kr.ac.kookmin.stream.api.admin.core.auth.request.AdminLoginRequest; +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.common.dto.ApiResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.PostMapping; +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; + + @Override + @PostMapping("/login") + public ApiResponse login(@Valid @RequestBody AdminLoginRequest request) { + return ApiResponse.success(adminLoginUseCase.login(request.studentId(), request.password())); + } +} 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/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/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()) From c22b00c7d49ac130a0116e85154b1ac08d17ddc6 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Tue, 3 Nov 2026 18:44:02 +0900 Subject: [PATCH 5/5] =?UTF-8?q?feat:=20=EA=B3=B5=EC=9A=A9=20=EB=B9=84?= =?UTF-8?q?=EB=B0=80=EB=B2=88=ED=98=B8=20=EB=B3=80=EA=B2=BD=20API=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../api/admin/core/auth/AdminAuthApi.java | 11 ++++++ .../admin/core/auth/AdminAuthController.java | 18 ++++++++++ .../request/SharedPasswordChangeRequest.java | 20 +++++++++++ .../usecase/SharedPasswordChangeUseCase.java | 34 +++++++++++++++++++ 4 files changed, 83 insertions(+) create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/request/SharedPasswordChangeRequest.java create mode 100644 api/admin-api/src/main/java/kr/ac/kookmin/stream/api/admin/core/auth/usecase/SharedPasswordChangeUseCase.java 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 index e6e71c645..1ee56a372 100644 --- 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 @@ -2,7 +2,9 @@ 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; @@ -23,4 +25,13 @@ public interface AdminAuthApi { @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 index 012eebec8..46df6b3d6 100644 --- 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 @@ -1,12 +1,18 @@ 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; @@ -17,10 +23,22 @@ 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/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/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); + } + } +}