Set up IronWiFi with OfficeRnD

Author: Development Team

Last Updated: March 13, 2023 13:39

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:

Unified Authentication – OfficeRnD will synchronize the users’ information securely with your Radius-based network so your members can log in with the same credentials they have for their mobile app & member portal.
Enhanced Security – using separate credentials for each user reduces the risk of leaking a shared password.
Presence tracking – record detailed member presence information – whether you bill by the hour or you want to know when your space is busier, it’s all there.
Automated day-pass usage – after members login into the Network/WiFi using any of their devices, OfficeRnD will automatically deduct from their available day passes.

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.

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.