Skip to main content
Skip table of contents

Space Explorer Web App

OVERVIEW

The Space Explorer Web App allows flexible access with SSO login (via Webex, Microsoft, and Google Login - more details below) to authenticate end users. The Web App is complementary to the Space Explorer Kiosk app meant to be displayed on a lobby display. In addition to room occupancy and calendar status, the Space Explorer Web App adds Smart Desking functionality to Cisco Spaces workplace experience applications. It is a flexible workspace solution that allows employees to reserve dynamically allocated desks (“Hot Desks”) instead of having assigned seating. It is a key part of hybrid work models and is commonly managed through IoT, AI, and cloud-based platforms.

Space Explorer - Web App - ciscospaces.app

Space Explorer - Web App - ciscospaces.app


SUPPORT AND ONBOARDING

Please follow the link below to find out about the different ways to get support for Cisco Spaces.

Support Info Link


PREREQUISITES

This runbook should only be used as a follow on from the Spaces OS Runbook. Please refer to that document before progressing here.

Prerequisites

Single Sign On (SSO) Support

  • Webex Login (Webex SSO) enables seamless authentication for employees.

  • Google Login (Google Workspace SSO) enables seamless authentication for employees.

  • Microsoft Login (O363 SSO) enabled seamless authentication for employees. Optional: admin grants permission to the Cisco Spaces Space Explorer Web App to allow users to login without being prompted.

Spaces Infrastructure

  • An active Cisco Spaces Tenant in the .io data center region. ⚠️ ROADMAP ⚠️ .eu and .sg data center region support.

  • Sufficient licensing for mapped square footage is required

  • Spaces Premier license is needed for Rooms in the Space Explorer web app and/or cross-launching to Indoor Wayfinding (future)

  • Spaces Premier for Collaboration & Wireless (SPACES-C-PRM) license is needed for Desks in the Space Explorer web app

  • Provide accurate CAD .dwg (or Vector PDFs) files for each floor in the EFT location (Best Practices - including walls, furniture, room labels/IDs, and other recognizable points of interest)

  • Desk IDs must be included to create a “Workstation” space type.

  • At-least deploy one Cisco Spaces digital Kiosk application on a Cisco Webex Board Pro / Pro 2 in the building lobby or central location

Spaces Infrastructure Readiness

Licensing Requirements

Individual Workstations/Desk Spaces are NOT licensed, but:

  • Sufficient licensing for mapped square footage is required.

  • Meeting Room real-time status visibility needs at minimum Spaces ADVANTAGE (ACT or UNLIMITED) in the current production environment.

  • SPACES-C-PRM (Spaces Premier for Collaboration & Wireless) license is needed to access the Space Explorer Web App for desk & room booking when these features move to Limited Availability (LA) followed by General Availability (GA), including Webex Desk & Phone Series device integration.

Mapping & Desk Identification

Digital Map Pro (3D Rich Map) Setup:

  • Desk IDs must be included in a CAD file to create a Workstation space type.

  • CAD files are processed into Digital Maps Pro (must be Published under Setup > Locations & Maps > Digital Maps)

  • Workstation space types auto-added to Space Manager > Manages Desks (requires a Cisco Spaces PM enabling a feature flag).

  • Workstations must be added to bookable inventory from Space Manager > Manages Desks

Desk Management in Space Manager (requires feature flag by Cisco Spaces PM team)

Link: Space Manager Setup

Hot Desk Setup:

  • Admins can designate "hot desks" for booking.

  • Workstations marked as hot desks will be assigned a Cisco Spaces proprietary calendar:

    • Users can book for the whole day and cancel their booking

    • Only one booking per user

    • Desk bookings reset at midnight local time


Single Sign On (SSO) Readiness

End-User SSO Login (not via CCI)

Users log in using:

  • Webex Login

  • Microsoft 365 Login (admin consent required)

  • Google Login

Enables seamless authentication for employees using existing SSO login flow.

Desk Booking Process

Booking via Companion Web App

  • Users login via SSO (Microsoft 365 or Google)

  • They visually scan the digital map for available desks

  • They click on a desk/space

  • They click “Book This Desk” to book it instantly


Firewall / Proxy Readiness

For Space Explorer Web App and Cisco Spaces Navigator PWA for desk booking.

Ports: 443 for all domains / endpoints listed below

IO

✅ SUPPORTED ✅

EU

⚠️ ROADMAP ⚠️

SG

⚠️ ROADMAP ⚠️

Highly recommended to add these wildcards:

*.ciscospaces.io

*.dnaspaces.io

Highly recommended to add these wildcards:

*.ciscospaces.eu

*.dnaspaces.eu

Highly recommended to add this wildcard:

*.ciscospaces.sg

--

Required

http://ciscospaces.app

wss://sws-jetstreams.dnaspaces.io

https://workspaces-preprod.dnaspaces.io (temporary)

https://maps.ciscospaces.io

https://api.mapbox.com

https://events.mapbox.com

https://fonts.googleapis.com

