Set up IronWiFi with OfficeRnD

Author: Development Team

Last Updated: July 21, 2023 08:01

Introduction

OfficeRnD’s integration with IronWiFi enables Flex space operators to integrate OfficeRnD with their Radius-based Network.

Once the integration is active, operators can get the following benefits:

Enhance security with unified authentication across your network and member apps. Members will enjoy a branded login experience using the same credentials for their mobile app, member portal, and network access.
Simplify onboarding and provide enterprise-grade security via Hotspot 2.0 & VLANs: providing automatic network authentication and secure credential storage, eliminating password-sharing risks, and delivering a seamless WiFi experience for your members.
Track actual member presence providing valuable insights to optimize your Flex space for billing or monitoring purposes.
Automate day-pass usage for members providing a hassle-free experience for operators.
Collect leads using visitors’ information joining the provisioned Guest network provided by the network management system.

As a result, your Network will be more secure, your flexible memberships & billing more automated, your members will have easier access and you will have a better way to track utilization/presence KPIs.

Technical Requirements
Known Limitations
Integrate OfficeRnD with IronWiFi

- Get a new API key from the IronWiFi Console

- Set up the integration in OfficeRnD

- Create a new network in IronWiFi

- Configure your WiFi infrastructure to use IronWiFi as a RADIUS server.

- Configure the IronWiFi Captive portal

- Test the integration

Further Reading

Technical Requirements

Note that all the listed features depend on different features of the network equipment that is being used. Customers should be advised first to make sure the equipment they have or plan to purchase supports all integration features they intend to use before purchasing IronWiFi.

The network equipment should have support for the following features:

Authentication with OfficeRnD credentials - this feature requires RADIUS authentication and authorization and also requires configuring an external captive portal.
Presence tracking - this feature requires your devices to send accounting data to an external RADIUS server.
VLAN tagging requires the device to support VLAN tags and Hotspot 2.0.

Known Limitations

Access is granted to all members with access to the members portal, no matter if they are active or not. This is to be improved in the future.
Disabling access for some users from the members portal won't kick them out of the network immediately. They just won't be let in the next time they try to log into the network.
OfficeRnD doesn't integrate directly with any of the vendors and it works only with the vendors IronWiFi works. Please make sure your network controller is supported by IronWiFi before you move forward with this integration.

Integrate OfficeRnD with IronWiFi

Before getting started make sure you have an IronWiFi account:

1. Log in IronWifi using your account.

2. Navigate to Networks / Networks and create a single network.

Get a new API key from the IronWiFi Console

1. In IronWiFi go to Account / API Keys.

2. Click Create Key.

3. Make sure the Role selected for the API Key has Read or Full rights for Access Points (Owner works, Viewer not).

4. Make sure to save the Token provided after creating the API Key. It’ll be needed for connecting the integration afterward and is visible only once.

Set up the integration in OfficeRnD

1. In OfficeRnD admin go to Settings / Integrations

2. Activate the IronWiFi integration

3. Click Configure.

4. Choose the region you used in the IronWiFi console.

5. Paste the API key you’ve generated

6. Click Authenticate.

In order for the customer to be able to Map Locations to Access Points and take advantage of the location-specific WiFi check-ins, they need to connect the integration using an API Key Token that grants OfficeRnD Read Access permissions to Access Points so the integration can pull them from IronWiFi.

Create a new network in IronWiFi

1. Go to Networks / Networks and click New Network.

2. Click on the newly created network and copy the Shared Secret (you will need it later).

Configure your WiFi infrastructure to use IronWiFi as a RADIUS server.

Follow the instructions on how to set up the infrastructure based on your vendor as described in the IronWiFi documentation. Here are the instructions for Cisco Meraki.

You can take the Radius server configurations from the OfficeRnD admin portal by navigating to Settings/Integrations/Iron WiFi and clicking Configure.

Configure the IronWiFi Captive portal

1. Log in to your account in IronWiFi.

2. Navigate to Networks / Captive Portals.

3. Create a new captive portal entry - be careful to choose the correct network and WiFi infrastructure brand.

4. Click the newly created captive portal to set up its details.

5. Find the Authentication Providers section and expand it.

6. Click Add New under this section.

7. Fill out the form:

Set the first method to REST API.
The API Endpoint is

https://app.officernd.com/api/v1/organizations/<org-slug>/integrations/signin?type=ironwifi&source=portal

Replace <org-slug> with the slug available in the OfficeRnD under Settings/My Account/General.
Set the next method to POST.
Click Create to save the settings.

Test the integration

1. Log in to your account in IronWiFi.

2. Navigate to Networks / Captive Portals.

3. Select the captive portal entry you created in step 4.

4. Click on the Splash Page URL.

5. Login using your OfficeRnD Members Portal credentials.

6. Wait for the message you see the success message.

7. Navigate to Users / Users and verify the user was created there.