Apache Reverse Proxy: отображение ошибки, возвращенной бекэндом, вместо просто "ошибка 500".

Содержание

Вопрос или проблема
Ответ или решение
Теория
Пример
Конфигурация:
Применение

Вопрос или проблема

У меня есть сервер Apache, работающий как обратный прокси для веб-сервиса, с конфигурацией, которая выглядит так:

<VirtualHost *:18010>

 SSLEngine on
 ProxyRequests off
 SSLProxyEngine on
 ProxyPass / https://backend.url:4445/
 ProxyPassReverse / https://backend.url:4445/
 SSLVerifyClient require
 SSLVerifyDepth 10
 SSLCACertificateFile ssl/cacerts.pem

</VirtualHost>

Который работает хорошо.
Однако, когда “клиенты” выполняют запросы к веб-сервису, работающему за URL, если бэкенд отвечает ошибкой, прокси просто показывает, что была ошибка 500, например:

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html><head>
<title>500 Internal Server Error</title>
</head><body>
<h1>Internal Server Error</h1>
<p>Сервер столкнулся с внутренней ошибкой или
неисправностью конфигурации и не смог завершить
ваш запрос.</p>
<p>Пожалуйста, свяжитесь с администратором сервера по
 [email protected], чтобы сообщить им время, когда произошла эта ошибка,
 и действия, которые вы выполнили непосредственно перед этой ошибкой.</p>
<p>Дополнительная информация об этой ошибке может быть доступна
в журнале ошибок сервера.</p>
</body></html>

В то время как при прямом запросе к веб-сервису, обходя прокси, мы можем увидеть “реальную” ошибку, возвращаемую сервером, такую как:

Ошибка 500: javax.servlet.ServletException: org.codehaus.jackson.map.exc.UnrecognizedPropertyException: Недопустимое поле &quot;test&quot; &#40; класс iseries.wsbeans.avews10.PrecheckInput&#41;, не отмечено
 в [Источник: com.ibm.ws.webcontainer.srt.SRTInputStream@6bd1f156&#59; строка: 1, столбец: 11] &#40;через цепочку ссылок: iseries.wsbeans.avews10.PrecheckPaymentInput[&quot;test&quot;]&#41;

Так что мой вопрос: есть ли опция добавления в конфигурацию Apache, чтобы он возвращал полную ошибку, возвращаемую бэкендом, а не просто ошибку 500?

ещё раз спасибо
с уважением,

Ответ или решение

Чтобы ответить на ваш вопрос о том, как сконфигурировать Apache в качестве обратного прокси, так чтобы он передавал более подробные сообщения об ошибках от бэкэнда, следует рассмотреть несколько аспектов конфигурации и безопасности. В вашем описании приведена конфигурация VirtualHost для Apache, которая работает как обратное прокси для веб-сервиса. Однако, когда сервер возвращает ошибку 500, пользователи видят лишь стандартное сообщение об ошибке Apache, а не полное сообщение об ошибке от бэкэнда. Рассмотрим, как можно изменить это поведение.

Теория

Apache, как правило, скрывает внутренние ошибки веб-сервисов по соображениям безопасности. Это делается для того, чтобы минимизировать риск раскрытия внутренней структуры приложения и возможных уязвимостей. Когда бэкэнд возвращает ошибку, такую как 500, Apache может настроить вывод сообщений об ошибках, используя такие модули, как mod_proxy и конфигурировать их так, чтобы ошибка была передана пользователю.

Пример

Для передачи более детальной информации, ответ от бэкэнда должен быть возвращен через прокси, а не заменен стандартной страницей об ошибке Apache. Это можно сделать, изменив конфигурацию Apache.

Конфигурация:

Используйте модуль mod_proxy:
Чтобы извлекать и передавать детализированные сообщения об ошибках с бэкэнда, убедитесь, что модуль mod_proxy и сопутствующие ему модули загружены:
```
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
```
Конфигурация ErrorDocument:
Если ErrorDocument включает обработку особых страниц ошибок Apache, замените это следующими настройками:
```
ProxyErrorOverride Off
```
Эта директива позволяет отключить механизм подмены сообщений об ошибках, и Apache передаст ответ от сервера как есть.
Конфигурация логов:
Убедитесь, что логирование достаточно подробное для выяснения проблем:
```
LogLevel debug
```

Применение

Настройте ваш VirtualHost:
В блоке VirtualHost убедитесь, что ProxyErrorOverride отключено:

<VirtualHost *:18010>
   SSLEngine on
   ProxyRequests off
   SSLProxyEngine on
   ProxyPass / https://backend.url:4445/
   ProxyPassReverse / https://backend.url:4445/
   SSLVerifyClient require
   SSLVerifyDepth 10
   SSLCACertificateFile ssl/cacerts.pem
   ProxyErrorOverride Off
</VirtualHost>

Проверка работоспособности:
Перезапустите Apache и протестируйте систему, чтобы обеспечить корректную передачу сообщений об ошибках через прокси. Используйте инструменты разработки браузера или инструменты командной строки, такие как curl, чтобы наблюдать за ответами.
Безопасность:
Имейте в виду, что иногда раскрытие внутренних ошибок может быть нежелательным из соображений безопасности. В некоторых случаях может быть более уместным логгировать детализированные ошибки и сообщать пользователям общие ошибки. Это требует сбалансированного подхода в зависимости от аудитории и уровня доверия.

Подводя итог, настройка ProxyErrorOverride Off позволит вам вернуть более детальную информацию об ошибках от бэкэнда через Apache-прокси. Однако стоит помнить, что это может привести к обнародованию потенциально чувствительной информации пользователям. Поэтому важно понимать и оценивать потенциал влияния на безопасность вашего приложения при принятии такого решения. Если вы обеспечите корректную защиту от утечек и уровень жизнеспособности вашего приложения, то данное решение может повысить его управляемость и выявляемость ошибок.

Apache Reverse Proxy: отображение ошибки, возвращенной бекэндом, вместо просто “ошибка 500”.