Ubiquiti Networks UniFi Controller

The UniFi Controller is a wireless network management software solution for managing multiple wireless networks using a web browser.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Devices
  
  

Parameters

1. UniFi Controller Domain (required) - The hostname of the UniFi Controller server.
2. User Name and Password (required) - Specify the user name and password for a read-only user. A user with 'Read Only' role provides permission to access the data necessary to a given API resource. For more details, see the below section.
3. Site (optional, default: default) - Specify the site name to fetch devices from.
   • If supplied, Axonius will fetch data from the specified site name.
   • If not supplied, Axonius will fetch data from site name 'default'.
4. Version - Choose the Ubiquiti version, either v1 or v2. The default value is v1.
5. Verify SSL (required, default: False) - Verify the SSL certificate offered by the host supplied in UniFi Controller Domain. For more details, see SSL Trust & CA Settings.
   • If enabled, the SSL certificate offered by the host will be verified against the CA database inside of Axonius. If it fails validation, the connection will fail with an error.
   • If disabled, the SSL certificate offered by the host will not be verified against the CA database inside of Axonius.
6. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to UniFi Controller Domain.
   • If supplied, Axonius will utilize the proxy when connecting to the host defined for this connection.
   • If not supplied, Axonius will connect directly to the host defined for this connection.
7. To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.
   
   

Advanced Settings

1. UniFi SSID include list (optional, default: empty) - Specify a comma-separated list of UniFi SSID.
   • If supplied, all connections for this adapter will only fetch devices whose SSID is any of the comma-separated list of UniFi SSID that have been defined in this field.
   • If not supplied, all connections for this adapter will fetch devices that are associated with any SSID.

Configuring a Read-Only User in UniFi Controller Dashboard

To configure a read-only user for Axonius:

1. Open the Unifi Controller dashboard.
2. Go to Settings -> Admins -> click Add New Admin.

3. For Invite to Controller, select Manually set and store the password.
4. Define a name and a password.
5. Select Read Only role.
6. Provide the user with the following Global Permissions:
   • Allow system stats access
   • Allow read only access to all sites
7. Click Create.