Ubiquiti Networks UniFi Controller
  • 14 Jun 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Ubiquiti Networks UniFi Controller

  • Dark
    Light
  • PDF

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.

UniFi.png

Advanced Settings

Note:

From version 4.6 Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters

  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.
NOTE

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.

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.

image.png

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

First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.