> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiacom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> Connect UniFi to Wiacom — API and legacy modes

<Tabs>
  <Tab title="API Mode">
    ## Prerequisites

    * UniFi controller accessible from the internet (or Wiacom source IPs allowed through your firewall — contact Wiacom for the IP list)
    * Open SSID(s) configured under Sites with Access Points assigned
    * UniFi controller URL, admin username, and password
    * Same controller not previously provisioned on the Wiacom platform

    <Warning>
      One Site profile from the UniFi controller can be assigned to only one Wiacom location. Long loading times may occur on controllers with many Sites and APs.
    </Warning>

    ## UniFi Dashboard Preparation

    For each SSID you want to use with Portal:

    1. Select the desired **Site**
    2. Set the SSID **Security** to **Open**
    3. Enable **Guest Policy** on the SSID
    4. The SSID can remain disabled initially

    ## Add the Controller in Wiacom

    1. Go to **Inventory → Controllers → Add new Controller**
    2. Choose **UniFi controller**
    3. Fill in the controller URL, username, and password
    4. Click **Next**

    ## Map Sites to Locations

    1. Select the Sites (SSIDs) to integrate with Wiacom
    2. You may choose **No location mapping** to leave a Site unassigned
    3. Map each selected Site to a Wiacom venue location
    4. Click **Finish**

    Wiacom will discover APs and SSIDs and configure the splash redirect automatically.
  </Tab>

  <Tab title="Legacy / Manual Mode">
    <Warning>
      RADIUS server details and portal URL are region-specific. Obtain the correct values from Wiacom before starting.
    </Warning>

    ## Step 1 — Add the Device to Wiacom

    1. Go to **Inventory → Routers → Add New Router**
    2. Select **UniFi** from the vendor dropdown
    3. Enter required details and assign a location
    4. Click **Save**

    ## Step 2 — Configure the SSID in UniFi

    Log in to your UniFi controller. Select the desired Site.

    Create or edit the guest SSID:

    * Security: **Open**
    * Enable Guest Policy: **Yes**

    Under the Guest Control settings for the SSID:

    * Enable **Guest Portal**
    * Portal type: **External Portal Server**
    * Custom Portal URL: `<PORTAL_URL>` — provided by Wiacom

    ## Step 3 — Configure RADIUS

    Under **Settings → Profiles → RADIUS**:

    * Create an auth profile with your Wiacom RADIUS server IP and shared secret (port `1812`)
    * Create an accounting profile (port `1813`)

    Assign the RADIUS profiles to the SSID.

    ## Step 4 — Configure Pre-Authorization Access (Walled Garden)

    Under **Guest Control → Pre-Authorization Access**, add:

    ```
    *.wiacom.ai
    *.akamaitechnologies.com
    *.akamaiedge.net
    *.akamaized.net
    *.akamai.net
    *.amazonaws.com
    *.fastly.net
    *.facebook.com
    *.fbcdn.net
    *.akamaihd.net
    connect.facebook.net
    *.instagram.com
    *.twitter.com
    *.twimg.com
    *.linkedin.com
    *.licdn.net
    *.licdn.com
    *.google.com
    *.googleapis.com
    *.gstatic.com
    ```
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Controller not reachable during API setup">
    Ensure the controller URL includes the port (e.g. `https://your-controller:8443`). If behind a firewall, allow Wiacom source IPs — contact the Wiacom team for the current IP list.
  </Accordion>

  <Accordion title="Guests not redirected to portal">
    Confirm Guest Policy is enabled on the SSID and the SSID is set to Open. HTTPS pages will not trigger the redirect — use an HTTP URL for testing.
  </Accordion>
</AccordionGroup>