API: ключ доступа X-API-Key и серверные лимиты входа

ApiKeyFilter — единственная граница доступа: сверяет X-API-Key со
свойством wordpdf.api-key (env WORDPDF_API_KEY, MessageDigest.isEqual);
пустое свойство = аутентификация выключена; /actuator/** открыт для
HEALTHCHECK; 401 отдаёт сам фильтр. Лимиты входа задаёт только
конфигурация сервера (wordpdf.max-bytes/max-pages, env
WORDPDF_MAX_BYTES/WORDPDF_MAX_PAGES, @Value с дефолтом-SpEL из констант
ядра; <=0 — падение на старте), параметрами запроса не переопределяются
(регрессии requestLimitParams_areIgnored, nonPositiveLimits_failStartup).
Конвертация — байты насквозь; опции рисования из запроса → ConvertOptions.
This commit is contained in:
Pjandro
2026-10-14 01:50:35 +00:00
parent 0a411a944b
commit 25ed56bf20
10 changed files with 443 additions and 76 deletions
@@ -1,10 +1,19 @@
spring.application.name=wordpdf-app
# 6MB, а не 5MB: авторитетный лимит — ядро (WordPdfValidator.MAX_INPUT_BYTES
# = 5 MiB = 5 242 880 Б). С multipart-лимитом «5MB» (5 000 000 Б) файлы
# 5.0–5.24 МБ отбивались бы контейнером с неверным текстом ошибки раньше ядра.
# file-size-threshold=6MB держит файл в памяти (ядро и так читает всё в RAM).
spring.servlet.multipart.max-file-size=6MB
spring.servlet.multipart.max-request-size=6MB
spring.servlet.multipart.file-size-threshold=6MB
# Потолок инфраструктуры — 100 МБ (совпадает с client_max_body_size в
# nginx-шлюзах): больше не пропустит ни шлюз, ни контейнер. Авторитетный
# лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES), по умолчанию
# WordPdfSettings.MAX_INPUT_BYTES = 20 MiB; здесь только потолок загрузки.
# Лимиты входа: env WORDPDF_MAX_BYTES (байты) / WORDPDF_MAX_PAGES (страницы),
# дефолты — константы ядра (20 MiB / 1000), задаются ConvertController.
# Значение <= 0 — падение на старте. Сами ключи здесь не объявлены:
# пустое значение затенит SpEL-дефолт @Value.
# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM).
spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=100MB
spring.servlet.multipart.file-size-threshold=100MB
# Таймаут одной конвертации (binding Duration в ConversionService)
wordpdf.convert-timeout=2m
# Ключ доступа (заголовок X-API-Key). Пусто = аутентификация выключена
# (dev: java -jar / тесты). В docker-compose задан ${WORDPDF_API_KEY:?} — fail-closed.
wordpdf.api-key=