Set Up Venn's Blue Border on a Mac Computer

Venn secures work and protects your privacy by isolating business activity from any personal use on the same device. 

In order to access your work-related data in Venn’s Blue Border on your Mac computer, you will need to install and set up the Venn app, Workplace.

These instructions show the installation process for macOS Sequoia. If you have a different macOS, your experience may vary slightly.

Learn how to set up Venn on a Windows computer.

Review System and Software Requirements

Before you set up Venn on your computer, you must ensure that the device meets the System and Software requirements necessary to run Venn’s Blue Border™.

You may be able to install Venn on a device that doesn’t meet Venn’s system and software requirements, but these devices (very old devices, devices with outdated operating systems, devices with limited RAM available, etc.) will struggle to run Venn and the apps you need to complete your work.

If you used a VDI solution or virtual machine to securely access work apps on your computer in the past, the loading speed for your work applications was determined by the virtual computer where they were hosted.

Venn opens your work applications in an encrypted Secure Enclave on your device, which means that your work applications must be downloaded on your device and the loading speed for your work applications will be determined by your device. Performance issues may be experienced if your device does not meet Venn’s system and software requirements.

Get Your Enrollment Link and Login Information

In order to set up Venn on your Mac computer, your company will provide you with a link that you can use to enroll in Venn. The URL will be in this format: https://[COMPANY_ID].venn.com.

Your login information will be determined depending on how your company manages your user information:

  • Login through Single Sign On (most common): If your company manages your user information through Okta, Azure/Entra, or JumpCloud, you will use that login for Venn.
  • Login with a Venn username and create a password: If your company manages your user information directly in Venn, they will provide you with a username that you will use to log in to Venn (typically your work email address). Venn will confirm your identity by sending a six-digit verification code to the mobile number associated with your account.

If you have already enrolled in Venn on another device and need to install the app on a new Mac computer, you will use your existing Venn login information to sign in.

If you don’t have an enrollment link or login information, reach out to your IT team for support.

Log In

  1. Go to the enrollment link provided by your company in Google Chrome or Microsoft Edge. The URL will be in this format: https://[COMPANY_ID].venn.com
  2. Enter your work email address and click Next.

    Venn Login_Venn IDP.png

  3. Verify your identity. You will see one of the options in the table below depending on how your company manages your user information and whether or not you have logged in to Venn before. Click to expand for detailed instructions: 
    • If you are prompted to log in using Single Sign On:
      1. Click Continue.

        Venn Login_3rd Party IDP.png

      2. Log in using your typical Okta, Azure/Entra, or JumpCloud credentials. You may need to complete multifactor authentication.

        Login_3rd Party IdP.png

    • If you are prompted to check your mobile phone:
      1. Venn will send a six-digit verification code to the mobile number associated with your account. Input the code and click Next.

        new_check_for_SMS.png

      2. Input and verify a password that you will use to log in to Venn going forward and click Set Password.

        new_initial_create_PWD.png

    • If prompted to enter a password, enter your existing Venn password and click Sign In. You may need to complete multifactor authentication.

      Venn Login_3rd Party IDP.png

Download and Run the Installer

  1. On the next screen, click Download Blue Border.

    NEW Download Page.png
  2. Click to open the installer in the top right of your browser window or click the Finder icon in the Dock, go to Downloads, and double-click to open the installer.
  3. Click Install in the utility that opens.
  4. Click Allow in the window that opens to grant permission to test the device health.

    5_workplace_onboarding_downloading_installer_allow_package_installer.png

    The app will not be installed if your device is running an Operating System that doesn’t meet Venn’s Operating System requirements.

  5. Follow the onscreen prompts to install the Venn app, Workplace.
    1. Click Continue.
    2. Click Continue, then Install to use the default installation destination and type.
      • We recommend that you use the default settings, but you can change the default installation destination and type if needed.
      • If you would like to change the installation destination, click Change Install Location to select a different disk for installation.
      • If you would like to change the installation type, click Change Install Type.
    3. If a password is required to install software on your device, a password dialog will appear. If prompted, enter your device password.
      • Input your Mac password, not your Venn password.
    4. Click Install Software.

      mceclip2.png

  6. The installation may take a few minutes to complete.
  7. When installation has completed, click Close, then click Move to trash in the dialog that appears.
  8. Additional components will be set up automatically. The list of components may vary depending on how your company uses Venn. This process may take several minutes to complete. Once all components have been set up, click Done.

    Workplace_First Login_Setup in Progress_Mac.jpg

  9. You may be notified that Workplace has enabled notifications and added features that can run in the background.

    Workplace_Background Items Added Badge_Mac.jpg

When the setup is complete, click to open the Workplace app from your Dock, Apps panel, Launchpad, or under Applications in the Finder. Learn how to open apps on a Mac.