http://ciscospaces.app

coming soon

coming soon

https://maps.ciscospaces.eu

https://api.mapbox.com

https://events.mapbox.com

https://fonts.googleapis.com

http://ciscospaces.app

coming soon

coming soon

https://maps.ciscospaces.sg

https://api.mapbox.com

https://events.mapbox.com

https://fonts.googleapis.com

Optional

non-blocking: *.pendo.com

non-blocking: *.pendo.com

non-blocking: *.pendo.com

IMPLEMENTATION

Implementation Quick Start

Minimum of Spaces Advantage (ACT, Unlimited) licensing required for basic map view and optionally real-time room occupancy.

  1. (Required) Setup Location Hierarchy, Merge Locations/Floors, and upload / process / publish CAD into Digital Map Pro (go to: Configuring the Location Hierarchy & Digital Map Creation & CAD File Upload)

  2. (Optional) In Space Manager, connect Webex Workspaces, IoT Devices, and/or Calendars

    1. If setting up Rooms, add room occupancy devices and calendars under Space Manager > Manage Rooms. (go to: Configuring Meeting Room Settings in Space Manager)

    2. If setting up Desks (requires Spaces Premier licenses), create bookable desks add Webex Workspaces under Space Manager > Manage Desks. (go to: Space Manager Setup - Adding Bookable Desks)

  3. (Required) Domain-to-Cisco Spaces Tenant mapping on backend (performed by Cisco team) (go to: Tenant-to-Domain Mapping)

    1. If using Webex Login, ensure Cisco Spaces <> Webex integration is not blocked in Control Hub. (go to: Webex Login - Admin Permissions)

    2. If using Microsoft Login, Microsoft Entra admin must login and grant permissions first. (go to: Microsoft 365 Login - Admin First Time)

Setup > Location & Maps > Digital Maps

  1. Open the Cisco Spaces dashboard

  2. Navigate to Setup > Locations & Maps > Digital Maps > View/Edit

  3. Check Meeting Rooms and make sure all room names/IDs are present and unique

  4. Check Workstations and make sure all desk names/IDs are present and unique

  5. If any bookable desks/private offices are not clickable and editable, then a new CAD file with desk IDs may be needed.

Setup - Locations and Maps - Digital Maps - View-Edit

Setup > Locations & Maps > Digital Maps > View/Edit


Space Experience Setup

  1. Open the Cisco Spaces dashboard

  2. Navigate to Space Experience app

  3. Go to Devices

  4. Go to Non-Webex Devices

  5. Click Add Signage (blue button in top left)

  6. Expand each row of the Location Hierarchy until you find the Location/Building you want to add to the Space Explorer web app

  7. Click the radio button on the right side of the Location/Building row - green arrow in the screenshot below (NOT the Floor or any other level - red arrow in the screenshot below)

Space Experience - My Signages - Non-Webex Devices - Add Signage

Space Experience > My Signages > Non-Webex Devices - Add Signage

  1. Click Next (blue button in bottom right)

  2. Expand “Can't see the activation code?

  3. Copy the URL and paste into an Incognito Browser Window

  4. Look for and memorize the 4-digit code that loads on the page

  5. Type the 4-digit code under Activation code

  6. Type a name under Name your signage

Tip: Give other admins context for what this Kiosk is for so they do not accidentally delete it. For example: Space Explorer Web App Building Token

  1. Click Save (blue button in bottom right)

  2. On the Space Experience > Devices > Non-Webex Devices list view, click Configure on the signage just created

  3. Go through the configuration steps as normal (this won’t be deployed on a Kiosk, it is only to create a token on the backend)

Note: While most settings are not important during the configuration workflow, temporarily the Space Explorer Web App will use this Kiosk’s specific pitch, bearing, zoom, and center point of the floor map as the default view on first load of each Location/Building. It is also good practice to start setting up a Location’s default map view under Setup > Locations & Maps > Digital Maps > “3 dots menu in the locations list” > Set default map view

Additionally, enabling the Wayfinding checkbox (or backend feature flag applied by Cisco Spaces product team) for this Kiosk is required to enable Wayfinding cross-launch from the Space Explorer Web App and the Cisco Spaces Wayfinding iOS App Clip and Android Google Play App (or the pathdrawing fallback web app).

Step 2: Widgets and Step 4: “Where am I?” have no impact on Space Explorer Web App features or functionality.


Space Manager Setup

Turning Workstations from Digital Maps into Bookable (“Hot”) Desks

Spaces PM team or Dev team needs to toggle a feature flag in Space Manager to reveal Space Manager > Manage Desks page while in EFT phase.

  1. Open the Cisco Spaces dashboard

  2. Navigate to Space Manager app

  3. Go to the Manage Desks (if you do not see this page, work with a Spaces PM to enable the feature flag)

  4. Choose a Location and Floor from the dropdowns at the top-center of the page

Space Manager - Manage Desks - No Hot Desks

