Overview
Use this knowledge article as the single firewall reference for Cisco Spaces OS and outcome services. It identifies and validates the firewall rules required between customer-managed clients, Cisco Spaces infrastructure, wireless infrastructure, and outcome-specific services.
Apply only the rule groups for the components and outcomes in your deployment. Cisco Spaces cloud addresses can change, so use FQDN-based destination objects when your firewall supports them. If your security policy requires static IP objects, compare the addresses in this article with the current Cisco documentation and the values displayed in your Cisco Spaces tenant before implementing a change.
Prerequisites
Before you begin:
-
Identify your Cisco Spaces tenant region:
-
IO:
dnaspaces.ioandciscospaces.io -
EU:
dnaspaces.euandciscospaces.eu -
SG:
ciscospaces.sg
-
-
Inventory the components in scope:
-
Cisco Spaces Connector
-
Cisco AireOS or Catalyst 9800 wireless controllers
-
Catalyst access points with IoT Services
-
Catalyst Center
-
Meraki Dashboard integration
-
Kiosk or Space Explorer clients
-
Captive Portal
-
OpenRoaming
-
Smart Rooms gateway and building management system
-
Sensor Connect Wireless IoT Orchestrator and registered external applications
-
-
Confirm that DNS, NTP, proxy, and TLS inspection policies are available for the relevant source networks.
-
Record the Cisco Spaces tenant, region, source subnets, and firewall change identifier.
-
For Captive Portal, open Cisco Spaces > Captive Portal > SSIDs, select the SSID, and use Configure Manually or View Config Guide to obtain the tenant-specific splash URL, RADIUS server addresses, and shared secret.
Do not copy RADIUS server addresses or secrets from another tenant. Use the values generated for the SSID in your own Cisco Spaces tenant.
How to read the traffic matrix
Each rule separates the source and destination ports. Unless a row explicitly states otherwise, Source port is Any (ephemeral): the initiating client selects a temporary source port, while the firewall rule matches the listed service Destination port. Stateful firewalls should permit the associated return traffic. Do not configure the destination service port as a fixed source port.
Select the required rule groups
|
Deployment component or outcome |
Required rule groups |
|---|---|
|
Spaces Connector with AireOS or Catalyst 9800 |
A, B |
|
IoT Services on Catalyst wireless |
A, B, C |
|
Meraki wireless integration, including Scanning API and MQTT |
E |
|
Catalyst Center integration |
D |
|
Meraki Dashboard API synchronization only |
E1 |
|
Smart Workspaces kiosk or signage |
F |
|
Space Explorer browser or PWA |
G |
|
Captive Portal |
H |
|
OpenRoaming with Connector |
A, B, I |
|
OpenRoaming with Meraki |
I |
|
Smart Rooms gateway |
J |
|
Sensor Connect for IoT Services |
K |
|
Asset Tracking, Occupancy, or Indoor Navigation |
A, B, and C when IoT Services is used |
Validate the deployment
Complete the checks for every applied rule group:
-
From the actual source segment, confirm that each required FQDN resolves.
-
Confirm that the permitted TCP or UDP session reaches the intended destination without an unexpected proxy, TLS inspection, or NAT policy failure.
-
Review firewall logs for denied sessions from the Connector, controller, access points, Meraki cloud or wireless networks, client devices, Catalyst Center, Smart Rooms gateway, Wireless IoT Orchestrator, or registered external applications. Confirm that the session uses an ephemeral source port and the destination port listed in the applicable rule.
-
Confirm the corresponding platform status:
-
Connector control and data channels are healthy.
-
Controllers are active.
-
IoT Services deployment is successful.
-
Catalyst Center integration is activated.
-
Meraki Dashboard synchronization completes, the Scanning API receiver validates and receives observations, and wireless MQTT sessions establish over TLS 8883.
-
Kiosk, signage, or Space Explorer loads all content.
-
Captive Portal redirect and optional RADIUS authentication succeed.
-
OpenRoaming authentication succeeds.
-
Smart Rooms cloud and BACnet connections are healthy.
-
Sensor Connect shows the IoT Orchestrator running, the expected access points connected, and the required external application interface reachable.
-
-
Record the test result and the date on which the FQDN and IP list was verified.
Troubleshooting
FQDN resolves but the application remains offline
-
Confirm the rule permits the resolved IPv4 or IPv6 address actually selected by the client.
-
Check whether the firewall supports dynamic FQDN objects and refreshes DNS answers.
-
Review proxy authentication and TLS inspection policies. WebSocket services must remain usable for kiosk and Space Explorer live data.
Connector cloud channels are down
-
Confirm outbound TCP 443 to the correct regional Connector FQDN.
-
For IO static policies, confirm that both current and existing migration addresses are present.
-
Check DNS, NTP, default route, proxy, and firewall logs from the Connector subnet.
Controller or IoT Services remains inactive
-
Confirm that rules B and C are applied between the correct Connector, controller, and access point addresses.
-
Confirm that TCP 830 is used only for Catalyst controllers.
-
Confirm that optional UDP 2003 is required before enabling FastLocate.
-
In Cisco Spaces, review the detailed IoT Services deployment status and retry only after the denied path is corrected.
Captive Portal does not redirect or authenticate
-
Reopen Configure Manually or View Config Guide and compare the deployed splash FQDN, IPs, RADIUS server addresses, ports, and shared secret with the tenant-generated values.
-
Confirm DNS and DHCP are available to unauthenticated clients.
-
Confirm the pre-authentication or walled-garden policy permits the splash destination and the identity providers configured for the portal.
-
Do not add UDP 1813 unless accounting is required by the selected workflow.
Meraki integration is incomplete
-
Confirm the regional Cisco Spaces source addresses are in the Dashboard API allowlist.
-
Confirm the restriction applies to API access without unintentionally excluding administrators or other authorized integrations.
-
For Scanning API, confirm that Meraki cloud can reach the tenant-generated Cisco Spaces Post URL over TCP/TLS destination port 443 and that the configured secret matches.
-
For wireless MQTT, confirm that every participating Meraki network can reach the account- and region-specific broker over TCP/TLS destination port 8883.
-
Confirm the firewall is not incorrectly requiring 443 or 8883 as a fixed source port; the initiating client uses an ephemeral source port.
Sensor Connect access points or applications cannot connect
-
Confirm that the IoT Orchestrator application is in the Running state before testing connectivity.
-
If the access points cannot route directly to the IoT Orchestrator application IP, confirm that the controller has the correct Sensor Connect NAT IP and that rules target that address.
-
For access point connectivity, confirm TCP 50221 and TCP 43626 from the access point source ranges.
-
For registered external applications, confirm TCP 8081 for REST and TCP 41883 for MQTT as applicable.
-
In Inventory > Access Points, compare the expected controller access points with the access points reported as connected.
-
If the REST connection reaches TCP 8081 but authentication fails, verify the registered application's API key or certificate and the configured server/client certificate trust model.