> ## 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

> Configure Cambium cnPilot Enterprise AP for Wiacom Portal

<Warning>
  Firmware 3.1 or above required. RADIUS details and portal URL are region-specific — obtain from Wiacom before starting.
</Warning>

## Step 1 — Add the Device to Wiacom

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

## Step 2 — Create the WLAN

Log in to the AP web interface. Go to **Configure → WLAN → Create Wireless LAN** (top right).

**Basic tab:**

| Field            | Value                    |
| ---------------- | ------------------------ |
| Enable           | Enabled                  |
| SSID             | Your guest WiFi name     |
| VLAN             | Your guest VLAN (or `1`) |
| Security         | `open`                   |
| Radios           | 2.4 GHz and 5 GHz        |
| Max Clients      | 200                      |
| Client Isolation | Enabled                  |

Click **Save**.

## Step 3 — Configure RADIUS

**Radius Server tab:**

| Field                          | Value                    |
| ------------------------------ | ------------------------ |
| Authentication Server 1 Host   | `<RADIUS_SERVER_1>`      |
| Authentication Server 1 Port   | `1812`                   |
| Authentication Server 1 Secret | `<RADIUS_SHARED_SECRET>` |
| Authentication Server 2 Host   | `<RADIUS_SERVER_2>`      |
| Authentication Server 2 Port   | `1812`                   |
| Authentication Server 2 Secret | `<RADIUS_SHARED_SECRET>` |
| Accounting Server 1 Host       | `<RADIUS_SERVER_1>`      |
| Accounting Server 1 Port       | `1813`                   |
| Accounting Server 2 Host       | `<RADIUS_SERVER_2>`      |
| Accounting Server 2 Port       | `1813`                   |
| Accounting Mode                | `start-interim-stop`     |
| Server Pool Mode               | Failover                 |
| Interim Update Interval        | `120`                    |

Click **Save**.

## Step 4 — Configure Guest Access (Portal)

**Guest Access tab:**

| Field              | Value                               |
| ------------------ | ----------------------------------- |
| Enable             | Enabled                             |
| Portal Mode        | External Hotspot                    |
| Access Policy      | RADIUS                              |
| Redirect Mode      | HTTP                                |
| External Page URL  | `<PORTAL_URL>` — provided by Wiacom |
| Success Action     | Redirect user to External URL       |
| Redirect URL       | `<PORTAL_URL>?res=success`          |
| Session Timeout    | `86400`                             |
| Inactivity Timeout | `1800`                              |

Click **Save**.

## Step 5 — Configure Walled Garden

Under **Add White List**, add each domain one at a time:

```
*.wiacom.ai
*.akamaitechnologies.com
*.akamaiedge.net
*.akamaized.net
*.akamai.net
*.amazonaws.com
*.fastly.net
*.zencdn.net
fast.wistia.com
player.vimeo.com
*.facebook.com
*.fbcdn.net
*.akamaihd.net
connect.facebook.net
*.instagram.com
*.twitter.com
*.twimg.com
*.linkedin.com
*.licdn.net
*.licdn.com
```

Add any additional domains used in your portal customization.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Guests not redirected to portal">
    Confirm Portal Mode is set to External Hotspot and Redirect Mode is HTTP. Check that Client Isolation is enabled.
  </Accordion>

  <Accordion title="RADIUS authentication fails">
    Verify server addresses and shared secret. UDP 1812 and 1813 must be reachable.
  </Accordion>
</AccordionGroup>