Space Manager > Manage Desks - No Hot Desks

  1. Click on Add Hot Desks and the list of all Desks/Workstations from the Digital Maps Editor will appear along with the Map on the right-hand side.

Space Manager - Manage Desks - Add Hot Desks

Space Manager > Manage Desks - Add Hot Desks

  1. Select the Workstation ID check boxes you want to add as bookable desks, then click on the Add Hot Desks button in the bottom right. The desk space will be highlighted in a light blue box on the map panel.

Space Manager - Manage Desks - Select Desks

Space Manager > Manage Desks - Select Desks

Tip: type text in the “Search desks” field to filter desks in the list or to find neighborhoods of desks by name. Typical office space CAD files use an alphanumeric grid pattern to name Workstations.

Space Manager - Manage Desks - Add Hot Desks Tip

Space Manager > Manage Desks - Add Hot Desks Tip

  1. Once you have added Hot Desks, the List of all selected Hot Desks should appear under the Manage Desks view. In the map panel, Hot Desks are highlighted in a 3D magenta box.

Screenshot 2025-05-15 at 15.46.33.png

Space Manager > Manage Desks - Added Hot Desks

Desk Booking Options

When designing a desk booking experience for our end users, you have options that meet different user experiences, price points, effort levels, and maintenance/lifecycle management requirements. They range from a Cisco Spaces “map only” experience to a fully integrated Collab experience with a Desk Series device on a desk for power, external monitor, camera, and meeting platform experience.

Desk Booking Options Support Matrix

Option

Example

Hardware Price Range

Advantages

Considerations

Cisco Spaces Web App

(ciscospaces.app map-only experience)

image-20260317-203803.png

n/a

Quick and easy to setup and start desk booking. Option to expand and build on the core desk booking experience later. Supports desk booking up to 14 days in advance.

It can be confusing to end users which desks are booked and ciscospaces.app may not be discoverable. Effort required to build awareness around desk booking culture/policy. Does not sync with Outlook/Gcal calendar and does not work with Webex App user check-in.

⚠️ ROADMAP ⚠️

Printed QR codes on desks

Smart Desk QR Codes.png

$

Least expensive option to make desk booking discoverable on each desk and to distinguish bookable vs. non-bookable desks. QR code deep-links and launches a booking experience in ciscospaces.app directly to the assigned desk on the Digital Map (including SSO login flow). Supports desk booking up to 14 days in advance.

No real-time booking status indicator to give passersby an indication of other users intending to use the desk. Establish a consistent and concrete naming convention and stabilize Digital Map content before committing to a large number of printed QR codes. Otherwise, it will incur additional cost to re-print. Consider a flexible attachment mechanism to allow updating vs. permanently affixing the QR code to the desk. Does not sync with Outlook/Gcal calendar and does not work with Webex App user check-in.

⚠️ ROADMAP ⚠️

3rd Party IoT Sensor

(e.g. Haltian Thingse Presence PIR)

image-20260317-203956.png

$$

Provides real-time and historical “true occupancy” status for desk occupancy visibility on Kiosk or Web App and for analytics.

Without an accompanies desk booking, there are no “signs of life” indicators from these sensors. Prone to false positives and negatives as occupants walk by or get up and walk away from the desk to attend meetings, go to lunch, etc. but plan to return. Does not sync with Outlook/Gcal calendar and does not work with Webex App user check-in.

Cisco Desk 9800 Series & 8875

(does not include 9811 or 9821)

image-20260317-204053.png

$$

Provides real-time visual feedback via built-in LED bar (depends on model) or LCD screen content. Maintains checked-in (occupied) status even without physical presence to ensure others are aware of the booking and/or checked-in status, including user’s name and optionally profile photo (if configured in Webex User Profile). Supports Webex App user check-in.

Does not provide “true occupancy” for real-time visibility of physical presence or historical analysis. A phone can be used for “hot desk” only, but the presence of a handset phone may be confusing in some environments. Limited to “day of” / current day desk booking only. Currently, cannot be booked days in advance. Does not sync with Outlook/Gcal calendar.

Smart Desk Navigator

(Cisco Spaces desk PWA)

image-20260317-204043.png

$$$

Provides real-time visual feedback via on-screen content. Maintains checked-in (occupied) status even without physical presence to ensure others are aware of the booking and/or checked-in status, including user’s name and optionally profile photo (if configured in Microsoft, Google, or Webex User Profile). Supports desk booking up to 14 days in advance.

Does not sync with Outlook/Gcal calendar and does not work with Webex App user check-in.

⚠️ ROADMAP ⚠️

Cisco Navigator

(RoomOS)

image-20260317-204047.png

$$$

Provides real-time visual feedback via on-screen content. Maintains checked-in (occupied) status even without physical presence to ensure others are aware of the booking and/or checked-in status, including user’s name and optionally profile photo (if configured in Webex User Profile). Provides Outlook/Gcal calendar syncing via Webex Hybrid Calendar. Supports Webex App user check-in.

