docs: update proxy docs

This commit is contained in:
Jens Langhammer 2020-10-29 22:12:13 +01:00
parent 4e1808632d
commit 4ffc0e2a08
2 changed files with 22 additions and 3 deletions

View File

@ -25,6 +25,17 @@ This guide requires https://github.com/BeryJu/hass-auth-header, which can be ins
Afterwards, make sure the `trusted_proxies` setting contains the IP(s) of the Host(s) passbook is running on. Afterwards, make sure the `trusted_proxies` setting contains the IP(s) of the Host(s) passbook is running on.
With the default Header of `X-Forwarded-Preferred-Username` matching is done on a username basis, so your Name in Home-Assistant and your username in passbook have to match.
If this is not the case, you can simply add an additional header for your user, which contains the Home-Assistant Name and authenticate based on that.
For example add this to your user's properties and set the Header to `X-pb-hass-user`.
```yaml
additionalHeaders:
X-pb-hass-user: some other name
```
## passbook ## passbook
Create a Proxy Provider with the following values Create a Proxy Provider with the following values

View File

@ -11,6 +11,14 @@ The Proxy these extra headers to the application:
Header Name | Value Header Name | Value
-------------|------- -------------|-------
X-Auth-Request-User | The user's unique identifier X-Forwarded-User | The user's unique identifier (**not the username**)
X-Auth-Request-Email | The user's email address X-Forwarded-Email | The user's email address
X-Auth-Request-Preferred-Username | The user's username X-Forwarded-Preferred-Username | The user's username
X-Auth-Username | The user's username
Additionally, you can add more custom headers using `additionalHeaders` in the User or Group Properties, for example
```yaml
additionalHeaders:
X-additional-header: bar
```