Authentication

In order to make Ariela extensible, we support 3 types of authentication to the Home Assistant server:

•  basic http api password (legacy support which can be removed by HA)
•  permanent token (HA version >= 0.78)
•  web login (HA version >= 0.78)

1.0 WiFi Name

Here you will enter the your home WiFi network name. Once you enter the WiFi name, click continue in order to proceed to the next screen.

NOTE: Whenever Ariela will detect that you are connected to this network, it will going to use the internal IP address of your Home Assistant server. Also, this network name will be automatically assigned to the zone.home, so if you enable device tracker for the device, whenever you are connected to this network, Ariela will automatically inform Home Assistant that your current location is home.

1.1 Certificate

In the case you are using a custom certificate like PCKS12 for security of your Home Assistant server or your server is running of NGINX, you can choose this option to import the certificate so it can be used by Ariela.

Use the “Search” option to your can inform Ariela of the certificate location and if required set the certificate password. Once these steps are completed, press the continue button. If you use a self-signed certificate, you can also skip this step, its quite possible the connection to succeed.

1.2 Internal IP

At this step, it will be required to enter the internal IP address of your Home Assistant server ( the address on your local network that can be used to access the server). This IP address will going to be used when Ariela detects that you are connected to the WiFi that you specified in the previous step. Note that if you enter an http (unsecured) address and you do not specify the port, 8123 default port will be used. In the case where you use an https (secured) address, and you do not specify the port, 443 will be used.

Example of valid internal IP:

http://192.168.1.20:8123 or http://192.168.1.20 for unsecured connection

https://192.168.1.20:443 or https://192.168.1.20 for secured connection

https://192.168.1.20:MY_PORT when you have a custom port for the connection.

If everything ok then something like that should appear. If not, please check your IP address and port and try again.

1.3 External IP

This option can be skipped if you want to access your Home Assistant server only from home. Else you can specify and external IP address (eg: an address that you use to connect to your Home Assistant from a 3G/ 4G or work etc). Note that the same rules will apply regarding the port as in the case of the internal IP. Here you can also use NabuCasa service which allows accessing your Home Assistant from anywhere in the world.

1.4 Credentials

Here you will enter your Home Assistant credentials consisting in the username and password. If no successful message appear or you are using 2FA please use the “Web Login” option.

If everything all right, after this step a connection confirmation should appear and Ariela should be able to start.

1.5 Web Login

Use this option if the native (previous) screen of authentication fails or your Home Assistant require 2FA. Note that if 2FA or similar service is used, do not close the app using the back button. What you should do is minimize the app, enter your 2FA app to generate a code, copy the code and switch back rapid to Ariela in order to not have the code expired.

If everything works as expected a confirmation dialog will appear and you should be able to use Ariela.

1.6 Throubleshoot

If you have any issue regarding authentication, please use the contact function in order to provide information about the problem.