Limited to “day of” / current day desk booking only. Currently, cannot be booked days in advance due to on-device calendar sync limits (current day + 8 hours).

Cisco Desk Mini

image-20260317-204057.png

$$$

Provides real-time visual feedback via on-screen content. Maintains checked-in (occupied) status even without physical presence to ensure others are aware of the booking and/or checked-in status, including user’s name and optionally profile photo (if configured in Webex User Profile). Includes camera for meetings. Provides Outlook/Gcal calendar syncing via Webex Hybrid Calendar. Supports Webex App user check-in.

Limited to “day of” / current day desk booking only. Currently, cannot be booked days in advance due to on-device calendar sync limits (current day + 8 hours).

Cisco Desk

image-20260317-204102.png

$$$$

Provides real-time visual feedback via on-screen content. Maintains checked-in (occupied) status even without physical presence to ensure others are aware of the booking and/or checked-in status, including user’s name and optionally profile photo (if configured in Webex User Profile). Includes camera for meetings. Provides Outlook/Gcal calendar syncing via Webex Hybrid Calendar. Supports Webex App user check-in.

Limited to “day of” / current day desk booking only. Currently, cannot be booked days in advance due to on-device calendar sync limits (current day + 8 hours).

Cisco Desk Pro & G2

image-20260317-204106.png

$$$$

Provides real-time visual feedback via on-screen content. Maintains checked-in (occupied) status even without physical presence to ensure others are aware of the booking and/or checked-in status, including user’s name and optionally profile photo (if configured in Webex User Profile). Provides laptop charging power and external monitor via USB-C. Includes camera for meetings. Provides Outlook/Gcal calendar syncing via Webex Hybrid Calendar. Supports automatic check-in via USB-C with Webex App running on the connected laptop. Supports Webex App user check-in.

Limited to “day of” / current day desk booking only. Currently, cannot be booked days in advance due to on-device calendar sync limits (current day + 8 hours).

Assigning Webex Workspaces to Bookable (“Hot”) Desks

Adding a Webex Workspace to a bookable desk will associate the device to the Web App (ciscospaces.app) frontend so the logged in user adds their Webex User Profile to the device configured under Scheduling > Hot Desking mode in Control Hub Workspaces settings. The user’s email gets added as the “Organizer” when booking the desk (regardless of SSO method into ciscospaces.app - Webex, Microsoft, or Google Login) and the device displays the Webex User Profile name and photo.

  1. In Space Manager > Manage Desks page, choose the Building and Floor from the dropdowns at the top center of the page.

  2. Before setting up the first bookable desk, the page will prompt to add a “hot desk”. After setting up, there is a list view of desks and a map view for context.

  3. Under the Device column, there is an Add Webex v dropdown that will display Webex Workspaces that have been configured in Control Hub as the Desk space type. Only Desk spaces types are listed in the dropdown.

  4. Choose the Webex Workspace to associate the device with the bookable Workstation (i.e. desk) in ciscospaces.app

  5. The backend calendar will switch from Cisco Spaces backend proprietary calendar service to the on-device calendar or Webex Hybrid Calendar (events synced on-device and available via xAPI webhooks to Cisco Spaces backend).

Space Manager - Manage Desks - Add Webex

Space Manager > Manage Desks > Add Webex

Special Case: if upgrading the RoomOS Standalone Navigator to the Cisco Spaces Smart Desk Navigator desk PWA, a Webex Control Hub admin must follow these instructions to factory reset and onboard the Navigator as a Persistent Web App device.

  1. Onboard a Cisco Standalone Navigator. Learn more: https://help.webex.com/en-us/article/iq6aw6/Room-Navigator-as-a-standalone-device

  2. Under Step C of Persistent web app mode: Turn on Enable persistent web app and enter a URL. → Instead of entering a URL, choose the Cisco Spaces radio button option.

    1. This automated step is a ⚠️ ROADMAP ⚠️ feature. For now, choose URL and work with the Cisco Spaces PM team to generate the URL for each Navigator for this step.

Assigning 3rd Party IoT Sensors to Bookable (“Hot”) Desks

⚠️ ROADMAP ⚠️ feature. Not supported at this time.

Making Meeting Rooms from Digital Maps Bookable

⚠️ ROADMAP ⚠️ feature. Not supported at this time.

Pre-requisite: Verify that the Meeting Room has a Webex Workspace with compatible Cisco collaboration device connected (optional: Hybrid Calendar setup in Control Hub), which can be setup with a Microsoft Calendar (or Google Calendar) resource integrated.

Note: O365 & Gcal direct integration calendar rooms, calendar-only rooms, and Cisco Standalone Navigators are not currently supported for Meeting Room booking and real-time status. They may work intermittently and show the room as booked during the meeting event’s time window, but may not be visible on the map between events if no occupancy telemetry is available.

Room Booking Feature Description

