UniFi Network integration - official thread

You can do it in the new UI too

Can you give me a more detailed description and I will update the integration documentation

Based on the Protect documentation:

Local user

You will need a local user created in your UniFi OS Console to log in with. Ubiquiti SSO Cloud Users will not work. It is recommended you use the Administrator or a user with full read/write access to get the most out of the integration, but it is not required. The entities that are created will automatically adjust based on the permissions of the user you use has.

  • Login to your UniFi OS device. This can be done from the UniFi OS by accessing it directly by IP address (i.e. Local Portal), in the Unifi Network app or via unifi.ui.com.

  • Click on Admins & Users from the left hand side menu

  • Click on the ⊕ Add Admin in the top right corner.

  • Select Full Management for the role.

  • Check Restrict to local access only and fill out the Username and Password fields for your user.

  • Click Add in the bottom right.

2 Likes

Thank you. PR is up Improve UniFi documentation by Kane610 · Pull Request #35342 · home-assistant/home-assistant.io · GitHub

Does anyone know how you can re-enter credentials for the integration? I also got authentication errors so I created a new local admin with readonly permissions. However, I cannot find the option to change the credentails.

1 Like

I did fix it the manual way: edit the config file directly from the file-system

ssh into your hass server
enter the config subfolder .storage:
$ cd config
$ cd .storage/

make a backup of the config file to be sure:
$ cp core.config_entries core.config_entries.backup_20241114

edit the config file:
$ nano core.config_entries

reload your unifi network integration in the GUI
1 Like

You should be able to.run the setup for a new integration and it should update the credentials of your already setup integration

Hi everyone!
I am very new to the world of UniFi and just getting started with the first components.
Getting my Network added in Home Assistant was easy, but the Update rate for sensors (current traffic) seems extremely slow.

I currently only have the UniFi Express (Cloud Gateway Ultra is on the way) and if I look at the tiny Display, it shows current traffic in real time. Home Assistant Integration seems to show it a minute (or several minutes) later making real time monitoring difficult. Is there any way to increase the refresh?

Strange… starting today, the UniFi integration keeps running into “too many authentication attempts” issues and then stops working for a while. I didn’t change anything,. apart from adding an Access Point to my Network.

This is the error:

Logger: homeassistant.components.unifi
Quelle: components/unifi/hub/api.py:76
Integration: UniFi Network (Dokumentation, Probleme)
Erstmals aufgetreten: 12:44:23 (62 Vorkommnisse)
Zuletzt protokolliert: 17:57:42

Error connecting to the UniFi Network at 192.168.0.2: Call https://192.168.0.2:443/api/auth/login received 429: b’{“code”:“AUTHENTICATION_FAILED_LIMIT_REACHED”,“message”:“You've reached the login attempt limit”,“level”:“debug”}’

I can answer my first question myself now…after Updating my Gateway from the Express to the Ultra I now get far quicker Data response. Seems the UniFi Cloud Gateway Express was just too slow.

Do you still have the problems with AUTHENTICATION_FAILED_LIMIT_REACHED
???

I have a lot of errors too.
I have the ultra since 1 day

Yes its due to the new python 3.13 not carrying an expected fix

PR is merged and targets 2024.12.2

1 Like

solved the problem with authentication with the 2024.12.2

1 Like

Thanks for the feedback