Skip to content

Commit

Permalink
docs: proxy auth headers complementary documentation (#249)
Browse files Browse the repository at this point in the history
* add complementary documentation on how to setup auth headers passed by proxies.

Signed-off-by: Renato Farias <[email protected]>

* fix: typos
  • Loading branch information
renato-farias committed Jun 21, 2022
1 parent 9b00789 commit fd0356b
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -435,6 +435,22 @@ passing it as the `BASE_URL` environment variable.

When using an authentication proxy, Terraboard will retrieve the logged in
user and email from the headers passed by the proxy.
Terraboard expects you to setup the HTTP Headers `X-Forwarded-User` and
`X-Forwarded-Email` when passing the logged in user and email. A Nginx
example can be found below:

```nginx
location / {
....
auth_request_set $user $upstream_http_x_auth_request_user;
auth_request_set $email $upstream_http_x_auth_request_email;
proxy_set_header X-Forwarded-User $user;
proxy_set_header X-Forwarded-Email $email;
...
proxy_pass http://terraboard/;
}
```

You can also pass a `TERRABOARD_LOGOUT_URL` parameter to allow users to
sign out of the proxy.

Expand Down

0 comments on commit fd0356b

Please sign in to comment.