Fix: Swagger UI/OpenAPI под префиксом /pdf-converter, документация открыта без ключа #4
Reference in New Issue
Block a user
Delete Branch "fix/swagger-ui-base-path"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Проблема
На проде
https://pjandro.ru/pdf-converter/пути до OpenAPI/Swagger UI битые: наружный nginx срезает префикс, а springdoc генерирует абсолютные URL от корня хоста. ПлюсApiKeyFilterдавал 401 на документацию — браузер ключ в заголовок положить не может.Изменения
server.forward-headers-strategy=framework+springdoc.swagger-ui.persist-authorization=true— server спекаhttps://pjandro.ru/pdf-converter, configUrl с префиксом (проверено на jar сX-Forwarded-*).native-клапан TomcatX-Forwarded-Prefixне понимает.ApiKeyFilter: матч по пути без forwarded-contextPath (иначе под префиксным заголовком/actuator/health→ 401 и Docker HEALTHCHECK умрёт) + открытые без ключа/swagger-ui*,/v3/api-docs*;/api/**под ключом как раньше.OpenApiConfig:@SecuritySchemeX-API-Key → кнопка Authorize;@SecurityRequirementнаconvert→ «Try it out» шлёт ключ.openApiRequiresKey(пинил старую политику), добавленыdocsOpenWithoutKey,forwardedPrefix_healthStaysOpen,forwardedPrefix_docsOpenWithoutKey.Проверка
mvn clean verify— BUILD SUCCESS (core 104 + app 22). Смоук наjava -jarс ключом иX-Forwarded-Prefix/Proto/Host: health 200 без ключа,/v3/api-docsserverhttps://pjandro.ru/pdf-converter+ схемаApiKey,/swagger-ui.html→ 302 с префиксом, configUrl/pdf-converter/v3/api-docs/swagger-config, convert без ключа 401 / с ключом 200%PDF; без префиксных заголовков — корректные корневые URL.После мержа (вне репо)
Наружному nginx прод-хоста добавить в
location /pdf-converter/:proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Prefix /pdf-converter;; из прод-compose убрать env-ыSPRINGDOC_*_ENABLED=false;restart.sh --build(детали в DEPLOY.md).