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

1 Like

@stroo333 Just wanted to say thank you for your guidance!

I’m not there yet, but thanks to you, I’m closer than ever before.

Hi,

Pairing the Unifi Protect G4 Doorbell Pro automation to unlock my Yale doorlock.
In the Home Assistant log, I can see the following output:

Why is the “full_name” not being populated?
I tried promoting the local user role from “Live Only” to “Full Management” but it still did not pick up this information.

event_types:
  - identified
  - not_identified
event_type: identified
event_id: 67a1a18e007f0803e4003dee
full_name: ""
attribution: Powered by UniFi Protect Server
icon: mdi:fingerprint
friendly_name: G4 Doorbell Pro Fingerprint

This thread focuses on UniFi networking, there are other threads to ask UniFi protect questions.

alright thanks will repost at the correct thread

I got to this thread looking for a way to automate Unifi WiFi password changes. And, indeed, I did find the “regenerate_password” button - which seems great for my purposes!

However, I cannot find a way to actually get the new password. The QR is OK, but I need to know what password was actually set on the network (to use in other automations, and to generate my own QR code on HAss-external devices). How can one see the password that was set on the network?

Just go to the Wifi SSID in your Unifi Network and click the “eye” next to the password on the Wifi SSID you have changed …