Workplace App.png

If you installed the Venn app without logging in with your Venn login credentials, you may need to log in when you access the app for the first time.

When you open the app, you will either be prompted to set up multifactor authentication (if required by your organization) or to enable Mac permissions.

Set Up Multifactor Authentication on Your Mobile Device (If Prompted)

If your company requires multifactor authentication, you will be prompted to download the Workplace app on your mobile device.

You can skip this step the first time you access the Workplace app, but you will be required to complete this step upon your next login.
  1. Open the camera application on your mobile device and scan the QR code that appears on your screen. Learn how to scan a QR code using an Android or Apple device.
    • If you are unable to scan the QR code, you can also find the app by searching for "Workplace - work_connected" in the Apple App Store or Google Play Store on your mobile device.

      venn_smartphone_qr_code.png

  2. Click Install to install the mobile app
  3. Once installed, open the app.
  4. Enter the username and password that you used to log in to Venn.
  5. Click Create PIN to set a 6-digit Personal Identification Number that lets you quickly log into your mobile app.
  6.  Enter a six-digit PIN and confirm it on the next screen.

    Mobile_Create Pin-portrait.png

Once you complete these steps, you can use multifactor authentication to sign into Venn. After you log in to the Workplace app on your computer, an approval request will be sent to your phone.

  1. Open Workplace on your smartphone.
  2. Enter your 6-digit pin.
  3. Click Allow in the Verify sign-in dialog.

    Mobile_Verify Sign-in.png

Next, you will be prompted to enable Mac permissions.

Enable Mac Permissions

Due to Apple's focus on security, you must enable special permissions to run Venn on a Mac. 

Venn’s Mac Permissions Guide will open automatically once you have finished installing Workplace on your Mac computer. This step-by-step guide will walk you through the process of enabling Venn’s required security and privacy permissions. The guide will explain why each specific permission is needed, and how to access and grant the permission.

The guide will walk you through exactly what to do in each step. As you complete each step, the guide will automatically move to the next.

If the guide doesn’t launch or the options described in the guide aren’t available at any point in the process, restart your computer, log back into the Workplace app, and the guide will resume.

