Integrate OfficeSpace Safeguard with Kisi

OfficeSpace’s integration with Kisi allows you to manage how employees gain access to your office by enabling badge access once an employee passes the OfficeSpace Safeguard form.

info

This is a partner-built integration, maintained and supported by the partner.

Prerequisites

• Kisi organization administrator rights
• OfficeSpace system administrator rights

Generate a Kisi API key

You need to have organization administrator or organization owner rights to create an API key. We recommend creating API keys from the organization owner's account, to avoid the API key becoming invalid when an organization admin loses their admin rights.

1. Sign in to Kisi
2. On the top right corner, click on your name and click on My Account
3. Next, select the API tab and click on Add API key
4. Enter your name, your Kisi password, and your verification code and click Add
5. Copy the API key shown on the screen and click Close

Configure the integration in OfficeSpace

1. Sign in to OfficeSpace
2. Open the Menu and navigate to the Admin module
3. Open the Connectors dropdown, and select Access Control Integrations
4. Navigate to the Connect to Safeguard subsection
5. Click on Kisi Integration
6. Use the toggle to enable Connection Details
7. Under API Key, enter the Kisi API key you obtained in the previous step

Configure the integration in Kisi

1. Sign in to Kisi
2. Create an organization group for your OfficeSpace users by following this guide
3. Next, add your users by following this guide. Depending on which method you choose to add users, the steps might differ a bit. The goal is to add all your OfficeSpace users to a single Kisi group.
4. Go to your newly created group
5. On the group overview page, click the Copy ID button, since you'll need this ID in an upcoming step

Suspend user's access rights

Once you’ve populated your Kisi group with your OfficeSpace users, you must set their access to Suspended. This ensures that users cannot enter your workplace without completing a Safeguard form and obtaining a positive result. You can do this both from the admin dashboard and via the Kisi API.

Suspend access from the admin dashboard

1. Navigate to your OfficeSpace group
2. Scroll down to the list of users
3. Click on a user
4. Scroll down to Permissions, and enable the Suspend access toggle

Suspend access using the API

To suspend access via the API, follow this guide.

Finalize the configuration in OfficeSpace

1. In OfficeSpace, navigate to the Group/Team Name panel
2. Under Group/Team ID, paste the group ID that you obtained in the previous step
3. Click Save. Now, the group name should automatically be displayed under Group/Team Name to verify that you've selected the ID that matches the correct group.
4. Go to the Assigned Sites panel
5. Use the dropdown to select which sites should be integrated with Kisi. You can also choose to use this integration across all of your sites, using the Select All option.
6. Click Save Assignments

info

The Safeguard results associated with the selected sites are the only ones that will trigger Kisi requests. They must match the locations selected in Kisi for health screening. If no sites are selected here, then no users will be managed based on their Safeguard results.

Once done, requests will be sent to Kisi based on Safeguard results. To see details on the requests being sent, go to Assigned Sites > Logs.

Disabling the integration

1. Sign in to OfficeSpace
2. Open the Menu and navigate to the Admin module
3. Open the Connectors dropdown, and select Access Control Integrations
4. Navigate to the Connect to Safeguard subsection
5. Click on Kisi Integration
6. Use the toggle to disable Connection Details

This will both remove the entry from the list of active OfficeSpace Integrations on the Connectors page, and stop sending Safeguard results from OfficeSpace to Kisi.