jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add config for trusted networks auth provider (#8605)

Browse Source 
* Update providers.markdown

* Update providers.markdown
This commit is contained in:
Jason Hu 2019-02-26 16:58:46 -08:00 committed by Franck Nijhof
parent 02140fb2b1
commit 3514a7baea
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
source/_docs/authentication/providers.markdown
View File

@ -63,7 +63,7 @@ The Trusted Networks auth provider defines a range of IP addresses for which no
When you log in from one of these networks, you will be asked which user account to use and won't need to enter a password.
<p class='note info'>
The [multi-factor authentication module](/docs/authentication/multi-factor-auth/) will not participate in the login process if you using this auth provider.
The [multi-factor authentication module](/docs/authentication/multi-factor-auth/) will not participate in the login process if you are using this auth provider.
</p>
Here is an example in `configuration.yaml` to set up Trusted Networks:
@ -72,10 +72,6 @@ Here is an example in `configuration.yaml` to set up Trusted Networks:
homeassistant:
auth_providers:
- type: trusted_networks
# Temporary, this will be moved to be part of auth provider config
# https://github.com/home-assistant/home-assistant/issues/16149
http:
trusted_networks:
- 127.0.0.1
- ::1
@ -83,6 +79,8 @@ http:
- fd00::/8
```
If you don't specify any `auth_providers` section in the `configuration.yaml` file then this provider will be set up automatically if `trusted_networks` was configured under `http` section.
### {% linkable_title Command Line %}
The Command Line auth provider executes a configurable shell command to perform user authentication. Two environment variables, `username` and `password`, are passed to the command. Access is granted when the command exits successfully (with exit code 0).
@ -141,6 +139,8 @@ http:
Activating this auth provider will also allow you to provide the API password using an authentication header to make requests against the Home Assistant API. This feature will be dropped in the future in favor of long-lived access tokens.
If you don't specify any `auth_providers` section in the `configuration.yaml` file then this provider will be set up automatically if `api_password` was configured under `http` section.
<p class='note warning'>
[Issue 16441](https://github.com/home-assistant/home-assistant/issues/16441): the legacy API password auth provider, won't be automatically configured if your API password is located in a package. This is because Home Assistant processes the `auth_provider` during the `core` section loading, which is earlier than the `packages` processing.
</p>