Integrating Deskworks

Modified on Mon, 22 Apr, 2024 at 2:26 PM



Enabling the integration with Deskworks and isofy is easy:


Prerequisites: 

  • First and very importantly: you must ensure that all of your members' email addresses and company names in the Deskworks system match with the email addresses and private network names in isofy. The "Company" field in Deskworks will map to the "private network" field in isofy. Not completing this step will cause duplicate records and may cause members to end up in the wrong private networks in isofy.

    For example, if, in Deskworks, you have one member under the Company "Google" and another member under the Company "Google Inc.", then these two members will be placed on two separate private networks in isofy: "Google" and "Google Inc." Because isofy securely isolates private networks from each other, these members will not be able to access each other's devices; this is an intentional security feature in isofy. For example, if the member on the network "Google" has a printer, the member in the network "Google Inc." would be unable to access it. This is why it is so important to ensure that all members' Company names and email addresses are consistent before enabling the integration.


  • Second, you will need your Deskworks Center ID and Deskworks Base URL. Please reach out to Deskworks for this center ID and base URL prior to starting the integration setup



Steps to Enable Integration: 


  • Next, in the isofy Admin Dashboard's sidebar, choose Settings, then Integrations:


  • Choose Deskworks:


  • Fill in the Deskworks Center ID and Deskworks Base URL that you received from Deskworks. 
    • Deskworks may send the ID as "center=2", but make sure you just input the number (i.e "2") and not the rest.
    • The exact format of the Base URL does not matter (e.g. "https://isofy.deskworks.app/" vs "isofy.deskworks.app"); isofy is smart enough to reformat it for you behind the scenes, as long is it contains the full URL.
  • Finish by choosing - activate integration:


Configurable options: the following options can be enabled or disabled by moving the toggle switch on the integrations settings page: 

  • Check-in Module: This option will enable Deskworks login on the captive portal login page, allowing your users to log in with their Deskworks accounts.
  • Password Authentication: This option enables password authentication for members to authenticate with their credentials from Deskworks
  • Member Access Token: This option enables member authentication via access tokens from Deskworks.
  • Guest Token Authentication: This option enables guest authentication via guest tokens from Deskworks (i.e. Deskworks' "daily guest code" feature).

 

Check-out Parameters: to help avoid accidental checkouts, for example, a member walking to their car, a variable grace period can be configured. In the isofy Admin Dashboard's sidebar, choose Settings, then Business. Near the bottom of the page under "Check-out grace period (in minutes)" you can adjust this variable 



After adjusting the Check-out grace period click the blue 'Edit' button to save your selection. 



Here's how the Captive Portal would look for end users once Deskworks is integrated:

  • Guest:






  • Members:

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article