Overview

Ubiquiti does not allow systems like Fydelia to authenticate devices via API using UI.com. Fydelia must be able to contact the controller directly requiring a “local user” to be created. Technically it’s not local, of course, but there is logic there. A system-to-system integration like Fydelia to a UniFi controller cannot manage multi-factor authentication which was mandated from July 2024, hence why using ui.com is not permitted.

You can create a local user in your controller using your standard ui.com access. Remember Fydelia will later need to reach the controller directly using this account.

For self-hosted users

Access the UniFi Controller on your self-hosted or software-based platform through the updated interface and proceed with the instructions provided.

Generate a local administrator account:

• Head to the Settings tab.
• In Version 7.5 and above, choose the System option and then navigate to the Administration tab.
• Note that Version 8+ as an Admins option in the left menu:

• Add a new (or edit existing) admin account , and ensure that the Remote Access checkbox is deactivated.

• After checking the Set Admin Password checkbox, provide your email address, username, and choose a password.
• It is important to remember the username and password.

To grant the new account with the appropriate Site Permissions, it must have equivalent access as your existing UniFi cloud account. Usually, choosing the Site Administrator role will be necessary. Systems such as Fydelia require basic admin and not read-only in order to be able to authenticate devices.

• Press Invite to create and store the new Admin account.

Upon logging into the UniFi Controller with the updated credentials, a prompt will appear to change the password. It is important to make note of the new password. Do this once before Fydelia is required for guest WiFi and make sure your Fydelia splash page password matches.

For systems running UniFi OS

A local admin account is created for consoles using UniFi OS in the following manner.

• Access the UniFi OS homepage on the device.

Navigate to Admins and click on the Add Admin option represented by the + icon.

• Go to Admins:

• Add an admin and restrict to local access:

If you have used a different UniFi user in your Fydelia splash pages, be sure to update them with these new credentials