Ревью-фиксы: DoS chart-XML, корректность вывода, auth-обход, стандарты OOXML в docs/ #36

Merged
pjandro merged 7 commits from ooxml-review-hardening into main 2026-10-25 00:53:34 +03:00
9 changed files with 77 additions and 15 deletions
Showing only changes of commit f4b92f2140 - Show all commits
@@ -2,6 +2,7 @@ package ru.pjandro.wordpdf.app;
import org.slf4j.Logger; import org.slf4j.Logger;
import org.slf4j.LoggerFactory; import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpStatus; import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MissingServletRequestParameterException; import org.springframework.web.bind.MissingServletRequestParameterException;
@@ -9,6 +10,7 @@ import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.multipart.MaxUploadSizeExceededException; import org.springframework.web.multipart.MaxUploadSizeExceededException;
import org.springframework.web.multipart.support.MissingServletRequestPartException; import org.springframework.web.multipart.support.MissingServletRequestPartException;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import org.springframework.web.servlet.resource.NoResourceFoundException; import org.springframework.web.servlet.resource.NoResourceFoundException;
import ru.pjandro.wordpdf.ValidationException; import ru.pjandro.wordpdf.ValidationException;
@@ -26,6 +28,13 @@ final class ApiExceptionHandler {
private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class); private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class);
/** Значение {@code spring.servlet.multipart.max-file-size} — для текста 413. */
private final String maxFileSize;
ApiExceptionHandler(@Value("${spring.servlet.multipart.max-file-size:100MB}") String maxFileSize) {
this.maxFileSize = maxFileSize;
}
/** Тело ответа ошибки; Jackson сериализует record как есть. */ /** Тело ответа ошибки; Jackson сериализует record как есть. */
record ApiError(String error) { record ApiError(String error) {
} }
@@ -65,15 +74,16 @@ final class ApiExceptionHandler {
} }
/** /**
* Контейнерный потолок multipart (100 МБ в application.properties) * Контейнерный потолок multipart ({@code spring.servlet.multipart.max-file-size})
* сработал раньше ядра: срабатывает только на инфраструктурный лимит, * сработал раньше ядра: срабатывает только на инфраструктурный лимит,
* авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB}) * авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB})
* проверяет {@code WordPdfValidator} и отвечает 400 своим текстом. * проверяет {@code WordPdfValidator} и отвечает 400 своим текстом.
* Текст берётся из свойства — не расходится с реальной конфигурацией сервера.
*/ */
@ExceptionHandler(MaxUploadSizeExceededException.class) @ExceptionHandler(MaxUploadSizeExceededException.class)
ResponseEntity<ApiError> tooLarge(MaxUploadSizeExceededException e) { ResponseEntity<ApiError> tooLarge(MaxUploadSizeExceededException e) {
return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE) return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE)
.body(new ApiError("Файл больше 100 МБ")); .body(new ApiError("Файл больше " + maxFileSize + " — лимит multipart сервера"));
} }
/** Партита {@code file} нет в запросе — обе формы исключения возможны. */ /** Партита {@code file} нет в запросе — обе формы исключения возможны. */
@@ -96,6 +106,13 @@ final class ApiExceptionHandler {
.body(new ApiError("Не найдено")); .body(new ApiError("Не найдено"));
} }
/** Битое значение факультативного параметра (errorOnCharts=tru3) — ошибка клиента. */
@ExceptionHandler(MethodArgumentTypeMismatchException.class)
ResponseEntity<ApiError> badParam(MethodArgumentTypeMismatchException e) {
return ResponseEntity.badRequest()
.body(new ApiError("Некорректное значение параметра «" + e.getName() + "»"));
}
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */ /** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
@ExceptionHandler(Exception.class) @ExceptionHandler(Exception.class)
ResponseEntity<ApiError> unexpected(Exception e) { ResponseEntity<ApiError> unexpected(Exception e) {
@@ -24,6 +24,11 @@ import java.security.MessageDigest;
* *
* <p>Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen, * <p>Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen,
* ApiKeyFilterTest#docsOpenWithoutKey.</p> * ApiKeyFilterTest#docsOpenWithoutKey.</p>
*
* <p>Путь с точечными сегментами ({@code ..}, {@code %2e}) не считается
* открытым: контейнер матчит по сырому URI, а нормализацию {@code /actuator/../api/…}
* может выполнить последующий обработчик — ключ спрашиваем всегда.
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.</p>
*/ */
@Component @Component
final class ApiKeyFilter extends OncePerRequestFilter { final class ApiKeyFilter extends OncePerRequestFilter {
@@ -33,6 +38,10 @@ final class ApiKeyFilter extends OncePerRequestFilter {
/** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */ /** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */
private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"}; private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"};
/** Точечные сегменты в сыром URI — не «открытый» путь (см. javadoc класса). */
private static final String DOT_SEGMENT = "..";
private static final String ENCODED_DOT = "%2e";
/** null — аутентификация выключена. */ /** null — аутентификация выключена. */
private final byte[] expected; private final byte[] expected;
@@ -73,6 +82,10 @@ final class ApiKeyFilter extends OncePerRequestFilter {
} }
private static boolean isOpen(String path) { private static boolean isOpen(String path) {
if (path.contains(DOT_SEGMENT)
|| path.toLowerCase(java.util.Locale.ROOT).contains(ENCODED_DOT)) {
return false;
}
for (String prefix : OPEN_PREFIXES) { for (String prefix : OPEN_PREFIXES) {
if (path.startsWith(prefix)) { if (path.startsWith(prefix)) {
return true; return true;
@@ -17,7 +17,7 @@ import static org.junit.jupiter.api.Assertions.assertFalse;
*/ */
class ApiExceptionHandlerTest { class ApiExceptionHandlerTest {
private final ApiExceptionHandler handler = new ApiExceptionHandler(); private final ApiExceptionHandler handler = new ApiExceptionHandler("100MB");
/** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */ /** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */
@Test @Test
@@ -42,7 +42,7 @@ class ApiExceptionHandlerTest {
void tooLarge_returns413ContainerLimit() { void tooLarge_returns413ContainerLimit() {
var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024)); var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024));
assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode()); assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode());
assertEquals("Файл больше 100 МБ", response.getBody().error()); assertEquals("Файл больше 100MB — лимит multipart сервера", response.getBody().error());
} }
/** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */ /** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */
@@ -113,4 +113,18 @@ class ApiKeyFilterTest {
mockMvc.perform(get("/v3/api-docs").header("X-Forwarded-Prefix", "/pdf-converter")) mockMvc.perform(get("/v3/api-docs").header("X-Forwarded-Prefix", "/pdf-converter"))
.andExpect(status().isOk()); .andExpect(status().isOk());
} }
/**
* {@code /actuator/../api/v1/convert}: фильтр матчает по сырому URI, но
* нормализацию может выполнить последующий обработчик — путь с точечными
* сегментами не «открытый», ключ спрашивается всегда.
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.
*/
@Test
void dotSegmentOpenPrefix_rejected() throws Exception {
mockMvc.perform(get("/actuator/../api/v1/convert"))
.andExpect(status().isUnauthorized());
mockMvc.perform(get(java.net.URI.create("/actuator/%2e%2e/api/v1/convert")))
.andExpect(status().isUnauthorized());
}
} }
@@ -218,6 +218,21 @@ class ConvertControllerTest {
org.hamcrest.Matchers.containsString("OLE-объект"))); org.hamcrest.Matchers.containsString("OLE-объект")));
} }
/**
* errorOnCharts=tru3 — некорректное значение факультативного параметра:
* 400 с именем параметра (не 500 от catch-all).
* Регрессия — ConvertControllerTest#errorFlagNotBoolean_rejected.
*/
@Test
void errorFlagNotBoolean_rejected() throws Exception {
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("ru-plain.docx", bytes("/samples/ru-plain.docx")))
.param("errorOnCharts", "tru3"))
.andExpect(status().isBadRequest())
.andExpect(jsonPath("$.error",
org.hamcrest.Matchers.containsString("errorOnCharts")));
}
/** /**
* Без параметров OLE-объекты тихо удаляются: 200, PDF. * Без параметров OLE-объекты тихо удаляются: 200, PDF.
* Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted, * Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted,
@@ -37,7 +37,9 @@ import java.io.OutputStream;
* подменяются метрически совместимыми open-source аналогами * подменяются метрически совместимыми open-source аналогами
* (см. {@link BundledFontMapper}). * (см. {@link BundledFontMapper}).
* *
* Класс stateless, все методы статические. * Класс stateless, все методы статические. Класс НЕ потокобезопасен:
* конвертации из нескольких потоков необходимо сериализовать (глобальный
* реестр {@code PhysicalFonts}, кэши шрифтов/покрытия).
*/ */
public final class WordPdfConverter { public final class WordPdfConverter {
@@ -146,6 +146,9 @@ public final class BundledFonts {
"Шрифт не найден в jar: " + CLASSPATH_DIR + "/" + entry.file()); "Шрифт не найден в jar: " + CLASSPATH_DIR + "/" + entry.file());
} }
Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING); Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING);
// deleteOnExit не рекурсивен: каталог удалится только пустым,
// поэтому регистрируем каждый выгруженный TTF.
target.toFile().deleteOnExit();
} catch (IOException e) { } catch (IOException e) {
throw new IllegalStateException("Не удалось выгрузить шрифт " + entry.file(), e); throw new IllegalStateException("Не удалось выгрузить шрифт " + entry.file(), e);
} }
@@ -46,7 +46,7 @@ public final class GlyphFont {
private final String key; private final String key;
private final TrueTypeFont ttf; private final TrueTypeFont ttf;
private CmapLookup cmap; private volatile CmapLookup cmap;
private GlyphFont(String key, TrueTypeFont ttf) { private GlyphFont(String key, TrueTypeFont ttf) {
this.key = key; this.key = key;
@@ -75,8 +75,8 @@ public final class GlyphCoverageNormalizer {
private static final Pattern NUMERIC_ENTITY = Pattern.compile( private static final Pattern NUMERIC_ENTITY = Pattern.compile(
"&#(x?)([0-9A-Fa-f]+);"); "&#(x?)([0-9A-Fa-f]+);");
/** Кэш покрытия: семейство -> множества проверенных/покрытых кодов. */ /** Кэш покрытия: семейство -> множества проверенных/покрытых кодов (общий между конвертациями). */
private static final Map<String, Coverage> COVERAGE = new HashMap<>(); private static final Map<String, Coverage> COVERAGE = new java.util.concurrent.ConcurrentHashMap<>();
private GlyphCoverageNormalizer() { private GlyphCoverageNormalizer() {
} }
@@ -337,12 +337,8 @@ public final class GlyphCoverageNormalizer {
} }
private static Coverage coverage(String family) { private static Coverage coverage(String family) {
Coverage c = COVERAGE.get(family); return COVERAGE.computeIfAbsent(family,
if (c == null) { f -> new Coverage(GlyphFont.of(f, BundledFonts.V_REGULAR)));
c = new Coverage(GlyphFont.of(family, BundledFonts.V_REGULAR));
COVERAGE.put(family, c);
}
return c;
} }
/** /**
@@ -362,7 +358,9 @@ public final class GlyphCoverageNormalizer {
this.font = font; this.font = font;
} }
boolean covers(int cp) { // synchronized: BitSet не потокобезопасен (рост words[] и порядок
// checked/covered под гонкой дают ложное «не покрыт»).
synchronized boolean covers(int cp) {
if (font == null || cp < 0) { if (font == null || cp < 0) {
return false; return false;
} }