Introduction
Alongside the web dashboard (dashboard.dispel.io), Dispel offers a VPN client for Windows, iOS, and macOS. This application allows users to connect to their end devices on their local computer, as well as reserve and connect to Dispel Virtual Desktops like they would on the web dashboard.
💡 Not Using macOS?
This guide covers the macOS VPN Client Application. Guides for other operating systems can be found here.
Pre-Requisites
In order for your VPN Client application to populate the correct resources, your administrator will first need to:
Set up your Dispel user account as a "User" as the Organization level
Add your Dispel user account to the Region and Facility you need to connect to
Configure the device ACLs for your user account
Additionally, you will need the Mac Remote Desktop Application, which is a free download from the Mac App Store.
If you are unsure about any of this, please reach out to your administrator.
Downloading the Application
First Time Installation Tips
Please ensure the below is true on your local machine prior to installing the Dispel VPN Client Application.
Completely uninstall previous Dispel Nigma client app
Uninstall OpenVPN unless you use it as a regular personal VPN client
Ensure PC can install apps from trusted sources. (Settings -> Update and Security -> For developers)
Ensure Powershell can run remote signed scripts (Settings -> Update and Security -> For developers -> Powershell
Downloading and Opening the App
Recommended Method: You can download the app from the Mac Store. The download process should be the same as any other application.
Alternative: You can follow the download link on the downloads page of the Dispel Dashboard.
This will bring you to the Mac Store in your browser. Click Open App Store in the pop-up window and you will be taken to the Dispel page on the Mac Store Application, where you can then install the app.
Opening the Dispel App
The Dispel app acts the same as any other macOS application. You can open it from the same app store page you downloaded it from, using the Applications sidebar in Finder, or by pressing cmd ⌘ / alt + spacebar and typing Dispel into Spotlight Search.
Once the app is opened, proceed through the privacy notices.
Follow the onscreen prompts to allow the client to install the VPN configuration
Signing Into the App
Log in using your dashboard user's credentials.
If you have MFA enabled, you will be prompted to enter your 6-digit code.
💡 Not Using a Dispel Login?
If using Okta or Microsoft SSO, navigate to "Settings" in the Dispel App, and click the appropriate toggle to enable the correct sign-in method.
Requesting Access
Once logged into the application, you will see the Organizations, Regions, and Facilities that your user is a member of.
In the example below, within the "Dispel Internal" Organization, there is a "C.VPN" Region as well as a C.VPN Facility within it.
If a lock appears next to your facility in the list, click the facility and follow the link provided in the pop-up dialog box to request access.
If you already have access to the necessary facility, proceed to the next section, Connecting with Dispel.
💡 Need to Request Access?
Follow this guide on Requesting Access to a Facility to complete your access request form in the Dispel Dashboard.
Connecting with Dispel
After being granted an access window, return to the Dispel Application and select the Facility you would like to connect to in the left menu.
To connect to that Facility's network, click "Connect with VPN".
You will now be able to access your end devices as if you were using a Dispel Virtual Desktop. However, your computer's connection will be going through the VPN tunnel, so you will not have access to external internet while connected.
💡 Note: If you have a reserved Virtual Desktop, you can only connect through the Desktop until it is destroyed.