Аудит безопасности: 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()));
}
/** Ошибка ядра/рендера при формально корректном входе. */
/**
* Ошибка ядра/рендера при формально корректном входе. Сообщение ядра
* (тексты docx4j/FOP/JAXB, пути temp-файлов) — только в лог: наружу
* фиксированный текст, иначе 500 становится каналом внутренней информации.
* Регрессия — ConvertControllerTest#conversionFailure_hidesInternalDetails.
*/
@ExceptionHandler(ConversionFailedException.class)
ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) {
LOG.error("Конвертация не удалась", e);
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 ConversionFailedException} (500). Граница: сломанный контейнер
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и
* в конвейере ядра вход проверяется тем же
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, поэтому уже
* принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди
* проверяется только размер, корректность контейнера и число страниц —
* сериализованно внутри воркера (ядро вызывает тот же
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}), поэтому
* тяжёлая проверка не занимает потоки контейнера в обход сериализации.</p>
*/
@Service
final class ConversionService {
@@ -64,9 +65,9 @@ final class ConversionService {
}
/**
* Полный путь: синхронная валидация байтов (до очереди — от obvious-отказа
* единый воркер не должен быть занят) → постановка в очередь → ожидание
* результата с таймаутом.
* Полный путь: синхронная проверка размера (до очереди) → постановка
* в очередь → ожидание результата с таймаутом; корректность контейнера
* и число страниц проверяются сериализованно, внутри воркера (ядро).
*
* @throws ValidationException некорректный вход (400)
* @throws ConversionFailedException ошибка ядра/рендера (500)
@@ -78,14 +79,14 @@ final class ConversionService {
* {@code null} не допускается (контроллер строит всегда).</p>
*/
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
// Бинарный .doc — не zip: .docx-валидация к нему неприменима, размер
// проверяется общим checkInput, страницы — мостом по чистому .doc
// (ядро бросит ValidationException → 400 тем же обработчиком).
if (WordPdfValidator.isBinaryDoc(docxBytes)) {
WordPdfValidator.checkInput(docxBytes, options.maxMb());
} else {
WordPdfValidator.validate(docxBytes, options);
}
// До очереди — только дешёвый гейт размера. Полная валидация
// (контейнер + страницы — до двух полных распакованных проходов до
// 64 МБ на обоих форматах) сериализована воркером: её выполняет ядро
// внутри WordPdfConverter.convert (тот же validate с теми же
// options, ValidationException → 400 тем же путём). Синхронный
// полный validate до submit отдавал бы zip-бомбе потоки Tomcat
// в обход сериализации.
WordPdfValidator.checkInput(docxBytes, options.maxMb());
Future<byte[]> future;
try {
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
@@ -417,8 +417,14 @@ class ConvertControllerTest {
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("bad.docx", docxPackageWithGarbage())))
.andExpect(status().isInternalServerError())
.andExpect(jsonPath("$.error",
org.hamcrest.Matchers.containsString("Не удалось конвертировать")));
// фиксированный текст: сообщение ядра (docx4j/FOP/JAXB) —
// только в лог, наружу не уходит
.andExpect(jsonPath("$.error").value("Не удалось конвертировать документ"))
.andExpect(result -> {
String body = result.getResponse().getContentAsString();
assertTrue(!body.contains("docx4j") && !body.contains("Exception"),
"500 протёк внутренними деталями: " + body);
});
}
@Test