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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user