Expand the appropriate section below if you need additional support or information about any of the steps. 

  • In this step, you will allow Venn to create a separate work clipboard so that your company can keep work-related data secure. 

    New macOS Permissions Tour_Tahoe_1.png

    Tips and Troubleshooting

    • If you are unable to make changes on the Login Items & Extensions page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • If you do not see either Workplace.app on the list of applications that you can allow background activity for, restart your computer, log back into the Workplace app, and the guide will resume. Try clicking the link in the guide for this step again to enable the permission.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click General.
      3. Scroll to find and click Login Items & Extensions.
      4. Under App Background Activity, click to toggle the permission on for Workplace.app.

        1_Clipboard_Toggle.png
      5. If prompted, enter your computer password or authenticate using Touch ID.
  • In this step, you will allow Venn to store work-related data securely on your computer. Venn never accesses your personal data.

    New macOS Permissions Tour_Tahoe_2.png

    Tips and Troubleshooting

    • If you are unable to make changes on the Full Disk Access page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • Once you toggle the permission on, you may be notified that the selected application will not have full disk access until it is quit. Rather than clicking Quit and Reopen, click Later to avoid logging out of Workplace.

    • If you do not see either Workplace, Workplace Clipboard Helper, or Workplace Container on the list of applications that you can grant full disk access to, restart your computer, log back into the Workplace app, and the guide will resume. Try clicking the link in the guide for this step again to enable the permission.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click Privacy and Security.
      3. Scroll to find and click Full Disk Access.
      4. Click to toggle the permission on for Workplace, Workplace Clipboard Helper, and Workplace Container.

      5. If prompted, enter your computer password or authenticate using Touch ID.
  • In this step, you will allow Venn to separate your work-related online activity from your personal online activity. Venn does not see your online activity outside of Blue Border, including what websites you visit.

    New macOS Permissions Tour_Tahoe_3.png

    Tips and Troubleshooting

    • If you are unable to make changes on the Login Items & Extensions page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • If you do not see System software application from “Workplace Gateway” was blocked from loading under Security, restart your computer, log back into the Workplace app, and the guide will resume. Try clicking the link in the guide for this step again to enable the permission.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click General.
      3. Scroll to find and click Login Items & Extensions.
      4. Under Extensions, scroll to find and click the information icon to the right of the Workplace Gateway network extension.3_Network Extension_Info.png
      5. Toggle on the Workplace Gateway network extension and click Done.

        Mac Permissions_Enable Work VPN_Toggle On Network Extension.jpg

      6. If prompted, enter your computer password or authenticate using Touch ID.
  • In this step, you will allow Venn to set up a secure internet connection, which is only used for your online activity in Blue Border.

    New macOS Permissions Tour_Tahoe_4.png

    Tips and Troubleshooting

    • If you are unable to make changes on the VPN page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • If you do not see Workplace Gateway when you navigate to the VPN page, restart your computer, log back into the Workplace app, and the guide will resume. Try clicking the link in the guide for this step again to enable the permission.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click VPN.
      3. Toggle on the Workplace Gateway VPN

        4_VPN_Toggle.png
      4. If prompted, enter your computer password or authenticate using Touch ID.
  • In this step, you will allow Venn to display a round badge on the side of your active app window open in Blue Border.

    New macOS Permissions Tour_Tahoe_5.png

    Tips and Troubleshooting

    • If you are unable to make changes on the Accessibility page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • If you do not see Workplace Badge on the list of applications that you can grant access to control your computer, restart your computer, log back into the Workplace app, and the guide will resume.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click Privacy and Security.
      3. Scroll to find and click Accessibility.
      4. Click to toggle the permission on for Workplace Badge.

      5. If prompted, enter your computer password or authenticate using Touch ID.
  • In this step, you will allow Venn to display a light blue border around all your app windows open in Blue Border.

    New macOS Permissions Tour_Tahoe_6.png

    Tips and Troubleshooting

    • If you are unable to make changes on the Screen Recording or Screen & System Audio Recording page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • If you do not see Workplace Container on the list of applications that you can grant access to record the contents of your screen, restart your computer, log back into the Workplace app, and the guide will resume.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click Privacy and Security.
      3. Scroll to find and click Screen Recording or Screen & System Audio Recording.
      4. Click to toggle the permission on for Workplace Container.

        Mac Permissions_Enable Blue Border Container for Work Applications.png

      5. If prompted, enter your computer password or authenticate using Touch ID.
  • In this step, you will allow Venn to make sure that your work activity stays in Blue Border. This setting does not change your default personal internet browser.

    New macOS Permissions Tour_Tahoe_7.png
    Although the system permission language indicates that Workplace will be set as your “default browser,” this permission simply ensures that links that you click from within Blue Border will open in a Blue Border window. Your current default browser setting will be recorded in Blue Border settings. You can always adjust your default browsers for inside and outside Blue Border in your Blue Border settings.

    Tips and Troubleshooting

    • If you are unable to make changes on the Desktop & Dock page, you may need to locate and click the lock icon in the lower left corner of the window and enter your device password.
    • If you do not see Workplace Web Launcher in the list of possible default web browsers, restart your computer, log back into the Workplace app, and the guide will resume.
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the System Settings icon in the Dock or go to the Apple menu and select System Settings.
      2. Scroll to find and click Desktop & Dock.
      3. Scroll down to Widgets.
      4. Click the Default web browser dropdown and change the browser to Workplace Web Launcher to enable the permission. 

        7_Default Browser.png
  • In this step, you will allow Venn to apply your company's policies to your work-related activity. Venn does not control your personal activity.

    New macOS Permissions Tour_Tahoe_8.png

    Tips and Troubleshooting

    • If you do not see both pop-ups, restart your computer, log back into the Workplace app, and the guide will resume. Try clicking the link in the guide for this step again to enable the permission.
  • In this step, you will allow Venn to create an encrypted location where you can store work files when using Blue Border. Venn never accesses your personal files.

    New macOS Permissions Tour_Tahoe_9.png

    Tips and Troubleshooting

    • If you do not see workplace_ under locations in the Finder or the option to enable it when you click on it, restart your computer, log back into the Workplace app, and the guide will resume. 
    • If needed, you can follow these steps to access and enable the permission instead of clicking the link in the guide:
      1. Click the Finder icon Finder in the Dock.
      2. Click workplace_ under Locations in the Finder.
      3. Click Enable next to “workplace_” is not enabled. To access “workplace_” click Enable in the Finder.

  • In order to apply these settings and start using Venn, you need to sign out of your computer.

    New macOS Permissions Tour_Tahoe_10.png
    Before you click Sign out of my computer, make sure that you save any open files.

Once you have completed all of the steps, the Workplace app will open automatically. Next, we recommend pinning the Workplace app to your Dock.

Pin the Workplace App to Your Dock

The Workplace app is set up to open when you log in to your computer by default. We recommend also pinning the app to your Dock so that you can locate and open it easily when needed.

  1. Right click on the Venn icon on your Dock at the bottom of your computer screen.
  2. Click More Options.
  3. Select Keep in Dock.

    Keep in Dock.png

Now you can start using Venn’s Blue Border on your Mac.

Start Using Venn

Once you have completed the steps above, you can start using Venn’s Blue Border on your Mac Computer.

Was this article helpful?