Аудит безопасности: OOM-гейты входа, потокобезопасность, периметр #99

Merged
pjandro merged 7 commits from audit-security-memory-threading into main 2026-11-08 23:38:05 +03:00
3 changed files with 32 additions and 19 deletions
Showing only changes of commit 638e28c653 - Show all commits
@@ -63,11 +63,17 @@ final class ApiExceptionHandler {
.body(new ApiError(e.getMessage())); .body(new ApiError(e.getMessage()));
} }
/** Ошибка ядра/рендера при формально корректном входе. */ /**
* Ошибка ядра/рендера при формально корректном входе. Сообщение ядра
* (тексты docx4j/FOP/JAXB, пути temp-файлов) — только в лог: наружу
* фиксированный текст, иначе 500 становится каналом внутренней информации.
* Регрессия — ConvertControllerTest#conversionFailure_hidesInternalDetails.
*/
@ExceptionHandler(ConversionFailedException.class) @ExceptionHandler(ConversionFailedException.class)
ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) { ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) {
LOG.error("Конвертация не удалась", e);
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
.body(new ApiError(e.getMessage())); .body(new ApiError("Не удалось конвертировать документ"));
} }
/** Очередь конвертации занята/прерывание — повторить позже. */ /** Очередь конвертации занята/прерывание — повторить позже. */
@@ -35,10 +35,11 @@ import java.util.concurrent.TimeoutException;
* {@link ValidationException} (400), ошибка рендер-стадии → * {@link ValidationException} (400), ошибка рендер-стадии →
* {@link ConversionFailedException} (500). Граница: сломанный контейнер * {@link ConversionFailedException} (500). Граница: сломанный контейнер
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный * (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и * zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди
* в конвейере ядра вход проверяется тем же * проверяется только размер, корректность контейнера и число страниц —
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, поэтому уже * сериализованно внутри воркера (ядро вызывает тот же
* принятый запрос внутренняя проверка ядра в ошибку не превратит.</p> * {@link WordPdfValidator#validate(byte[], ConvertOptions)}), поэтому
* тяжёлая проверка не занимает потоки контейнера в обход сериализации.</p>
*/ */
@Service @Service
final class ConversionService { final class ConversionService {
@@ -64,9 +65,9 @@ final class ConversionService {
} }
/** /**
* Полный путь: синхронная валидация байтов (до очереди — от obvious-отказа * Полный путь: синхронная проверка размера (до очереди) → постановка
* единый воркер не должен быть занят) → постановка в очередь → ожидание * в очередь → ожидание результата с таймаутом; корректность контейнера
* результата с таймаутом. * и число страниц проверяются сериализованно, внутри воркера (ядро).
* *
* @throws ValidationException некорректный вход (400) * @throws ValidationException некорректный вход (400)
* @throws ConversionFailedException ошибка ядра/рендера (500) * @throws ConversionFailedException ошибка ядра/рендера (500)
@@ -78,14 +79,14 @@ final class ConversionService {
* {@code null} не допускается (контроллер строит всегда).</p> * {@code null} не допускается (контроллер строит всегда).</p>
*/ */
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) { byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
// Бинарный .doc — не zip: .docx-валидация к нему неприменима, размер // До очереди — только дешёвый гейт размера. Полная валидация
// проверяется общим checkInput, страницы — мостом по чистому .doc // (контейнер + страницы — до двух полных распакованных проходов до
// (ядро бросит ValidationException → 400 тем же обработчиком). // 64 МБ на обоих форматах) сериализована воркером: её выполняет ядро
if (WordPdfValidator.isBinaryDoc(docxBytes)) { // внутри WordPdfConverter.convert (тот же validate с теми же
WordPdfValidator.checkInput(docxBytes, options.maxMb()); // options, ValidationException → 400 тем же путём). Синхронный
} else { // полный validate до submit отдавал бы zip-бомбе потоки Tomcat
WordPdfValidator.validate(docxBytes, options); // в обход сериализации.
} WordPdfValidator.checkInput(docxBytes, options.maxMb());
Future<byte[]> future; Future<byte[]> future;
try { try {
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options)); future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
@@ -417,8 +417,14 @@ class ConvertControllerTest {
mockMvc.perform(multipart("/api/v1/convert") mockMvc.perform(multipart("/api/v1/convert")
.file(docx("bad.docx", docxPackageWithGarbage()))) .file(docx("bad.docx", docxPackageWithGarbage())))
.andExpect(status().isInternalServerError()) .andExpect(status().isInternalServerError())
.andExpect(jsonPath("$.error", // фиксированный текст: сообщение ядра (docx4j/FOP/JAXB) —
org.hamcrest.Matchers.containsString("Не удалось конвертировать"))); // только в лог, наружу не уходит
.andExpect(jsonPath("$.error").value("Не удалось конвертировать документ"))
.andExpect(result -> {
String body = result.getResponse().getContentAsString();
assertTrue(!body.contains("docx4j") && !body.contains("Exception"),
"500 протёк внутренними деталями: " + body);
});
} }
@Test @Test