Room booking in the Space Explorer Web App allows employees to book enabled meeting rooms using the familiar map interface. Alongside predefined desk booking time slots, the room booking interface provides more flexibility. The booking workflows and options available in Space Explorer Web App are intended for quickly finding an available room and booking it to block the calendar, map-based room search and booking, or to forward an upcoming calendar event to a meeting room so that someone can join a virtual meeting from a Cisco collaboration device. This interface is not intended for recurring meetings, multiple invitee schedule coordination, proxy or admin approved rooms, and other advanced use cases built into Outlook and other calendar clients.

Booking Options
  1. A user can choose a time window (15, 30, 60, or 90 minutes), which updates the two next available time slots for faster booking.

  2. A user can also click into “More time options” to see the full day’s calendar or to choose custom start and end times (in 5 minute increments)

Space Explorer Web App - Room Booking

Space Explorer Web App - Room Booking

Space Explorer Web App - Room Booking - More time options

Space Explorer Web App - Room Booking - More time options

Booking Workflows
  1. Clicking on a room on the floorplan map shows an individual room’s booking options.

  2. In the “My day” widget/tab, clicking Quick Book > Book a room presents several currently available rooms ready to book.

  3. In the “My day” widget/tab, clicking on a calendar event’s arrow icon (right facing arrow in a circle), then Find room to forward an existing calendar event to a meeting room device.

Space Explorer Web App - forward a My Day calendar event to a meeting room device

Space Explorer Web App - forward a My Day calendar event to a meeting room device

Steps to enable Room Booking
  1. Open the Cisco Spaces dashboard

  2. Navigate to Space Experience app

  3. Go to the Settings page

  4. Click on the Location & Room Overrides tab

  5. On the rows for Building(s) and Floor(s), click Edit to enable or disable these features (dependent on licensing): Status, Pathfinding, Wayfinding, Room Occupancy, Room Hold, Desk Booking.

    1. Optional: click the building name for toggles.

    2. Building and/or Floor overrides. Great for quickly enabling/disabling an entire feature without having to change individual room settings.

Option

Description

Status

Enable/disable an entire building or floor in Space Explorer Kiosk & Web App. For example, useful for disabling specific floors while under construction.

Pathfinding

Enable/disable pathfinding at a building or floor level. For example, useful for setting up paths and transitions without deploying to live kiosks until ready to release to end users.

Wayfinding

Enable/disable wayfinding at a building or floor level. For example, useful for setting up paths, transitions, and beacons without deploying to live kiosks until ready to release to end users.

Room Occupancy

Enable/disable room occupancy status at a building or floor level. For example, useful for quickly shutting down occupancy telemetry to limit Space Explorer Kiosk & Web App to map content only.

Room Hold

Enable/disable Hold button at a building or floor level. Room booking settings are only available in per room settings (see below).

Desk Booking

Enable/disable desk booking at a building or floor level. For example, useful for setting up desks while Space Explorer Kiosk & Web App are deployed until ready to release to end users.

Space Experience - Settings - Location and Room Overrides - Buildings and Floors (list)

Space Experience > Settings > Location & Room Overrides > Buildings and Floors (list)

Space Experience - Settings - Location and Room Overrides - Floor overrides (full page)

Space Experience > Settings > Location & Room Overrides > Floor overrides (full page)

  1. Expand a building and click on a Floor name

  2. Click on Room overrides tab

  3. On the rows for the Room(s), click Edit to configure the following features (dependent on licensing): Kiosk & Web App, Room status, Calendar, Book/Hold.

Option

Description

Kiosk & Web App

Enable/disable a single room in Space Explorer Kiosk & Web App.

Room Status

Enable/disable a single room’s real-time occupancy and booking telemetry. For example, useful for hiding a room’s occupancy on Space Explorer Kiosk & Web App while still collecting telemetry in Space Utilization app for historical occupancy analytics.

Calendar

Enable/disable a single room’s calendar on space Explorer Kiosk & Web App. For example, useful for hiding the calendar (and subsequently disabling the room booking option) on an ad hoc use meeting room, such as a call booth, focus room, or huddle room. This setting hides the calendar view in the room details popup.

Book/Hold

Choose among button options to show to end users on Space Explorer Kiosk & Web App:

  • Book (requires licensing and a calendar service integrated directly or connected Webex Workspace with compatible device)

  • Hold (requires a Meeting Room connected to a Webex Workspace with compatible device)

  • None (when neither Book nor Hold is available, or to remove the button entirely and only show real-time status)

Space Experience - Settings - Location and Room Overrides - Room overrides (list)

Space Experience > Settings > Location & Room Overrides > Room overrides (list)

Space Experience - Settings - Location and Room Overrides - Room overrides (popover)

Space Experience > Settings > Location & Room Overrides > Room overrides (popover)


Tenant-to-Domain Mapping

Spaces PM team or Dev team needs to add a Tenant-to-domain mapping for new customers in our system to support Authorization required for desk booking. This requirement is temporary until the self-serve admin interface is available in the Space Experience app. 

Data Required from Customer

Data List

Example Information for Reference

Tenant ID

16305

Account Name

