From 95249e11255beb8b85f904c54429b353fca40b9e Mon Sep 17 00:00:00 2001
From: Pierre <397503+bemble@users.noreply.github.com>
Date: Mon, 30 May 2022 17:04:41 +0200
Subject: [PATCH] doc(auth): add auth proxy documentation

---
 docs/configuration.md   | 3 ++-
 docs/troubleshooting.md | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/configuration.md b/docs/configuration.md
index 84a7ea7..c240077 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -25,7 +25,8 @@ header: true # Set to false to hide the header
 footer: '<p>Created with <span class="has-text-danger">❤️</span> with <a href="https://bulma.io/">bulma</a>, <a href="https://vuejs.org/">vuejs</a> & <a href="https://fontawesome.com/">font awesome</a> // Fork me on <a href="https://github.com/bastienwirtz/homer"><i class="fab fa-github-alt"></i></a></p>' # set false if you want to hide it.
 
 columns: "3" # "auto" or number (must be a factor of 12: 1, 2, 3, 4, 6, 12)
-connectivityCheck: true # whether you want to display a message when the apps are not accessible anymore (VPN disconnected for example)
+connectivityCheck: true # whether you want to display a message when the apps are not accessible anymore (VPN disconnected for example).
+                        # You should set it to true when using an authentication proxy, it also reloads the page when a redirection is detected when checking connectivity.
 
 # Optional: Proxy / hosting option
 proxy:
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 649e5a6..10d6c2d 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -17,3 +17,9 @@ To resolve this, you can either:
 * Host all your target service under the same domain & port.
 * Modify the target server configuration so that the response of the server included following header- `Access-Control-Allow-Origin: *` (<https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#simple_requests>). It might be an option in the targeted service, otherwise depending on how the service is hosted, the proxy or web server can seamlessly add it.
 * Use a cors proxy server like [`cors-container`](https://github.com/imjacobclark/cors-container), [`cors-anywhere`](https://github.com/Rob--W/cors-anywhere) or many others.
+
+## I am using an authentication proxy and homer says I am offline
+
+This should be a configuration issue.
+* Make sure the option `connectivityCheck` is set to `true` in configuration.
+* Check your proxy configuration, the expected behavior is to redirect user using a 302 to the login page when user is not authenticated.
-- 
2.41.0