261102_01_ENH: 프로젝트 접근 권한 확인 API 추가 및 공통 사용자 Context 적용

This commit is contained in:
2026-11-02 15:12:58 +09:00
parent 9bf9cbe135
commit 32b3d374a3
16 changed files with 168 additions and 21 deletions

View File

@@ -0,0 +1,123 @@
package com.kri.kart.server.interceptor;
import com.kri.common.feature.web.BusinessException;
import com.kri.common.feature.web.RequestUserContext;
import com.kri.common.feature.web.RequestUserContextProvider;
import com.kri.kart.server.common.consts.KartConstant;
import com.kri.kart.server.dto.share.ShareLinkDto;
import com.kri.kart.server.service.ShareLinkService;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.net.URI;
import java.util.Map;
import java.util.Set;
import lombok.RequiredArgsConstructor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.HandlerMapping;
/** 공용 인증이 검증한 identity와 REPORT_URL을 사용한다. 일반 사용자 역할 제한과는 별개다. */
@RequiredArgsConstructor
public class ExternalAccessInterceptor implements HandlerInterceptor {
private final RequestUserContextProvider requestUserContextProvider;
private final ShareLinkService shareLinkService;
@Override
public boolean preHandle(
HttpServletRequest request, HttpServletResponse response, Object handler) {
String pattern =
String.valueOf(request.getAttribute(HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE));
if ("POST".equals(request.getMethod())
&& Set.of("/api/v1/external/{urlKey}/login", "/api/v1/auth/login").contains(pattern)) {
// A new link or credential login may replace a previous external identity.
return true;
}
RequestUserContext ctx = requestUserContextProvider.resolve(request);
String userId = ctx.getUserId();
boolean externalRole =
Integer.valueOf(KartConstant.EXTERNAL_URL_COPY_ROLE).equals(ctx.getUserRole())
|| Integer.valueOf(KartConstant.EXTERNAL_PAGE_COPY_ROLE).equals(ctx.getUserRole());
boolean externalTeam = KartConstant.EXTERNAL_TEAM.equals(ctx.getUserTeam());
boolean externalId = userId != null && userId.startsWith(KartConstant.EXTERNAL_USER_PREFIX);
if (!externalRole && !externalTeam && !externalId) {
return true;
}
if (!externalRole || !externalTeam || !externalId) {
throw denied();
}
String urlKey = userId.substring(KartConstant.EXTERNAL_USER_PREFIX.length());
ShareLinkDto link =
(ShareLinkDto) request.getAttribute(KartConstant.REQUEST_LINK_ATTRIBUTE);
if (link == null || !urlKey.equals(link.urlKey())) {
link = shareLinkService.lookup(urlKey);
}
int expectedRole =
link.pageOnly()
? KartConstant.EXTERNAL_PAGE_COPY_ROLE
: KartConstant.EXTERNAL_URL_COPY_ROLE;
if (!Integer.valueOf(expectedRole).equals(ctx.getUserRole())) {
throw denied();
}
@SuppressWarnings("unchecked")
Map<String, String> variables =
(Map<String, String>) request.getAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);
if (variables == null
|| !link.projectType().getCode().toString().equals(variables.get("projectType"))
|| !link.pkey().equals(variables.get("pkey"))) {
// Visit body scope is checked in LogController after JSON binding.
if (!"/api/v1/log/visit".equals(pattern) || !"POST".equals(request.getMethod())) {
throw denied();
}
}
String page = URI.create(link.realUrl()).getPath();
boolean allowed = "/api/v1/log/visit".equals(pattern);
if ("GET".equals(request.getMethod())) {
allowed |= pattern.equals("/api/v1/project/{projectType}/{pkey}/access");
allowed |=
Set.of(
"/api/v1/project/{projectType}/{pkey}/question/list",
"/api/v1/project/{projectType}/{pkey}/question/{qid}")
.contains(pattern);
allowed |=
(!link.pageOnly() || page.equals("/Report/Current"))
&& Set.of(
"/api/v1/project/{projectType}/{pkey}/progress/day",
"/api/v1/project/{projectType}/{pkey}/progress/type",
"/api/v1/project/{projectType}/{pkey}/progress/loi",
"/api/v1/project/{projectType}/{pkey}/progress/screen")
.contains(pattern);
allowed |=
(!link.pageOnly() || page.equals("/Report/Quota"))
&& pattern.equals("/api/v1/quota/{projectType}/{pkey}/list");
if (pattern.equals("/api/v1/project/{projectType}/{pkey}/bookmark/list")) {
String bookmarkPage = request.getParameter("page");
allowed |=
Set.of("TABULATION", "CROSSTAB").contains(bookmarkPage == null ? "" : bookmarkPage)
&& (!link.pageOnly()
|| (page.equals("/Report/Tabulation") && "TABULATION".equals(bookmarkPage))
|| (page.equals("/Report/Crosstab") && "CROSSTAB".equals(bookmarkPage)));
}
} else if ("POST".equals(request.getMethod())) {
allowed |=
(!link.pageOnly() || Set.of("/Report/Tabulation", "/Report/Crosstab").contains(page))
&& pattern.equals("/api/v1/project/{projectType}/{pkey}/export/excel/table");
allowed |=
(!link.pageOnly() || page.equals("/Report/Quota"))
&& pattern.equals("/api/v1/quota/{projectType}/{pkey}/export/excel");
allowed |=
(!link.pageOnly() || Set.of("/Report/Tabulation", "/Report/Crosstab").contains(page))
&& pattern.equals("/api/v1/project/{projectType}/{pkey}/statistics/result");
allowed |=
(!link.pageOnly() || page.equals("/Report/Quota"))
&& pattern.equals("/api/v1/quota/{projectType}/{pkey}/{quotaOrder}/result");
}
if (!allowed) {
throw denied();
}
request.setAttribute(KartConstant.REQUEST_LINK_ATTRIBUTE, link);
return true;
}
private BusinessException denied() {
return BusinessException.forbidden("EXTERNAL_SCOPE_DENIED", "이 공유 링크에서 허용되지 않는 요청입니다.");
}
}

