> ## 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 Ruckus for Wiacom Portal — all variants

<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 **Ruckus** from the vendor dropdown
3. Enter the required details and assign a location
4. Click **Save**

<Tabs>
  <Tab title="SmartZone (v3.0+)">
    Log in to your SmartZone web interface.

    ## AAA Servers

    **Services & Profiles → Authentication** → Proxy (SZ Authenticator) tab → **Create**:

    | Field                   | Value                    |
    | ----------------------- | ------------------------ |
    | Name                    | `Guest WiFi`             |
    | Service Protocol        | RADIUS                   |
    | Primary Server IP       | `<RADIUS_SERVER_1>`      |
    | Port                    | `1812`                   |
    | Shared Secret           | `<RADIUS_SHARED_SECRET>` |
    | Secondary Server IP     | `<RADIUS_SERVER_2>`      |
    | Secondary Port          | `1812`                   |
    | Secondary Shared Secret | `<RADIUS_SHARED_SECRET>` |

    **Accounting** → Proxy tab → **Create**:

    | Field               | Value                    |
    | ------------------- | ------------------------ |
    | Name                | `Guest WiFi Acct`        |
    | Primary Server IP   | `<RADIUS_SERVER_1>`      |
    | Port                | `1813`                   |
    | Shared Secret       | `<RADIUS_SHARED_SECRET>` |
    | Secondary Server IP | `<RADIUS_SERVER_2>`      |
    | Secondary Port      | `1813`                   |

    ## Hotspot (WISPr)

    **Hotspots & Portals** → Hotspot (WISPr) tab → **Create**:

    | Field                             | Value                                   |
    | --------------------------------- | --------------------------------------- |
    | Portal Name                       | `Guest Wi-Fi`                           |
    | Smart Client Support              | None                                    |
    | Login URL                         | External                                |
    | Redirect unauthenticated users to | `<PORTAL_URL>`                          |
    | Redirected MAC Format             | `AA-BB-CC-DD-EE-FF`                     |
    | HTTPS Redirect                    | ON                                      |
    | Start Page                        | Redirect to: `<PORTAL_URL>?res=success` |

    ## Walled Garden

    Add the following domains one by one:

    ```
    *.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
    ```

    ## Wireless LAN

    **Wireless LANs** → **Create**:

    * Name / SSID: your guest WiFi name
    * Zone / WLAN Group: select as appropriate
    * Authentication Type: **Hotspot (WISPr)**
    * Method: **Open**
    * Encryption Method: **None**
    * Hotspot Portal: select `Guest Wi-Fi`
    * Authentication Service: `Guest WiFi`
    * Accounting Service: `Guest WiFi Acct`
    * NAS ID: **AP MAC**
    * Called STA ID: **AP MAC**
  </Tab>

  <Tab title="ZoneDirector (v9.8+)">
    Log in to your Ruckus ZoneDirector web interface.

    ## AAA Servers

    **Configure → AAA Servers** → **Create New**:

    Auth server:

    * Name: `Guest WiFi`, Type: RADIUS, Auth Method: PAP
    * Primary IP: `<RADIUS_SERVER_1>`, Port: `1812`, Secret: `<RADIUS_SHARED_SECRET>`
    * Secondary IP: `<RADIUS_SERVER_2>`, Port: `1812`

    Accounting server:

    * Name: `Guest WiFi Acct`, Type: RADIUS Accounting
    * Primary IP: `<RADIUS_SERVER_1>`, Port: `1813`
    * Secondary IP: `<RADIUS_SERVER_2>`, Port: `1813`

    ## Hotspot (WISPr)

    **Configure → Hotspot WISPr** → **Create New**:

    | Field                 | Value                                   |
    | --------------------- | --------------------------------------- |
    | Login URL             | External: `<PORTAL_URL>`                |
    | Start Page            | Redirect to: `<PORTAL_URL>?res=success` |
    | Redirected MAC Format | `AA-BB-CC-DD-EE-FF`                     |

    Add walled garden domains from the list above.

    ## WLAN

    **Configure → WLANs** → **Create New**:

    * Name / SSID: your guest WiFi name
    * Type: **Hotspot (WISPr)**
    * Authentication Server: `Guest WiFi`
    * Accounting Server: `Guest WiFi Acct`
    * Hotspot Profile: select the profile you created
  </Tab>

  <Tab title="ZoneDirector (v9.7 and below)">
    Log in to your ZoneDirector web interface.

    ## AAA Servers

    **Configure → AAA Servers** → **Create New**:

    * Name: `Guest WiFi`, Type: RADIUS, Auth Method: PAP
    * Primary IP: `<RADIUS_SERVER_1>`, Port: `1812`, Secret: `<RADIUS_SHARED_SECRET>`
    * Secondary IP: `<RADIUS_SERVER_2>`

    Repeat for accounting (port `1813`).

    ## Hotspot (WISPr)

    **Configure → Hotspot WISPr** → **Create New**:

    * Login URL: `<PORTAL_URL>`
    * Start Page: Redirect to `<PORTAL_URL>?res=success`
    * Redirected MAC Format: `AA-BB-CC-DD-EE-FF`

    Add walled garden domains from the list above.

    ## WLAN

    Create a WLAN, set Type to **Hotspot (WISPr)**, open authentication, assign the Hotspot profile, auth, and accounting servers.
  </Tab>

  <Tab title="Ruckus Cloud AP">
    Log in to [cloud.ruckuswireless.com](https://cloud.ruckuswireless.com).

    ## Create a Network

    **Networks → Add Network**:

    * Network Name: your guest WiFi name
    * Type: **Captive Portal**

    Click **Next**:

    * Captive Portal Type: **3rd Party Captive Portal (WISPr)**

    Click **Next**:

    * Portal URL: `<PORTAL_URL>` — provided by Wiacom
    * Note the **Integration Key** — enter it in the Wiacom admin under the venue settings

    ## Walled Garden

    Add domains from the list above.

    Click **Next**, select which Venue to apply to, enable it, and complete.

    <Info>
      Ensure you copy the Integration Key to the Wiacom admin under Venue → Settings to enable the connection.
    </Info>
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Guests not redirected to portal">
    Confirm the WLAN is set to Hotspot (WISPr) type and Authentication is Open. The NAS ID should be None for SmartZone general procedure.
  </Accordion>

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