Fix: Swagger UI/OpenAPI под префиксом /pdf-converter, документация открыта без ключа

Прод (наружный nginx срезает /pdf-converter/): springdoc генерировал
абсолютные URL от корня хоста — пути до /v3/api-docs и swagger-ui битые.
server.forward-headers-strategy=framework + X-Forwarded-* (добавляет
наружный nginx) дают server https://pjandro.ru/pdf-converter и configUrl
с префиксом; 'native'-клапан Tomcat X-Forwarded-Prefix не понимает.

ApiKeyFilter: матч по пути без forwarded-contextPath (под префиксным
заголовком getRequestURI() включает префикс — HEALTHCHECK получил бы 401)
+ открытые без ключа /swagger-ui* и /v3/api-docs* (браузер не может
положить ключ в заголовок при загрузке UI; /api/** под ключом).
OpenApiConfig: @SecurityScheme X-API-Key — кнопка Authorize в UI,
@SecurityRequirement на convert — «Try it out» с ключом.
springdoc.swagger-ui.persist-authorization=true.

Регрессии: ApiKeyFilterTest#docsOpenWithoutKey,
#forwardedPrefix_healthStaysOpen, #forwardedPrefix_docsOpenWithoutKey
(вместо удалённого openApiRequiresKey). AGENTS.md синхронизирован.
This commit is contained in:
Pjandro
2026-10-15 21:13:42 +00:00
parent 05e3789358
commit c7dec86b54
7 changed files with 92 additions and 16 deletions
@@ -17,3 +17,11 @@ wordpdf.convert-timeout=2m
# Ключ доступа (заголовок X-API-Key). Пусто = аутентификация выключена
# (dev: java -jar / тесты). В docker-compose задан ${WORDPDF_API_KEY:?} — fail-closed.
wordpdf.api-key=
# Работа за префикс-срезающим прокси (прод: наружный nginx срезает
# /pdf-converter/): ForwardedHeaderFilter восстанавливает схему/хост/префикс из
# X-Forwarded-*, springdoc генерирует swagger-config и server спека с префиксом.
# 'native' (клапан Tomcat) X-Forwarded-Prefix не понимает — только 'framework'.
server.forward-headers-strategy=framework
# Swagger UI: не требовать ключ заново после перезагрузки страницы
springdoc.swagger-ui.persist-authorization=true