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

> Add a Cisco Meraki controller to Wiacom — legacy and API modes

Choose the integration mode that suits your deployment.

<Tabs>
  <Tab title="API Mode (Recommended)">
    API mode connects Wiacom to your Meraki Dashboard. Wiacom discovers your networks and SSIDs, assigns feature roles, and pushes all SSID configuration automatically.

    ## Prerequisites

    * Meraki organisation with at least one wireless network and MR access points
    * Dashboard API access enabled at **Organization → Settings → Dashboard API access**
    * Meraki API key with **Read + Write** permissions at organisation level
    * RADIUS Accounting enabled on the organisation (contact Cisco Meraki support if unavailable)

    <Tip>
      In the Meraki Dashboard: account email (top-right) → **My Profile** → **API access** → **Generate new API key**. Copy it immediately — shown only once.
    </Tip>

    ## Step 1 — Prepare SSIDs in Meraki Dashboard

    Create one SSID per access feature you want to use. All three can run on the same network using separate SSIDs.

    | Feature        | Security setting              | Splash page              |
    | -------------- | ----------------------------- | ------------------------ |
    | **Portal**     | Open or Open (Enhanced / OWE) | Any custom splash option |
    | **WiFi Pass**  | Identity PSK without RADIUS   | None (direct access)     |
    | **Key Access** | WPA2 Personal                 | None (direct access)     |

    <Note>
      SSIDs named *Unconfigured* are excluded from detection — rename any SSID you want Wiacom to manage before connecting.
    </Note>

    **Client IP and VLAN** should be set according to your network requirements.

    For **WiFi Pass**, ensure at least one **Group Policy** exists in the network (**Network → Group Policies**) — Meraki requires this for iPSK creation.

    <Warning>
      Portal and WiFi Pass cannot share the same SSID. Use separate SSIDs if you need both.
    </Warning>

    <a id="api-add-controller" />

    ## Step 2 — Add the Controller in Wiacom

    From the Admin dashboard:

    1. Go to **Inventory → Controllers → Add controller → Cisco Meraki**
    2. Enter a label (e.g. *Meraki – Main Controller*)
    3. Paste your Meraki API key and click **Next**

    <Info>
      Loading may take longer for organisations with many networks, SSIDs, and APs. Meraki enforces a 5 req/sec API rate limit.
    </Info>

    ## Step 3 — Select Organisation

    Choose the Meraki organisation to link and click **Next**. Wiacom fetches all wireless-capable networks and eligible SSIDs. SSIDs named *Unconfigured* are excluded automatically.

    ## Step 4 — Assign SSID Roles

    Map each SSID to a Wiacom feature role. One SSID maps to one role. One network maps to one location.

    | Role           | Effect                                                   |
    | -------------- | -------------------------------------------------------- |
    | **Portal**     | Wiacom pushes splash URL and RADIUS settings to the SSID |
    | **WiFi Pass**  | Wiacom provisions iPSKs on this SSID via the Meraki API  |
    | **Key Access** | Wiacom stores and pushes the shared passphrase           |

    ## Step 5 — Map Networks to Locations

    Assign each Meraki network to a Wiacom venue location. Click **Finish**.

    Wiacom saves the configuration, pushes SSID settings to Meraki, and imports the AP inventory.

    ## After Setup

    | Action                       | Where                                                          |
    | ---------------------------- | -------------------------------------------------------------- |
    | Sync latest topology         | **Inventory → Controllers → Sync from controller**             |
    | Enable / disable SSIDs       | Toggle in the SSID table                                       |
    | Update Key Access passphrase | Edit icon on the Key Access SSID row                           |
    | Set bandwidth limits         | **BW** icon on any SSID row                                    |
    | Configure WiFi Pass expiry   | Clock icon on the WiFi Pass SSID row                           |
    | Rotate API key               | **Inventory → Controllers → \[controller] → Edit credentials** |

    For full details on managing controllers, see [Controllers](/admin-reference/controllers).

    ## Troubleshooting

    <AccordionGroup>
      <Accordion title="No organisations found after entering the API key">
        Confirm Dashboard API access is enabled under **Organization → Settings** and the key was copied without trailing spaces.
      </Accordion>

      <Accordion title="No SSIDs appear in Step 4">
        Ensure at least one SSID is enabled and named in Meraki. SSIDs named *Unconfigured* are hidden automatically.
      </Accordion>

      <Accordion title="WiFi Pass provisioning fails">
        Confirm the SSID is set to *Identity PSK without RADIUS* and at least one Group Policy exists in **Network → Group Policies**.
      </Accordion>

      <Accordion title="Portal redirect not working">
        Ensure RADIUS Accounting is enabled. Contact Cisco Meraki support if the option is unavailable in your Dashboard.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Manual Mode">
    Legacy mode does not require API access. SSIDs are configured directly in the Meraki Dashboard; devices are registered in Wiacom manually. Portal, iPSK with RADIUS, and Key Access are supported. iPSK without RADIUS is not available in legacy mode.

    ## Step 1 — Configure the SSID in Meraki

    Configure the SSID in the Meraki Dashboard according to the feature you are deploying. Full field-by-field instructions are on each feature page:

    <CardGroup cols={3}>
      <Card title="Portal" icon="wifi" href="/wifi-vendors/cisco-meraki/portal#manual-configuration-legacy--non-api-mode">
        Open SSID with RADIUS splash — Access Control, RADIUS servers, Splash Page settings
      </Card>

      <Card title="WiFi Pass (iPSK with RADIUS)" icon="key" href="/wifi-vendors/cisco-meraki/wifi-pass#manual-configuration-legacy--non-api-mode">
        Identity PSK with RADIUS — Access Control and RADIUS server settings
      </Card>

      <Card title="Key Access" icon="lock" href="/wifi-vendors/cisco-meraki/key-access#manual-configuration-legacy--non-api-mode">
        WPA2 Personal — apply the passphrase set in Wiacom to the SSID
      </Card>
    </CardGroup>

    ## Step 2 — Register the Device in Wiacom

    Once the SSID is configured in Meraki, add the access point or router to Wiacom:

    From the Admin dashboard:

    1. Go to **Inventory → Routers → Add New Router**
    2. Select **Cisco Meraki** as the vendor
    3. Enter the required network identifier details
    4. Assign a location and click **Save**

    <Info>
      For deployments with multiple devices, Wiacom supports bulk import via CSV. See [Inventory Management](/admin-reference/inventory) for import instructions and field requirements.
    </Info>

    For full details on managing inventory, see [Inventory](/admin-reference/inventory).
  </Tab>
</Tabs>