From fe92af5ffd4f1cb28a984deec1fb2574ff4874b4 Mon Sep 17 00:00:00 2001 From: Anupam Kumar Date: Tue, 4 Nov 2025 19:38:16 +0530 Subject: [PATCH] chore: add reverse proxy test guide Signed-off-by: Anupam Kumar --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/README.md b/README.md index 2b44b04..b5198a3 100644 --- a/README.md +++ b/README.md @@ -445,6 +445,41 @@ These checks run **inside the HaRP container** (e.g., `docker exec -it appapi-ha # Expected: OK ``` +### Verify that the Reverse Proxy configuration is correct + +Stop the HaRP container temporarily and start a dummy server with `nc` (netcat) to confirm that your reverse proxy is forwarding requests correctly with all the headers: + +```bash +# Stop HaRP container +docker stop appapi-harp +# Start a dummy server on the same port as HaRP's ExApps frontend +nc -l -k -p 8780 +``` + +Now, send a request through your reverse proxy to the ExApps endpoint (e.g., `https://cloud.example.com/exapps/hello`): + +```bash +curl -v https://cloud.example.com/exapps/hello +``` + +For nginx, you should see output similar to this in the terminal where `nc` is running: + +``` +GET /exapps/hello HTTP/1.1 +Host: cloud.example.com +Connection: close +X-Real-IP: 20.207.73.82 +X-Forwarded-For: 20.207.73.82 192.168.21.1 +X-Forwarded-Host: cloud.example.com +X-Forwarded-Proto: https +X-Forwarded-Ssl: on +X-Forwarded-Port: 443 +X-Original-URI: /exapps/hello +X-Forwarded-Proto: https +user-agent: curl/8.11.1 +accept: */* +``` + ## Contributing Contributions to HaRP are welcome. Feel free to open issues, discussions or submit pull requests with improvements, bug fixes, or new features.