From d09df6161169cdf304ad5d44ffbfaef8b85d2b97 Mon Sep 17 00:00:00 2001 From: Yegor Vialov Date: Wed, 27 Mar 2019 11:29:30 +0200 Subject: [PATCH] Update docs.md --- docs.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs.md b/docs.md index 3587559..9cc790c 100644 --- a/docs.md +++ b/docs.md @@ -51,6 +51,7 @@ Minimum supported Android API level is 21. That’s Android 5.0 and higher. [Back to top](#documentation) ## Authentication +### Prior HA Client 0.6.0 Starting from Home Assistant 0.78.0 `api_password` is a deprecated way to authenticate third party apps and services. You should use long-lived access tokens instead. To make HA Client use access token to authenticate you need: 1. Go to your Home Assistant web interface and open your profile settings (just click on your user picture in the top part of left menu) @@ -65,6 +66,18 @@ Starting from Home Assistant 0.78.0 `api_password` is a deprecated way to authen ![image](/assets/images/setting_access_token.png) +[Back to top](#documentation) +### HA Client 0.6.0 and higher +Starting from version 0.6.0 HA Client will be authenticating through [Home Assistant Authentication API](https://developers.home-assistant.io/docs/en/auth_api.html). You don't need to create and recreate access tokens any more. For now if HA Client is not authenticated yet or there is some issues logging in, it will ask you to login to your Home Assistant web interface with your credential: + +![image](/assets/images/oauth.png) + +After successfull login HA Client will get secure code, request long-lived token from Home Assistant automatically and store it is secure storage of your Android device. + +There is also 'Logout' option added. It will disconnect from Home Assistant, clear the UI and remove long-lived token from secure storage: + +![image](/assets/images/logout.png) + [Back to top](#documentation) ## UI Configuration By default HA Client UI is based on your Lovelace UI config, so it should display the same views as your Home Assistant web UI. It is still possible to switch off Lovelace UI in app settings. In this case app UI will be based on groups configuration, the same as old Home Assistant UI.