View File

@@ -0,0 +1,58 @@
package com.kri.kart.server.interceptor;
import com.kri.common.feature.web.BusinessException;
import com.kri.common.feature.web.RequestUserContext;
import com.kri.common.feature.web.RequestUserContextProvider;
import com.kri.kart.server.common.consts.KartConstant;
import com.kri.kart.server.common.enums.ProjectType;
import com.kri.kart.server.dto.project.ProjectRefDto;
import com.kri.kart.server.service.ProjectService;
import jakarta.servlet.DispatcherType;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.util.Map;
import lombok.RequiredArgsConstructor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.HandlerMapping;
@RequiredArgsConstructor
public class ProjectAccessInterceptor implements HandlerInterceptor {
private final RequestUserContextProvider requestUserContextProvider;
private final ProjectService projectService;
@Override
public boolean preHandle(
HttpServletRequest request, HttpServletResponse response, Object handler) {
// ExternalAccessInterceptor has already checked the stored project/page/API scope.
if (request.getDispatcherType() == DispatcherType.ASYNC
|| request.getAttribute(KartConstant.REQUEST_LINK_ATTRIBUTE) != null) {
return true;
}
@SuppressWarnings("unchecked")
Map<String, String> variables =
(Map<String, String>) request.getAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);
if (variables == null
|| !variables.containsKey("projectType")
|| !variables.containsKey("pkey")) {
return true;
}
RequestUserContext ctx = requestUserContextProvider.resolve(request);
if (!ctx.isAuthenticated()) {
throw unauthenticated();
}
ProjectRefDto project;
try {
project = new ProjectRefDto(
ProjectType.fromCode(Integer.valueOf(variables.get("projectType"))),
variables.get("pkey"));
} catch (IllegalArgumentException exception) {
throw BusinessException.badRequest("projectType 또는 pkey가 올바르지 않습니다.");
}
projectService.requireAccess(project, ctx);
return true;
}
private BusinessException unauthenticated() {
return BusinessException.unauthorized("PROJECT_IDENTITY_REQUIRED", "프로젝트 접근 인증 정보가 필요합니다.");
}
}