CiscoAlpha

Region(s) Supported

IO

Email Domain(s)

meraki.net, cisco.com

Authenticator App Preference

Google, Microsoft

Space Explorer Web App supports a many-to-many-to-many mapping of Tenant ID(s) to domain(s) to Microsoft/Google tenant(s). In other words, it is possible to map Tenants 12345 and 67890 to domains example1.com and example2.com each with their own Microsoft Entra or Google Workspace account. End users from multiple organizations can login and see a unified Location list and maps from multiple Cisco Spaces Tenants with users on multiple email domains, and (⚠️ ROADMAP ⚠️) even across Cisco Spaces data regions (e.g. .io, .eu, and .sg).


IT Admin Consent

Webex Login - Admin Permissions

For Webex Login, if an admin has blocked apps, then a Control Hub admin will need to manually approve the Cisco Spaces app.

App ID: Y2lzY29zcGFyazovL3VzL0FQUExJQ0FUSU9OL0M3MGIwMDJmOWVhNGI3MGFiNGU5MjgyYzUyOTU2Njg2ZGQxODE0YjRmYzVkYjM4NjFmNmE2OWRmZDY0YTgxMWQw

Webex Control Hub - Apps - Embedded Apps - Allow new Public Apps by default

Webex Control Hub - Apps - Embedded Apps - Allow new Public Apps by default

Google Login - Admin Permissions

For Google Login no admin consent is required.

Microsoft 365 Login - Admin First Time

Background and details on Admin Consent: https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/admin-consent-workflow-overview

  1. Customer Microsoft 365 admin goes to https://booking.dnaspaces.io

  2. Click on “Microsoft” button

Space Explorer - Login

Space Explorer - Login

  1. First time only, a customer will see an “Need admin approval” screen. As a Microsoft 365 full admin, click through “Have an admin account? Sign in with that account.”

(temporary - unverified) Microsoft 365 Login - Admin Approval Screen

(temporary: unverified) Microsoft 365 Login - Admin Approval Screen

  1. Review the scopes/permissions, check the consent box, and Accept

Cisco Spaces - Space Explorer - Microsoft Admin Consent

Cisco Spaces - Space Explorer - Microsoft Admin Consent

Additional Microsoft Entra admin center Details

Microsoft Entra admin center (https://entra.microsoft.com/) provides multiple capabilities for managing the “Cisco Spaces - Space Explorer” Web App integration and troubleshooting Microsoft Login issues. Once logged into Microsoft Entra admin center, navigate to Enterprise apps, then search or look for “Cisco Spaces - Space Explorer” in the list of apps.

Microsoft Entra admin center - Enterprise applications

Microsoft Entra admin center > Enterprise applications

After clicking into the “Cisco Spaces - Space Explorer” list item, go to Manage > Properties to ensure sign-in is enabled and the app is visible to users.

Microsoft Entra admin center _ Enterprise applications _ Cisco Spaces - Space Explorer _ Properties

Microsoft Entra admin center > Enterprise applications > Cisco Spaces - Space Explorer > Properties

Visit the Security > Permissions page to check the app permissions and Microsoft Graph APIs are granted. A Microsoft Entra admin can always grant permissions to restore access to the requested Microsoft Graph APIs using the blue button “Grant admin consent for Cisco Systems, Inc.” which presents the same popup prompts under Microsoft 365 Login - Admin First Time (above).

Microsoft Graph Permission

Type

Reason for Requesting / Use Case

Required

User.Read.All

Application

Retrieve details about the user logging in, such as username/email for identity.

https://learn.microsoft.com/en-us/graph/api/resources/user

User.Read

Delegated

Retrieve details about the user logging in, such as username/email for identity.

https://learn.microsoft.com/en-us/graph/api/resources/user

Optional

Requires onboarding help from Cisco Spaces team.

Calendars.Read

Delegated

Retrieve user’s personal work calendar events to display in Space Explorer Web App “My day” section. Used to enable quickly adding meeting rooms to events without rooms (requires licensing for room booking) or for quickly opening virtual meeting URLs.

https://learn.microsoft.com/en-us/graph/api/resources/calendar

Microsoft Entra admin center _ Enterprise applications _ Cisco Spaces - Space Explorer _ Permissions

Microsoft Entra admin center > Enterprise applications > Cisco Spaces - Space Explorer > Permissions

Visit the Activity > Sign-in logs page to review sign-in attempts and error types.

Microsoft Entra admin center _ Enterprise applications _ Cisco Spaces - Space Explorer _ Sign-in logs

Microsoft Entra admin center > Enterprise applications > Cisco Spaces - Space Explorer > Sign-in logs


Space Explorer Web App - End User Application

End User - Webex Login

  1. Click on Webex Login option

Space Explorer - Login

Space Explorer - Login

  1. Enter email address and the follow prompts to complete your organization’s SSO flow

Webex Login - enter email

Webex Login - enter email

  1. Accept permissions

Webex Login - accept permissions

Webex Login - accept permissions

End User - Microsoft 365 Login

Organizations relying on Microsoft 365 Login for their employees must make sure they grant admin consent for the Cisco Spaces - Space Explorer web app to allow users to login. To grant admin consent, a Microsoft 365 admin user with full admin privileges should login to web app using the Microsoft 365 button.

  1. Click on Microsoft Login option

Space Explorer - Login

Space Explorer - Login

  1. Enter email address and the follow prompts to complete your organization’s SSO flow

Microsoft Login - choose account

Microsoft Login - choose account

End User - Google Login

  1. Click on Google Login option

Space Explorer - Login

Space Explorer - Login

  1. Enter email address and the follow prompts to complete your organization’s SSO flow

Google Login - choose account

Google Login - choose account

  1. Click on Continue to access Space Explorer

Google Login - end user grant consent for login

Google Login - end user grant consent for login

Space Explorer Web App Screens

View and Feature Description

Computer

Mobile

Location list

  • (Default) Building names listed alphabetically

  • (Optional) User grants browser location permissions to sort by distance to the building street address as set in Cisco Spaces Dashboard Location Hierarchy

  • (Optional) Pin or favorite a single building to view it in the Favorite Location section at the top of the building list (stored in browser session storage).

  • Up to three recently opened buildings listed under Recent Locations section.

  • All other buildings listed under Available Locations section.

  • Search by building name and street address. Misspellings not recognized.

Computer - Space Explorer Web App - Location list

Computer - Space Explorer Web App - Location list

Mobile - Space Explorer Web App - Optional Location Permissions

Mobile - Space Explorer Web App - Optional Location Permissions

Mobile - Space Explorer Web App - Location List

Mobile - Space Explorer Web App - Location List

Map (tab)

  • The Web App is fullscreen with widgets on computer screen sizes.

  • The Web App on mobile screen sizes splits widgets into tabs.

  • Depending on whether rooms and/or desks are configured, tabs will appear in the floor view to toggle between each type of space.

  • The building name is clickable to go to the Location list.

  • The floor name is clickable to switch floors in the same building.

  • The Center button resets the map view to the default center point, pitch, bearing, and zoom.

Computer - Space Explorer Web App - Rooms

Computer - Space Explorer Web App - Rooms

Computer - Space Explorer Web App - Desks

Computer - Space Explorer Web App - Desks

Mobile - Space Explorer Web App - Map tab - Rooms

Mobile - Space Explorer Web App - Map tab - Rooms

Mobile - Space Explorer Web App - Map tab - Desks

Mobile - Space Explorer Web App - Map tab - Desks

Room details and Wayfinding

  • The room details popup dynamically updates content based on enabled features.

  • Real-time room availability status (available - green, booked - amber, occupied - red) is available on all configured rooms.

  • Room booking is an upgraded feature that must be enabled by an admin.

  • On computer screen sizes, if Wayfinding is enabled, a Wayfinding QR code is visible to scan and open on a mobile device.

  • On mobile screen sizes, if Wayfinding is enabled, a Get Directions button will cross-launch the iOS Cisco Spaces App Clip or downloaded Android Cisco Spaces App.

  • Desk details popup also dynamically updates content based on enabled features and behaves similarly to room details, except desk booking which has more constrained booking options.

mputer - Space Explorer Web App - Room Details - Available

Computer - Space Explorer Web App - Room Details - Available

Computer - Space Explorer Web App - Room Details - Booked

Computer - Space Explorer Web App - Room Details - Booked

Computer - Space Explorer Web App - Room Details - Occupied

Computer - Space Explorer Web App - Room Details - Occupied

Mobile - Space Explorer Web App - Room Details

Mobile - Space Explorer Web App - Room Details - Available

Mobile - Space Explorer Web App - Room Details - Wayfinding iOS App Clip

Mobile - Space Explorer Web App - Room Details - Wayfinding iOS App Clip

Room and Desk Share button

  • Clicking the Share button will open the operating system’s default share menu.

  • Sharing is available for all enabled rooms and desks.

  • Sharing generates a URL with a sample message text to quickly copy paste or send in available email or messaging platforms.

  • On the receiving end, the shared URL opens on the login page, and after successful authentication, the receiver is taken to the floor and encoded feature (room or desk) that was shared.

  • Sharing is great for informing colleagues where to meet or book, and then use the Wayfinding to get there.

Computer - Space Explorer Web App - Share

Computer - Space Explorer Web App - Share

Mobile - Space Explorer Web App - Share

Mobile - Space Explorer Web App - Share

Room Booking Calendar

  • Click More time options to open the room calendar shows a day view with a click and drag time slot interface.

  • The Time slot duration dropdowns offer another option for entry of specific start and end times.

Computer - Space Explorer Web App - Room Calendar

Computer - Space Explorer Web App - Room Calendar

Mobile - Space Explorer Web App - Room Calendar

Mobile - Space Explorer Web App - Room Calendar

Desk Booking

  • Desk booking options include Morning (00:00 - 11:59), Afternoon (12:00 - 23:59), and All Day (00:00 - 23:59).

  • Opening the desk calendar shows a monthly calendar view with available days depending on the desk configuration and device integration.

Computer - Space Explorer Web App - Desk Booking

Computer - Space Explorer Web App - Desk Booking

Computer - Space Explorer Web App - Desk Calendar

Computer - Space Explorer Web App - Desk Calendar

Mobile - Space Explorer Web App - Desk Booking

Mobile - Space Explorer Web App - Desk Booking

Mobile - Space Explorer Web App - Desk Calendar

Mobile - Space Explorer Web App - Desk Calendar

My day (widget | tab)

  • Change the date to view future room and desk availability depending on feature enablement.

  • Quick book buttons are available depending on enabled booking features for rooms and desks.

  • A booked desk each day appears at the top of the Schedule section.

  • Detected calendar URLs show a Join virtual meeting clickable link to open an online event quickly.

  • Clicking the arrow in a circle icon on a calendar event with no detected meeting room will offer room booking options (if enabled).

  • Clicking on a calendar event with a detected meeting room in the same office that is visible on screen will show it on the map view (to reduce double bookings in the same office).

Computer - Space Explorer Web App - My Day widget

Computer - Space Explorer Web App - My Day widget

Mobile - Space Explorer Web App - My Day tab

Mobile - Space Explorer Web App - My Day tab

Search (widget | tab)

  • Click on Search (widget | tab) to open a search text field and results.

  • Filter based on capacity of meeting rooms.

  • Filter for rooms or desks only the currently visible floor.

  • Results are sorted by capacity (lowest to highest), availability (currently available first), and floor (current floor first and lowest to highest).

Computer - Space Explorer Web App - Search widget

Computer - Space Explorer Web App - Search widget

Mobile - Space Explorer Web App - Search tab

Mobile - Space Explorer Web App - Search tab

Profile Settings

  • Options to change the measurement units (imperial or metric - primarily for distance calculations to buildings) and language.

  • On mobile screen sizes, there is an option to Add app to Home Screen to create a mobile Home Screen bookmark for easy access and fullscreen app-like experience (PWA - progressive web app) on iOS and Android phones.

  • An option to Sign out.

  • Settings are saved to browser session storage.

Computer - Space Explorer Web App - Profile Settings

Computer - Space Explorer Web App - Profile Settings

Mobile - Space Explorer Web App - Profile Settings

Mobile - Space Explorer Web App - Profile Settings


CAVEATS AND TIPS

  1. When using Microsoft 365 and Okta for SSO end user login, especially on mobile devices, please ensure Mobile Device Management (MDM) is setup to allow access to https://booking.dnaspaces.io

  2. Book This Desk gets stuck and a spinner shows indefinitely. Logout and login to try again. Force quit the PWA on iOS or Android and login to try again. The user session may have expired.

image-20250306-214004.png
  1. Save Space Explorer Web App as a home screen bookmark (i.e. PWA) on iOS and Android for easy access

iOS Persistent Web App (PWA) - Add to Home Screen

iOS Persistent Web App (PWA) - “Add to Home Screen”

Android Persistent Web App (PWA) - Add to Home screen

Android Persistent Web App (PWA) - “Add to Home screen”

  1. Location permissions on the Location list view are optional. The Space Explorer Web App uses location to calculate distance to each building and sorts them by closest to furthest. Otherwise, the list is in alphanumerical order.

Space Explorer Web App Location Permissions Prompt

Space Explorer Web App Location Permissions Prompt

  1. Outlines for Workstation types in the CAD file produce easily identifiable spaces.

CAD (.dwg) space outlines

CAD (.dwg) space outlines

  1. Workstation/Desk IDs (or names) must be included in the CAD file layers.

CAD (.dwg) workstation ID or name

CAD (.dwg) workstation ID or name

  1. Workstation furniture is highly recommended

CAD (.dwg) furniture

CAD (.dwg) furniture

  1. No outlines and IDs/names will result in no editable workstations in the Digital Map Editor. They cannot be turned into bookable desks.

CAD (.dwg) without outlines, IDs, or names

CAD (.dwg) without outlines, IDs, or names

  1. In case of Using a MDM solution for devices

    Whitelist the Booking App or associated booking URLs (ex. booking.dnaspaces.io)
    Allow required domains used for SSO login (ex. microsoftonline.com, accounts.google.com, webex.com).
    Permit browser-based authentication and app access in the MDM configuration profile.
    Confirm that the user devices can:

    • Reach required endpoints over HTTPS (port 443).

    • Launch the booking app without restrictions from corporate firewalls or MDM policy.

    • Re-test access after applying policy updates.

  2. Calendar option in the UI:

Currently only works with Microsoft Login by reading user's work calendar through Microsoft Graph APIs.

⚠️ ROADMAP ⚠️: Webex Login user work calendar and Google Workspace Login user work calendar.


REFERENCES

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.