Skip to main content

Standardized Introduction Workflow for Jamf Connect Menu Bar

Updated over 3 weeks ago

Description

This article provides steps to configure a minimal setup of Jamf Connect menu bar using the Jamf Connect Configuration app and steps to deploy Jamf Connect to test computer using Jamf Pro.

Disclaimer: THE SOFTWARE IS PROVIDED "AS-IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL JAMF SOFTWARE, LLC OR ANY OF ITS AFFILIATES BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OR OTHER DEALINGS IN THE SOFTWARE, INCLUDING BUT NOT LIMITED TO DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES AND OTHER DAMAGES SUCH AS LOSS OF USE, PROFITS, SAVINGS, TIME OR DATA, BUSINESS INTERRUPTION, OR PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES.


Configuring Your Jamf Connect Menu Bar

A. If you haven't already done so, before setting up Jamf Connect, complete the Jamf Connect Identity Provider Integrations by following the steps in one of these integration workflows:


B. Once the integration is complete, follow these steps:

1. If you haven't done so already, download the desired version of the Jamf Connect DMG from account.jamf.com. It will show under Products > Jamf Connect Basic > Downloads. (This needs to be done on a Mac.)

2. Open the DMG and agree to the Terms and Conditions.

3. Copy the Jamf Connect Configuration App to the Applications folder.

This photo shows where you need to Copy the Jamf Connect Configuration into the Applications folder.


4. Drag the Jamf Connect.pkg to the Desktop. Open the Resources Folder and drag the JamfConnectLaunchAgent.pkg to the Desktop as well.

5. Upload the two packages from the Desktop to Jamf Pro.

  • Open Jamf Pro and navigate to Settings > Computers > Packages and click New.

  • Click the upload button.

  • Choose the package from the Desktop (the Display Name will update automatically when we choose the package).

  • Click Save.

  • Repeat the above process for the second package.

6. Create a Policy to deploy the Jamf Connect PKG.

  • In Jamf Pro navigate to Computers > Policies and click New.

  • In the General payload, fill in the: Display Name, category (if applicable), Recurring Check-in and leave Once Per Computer selected.

  • Under the Packages payload select the Jamf Connect package and Launch Agent package that we uploaded in the previous step.

  • Leave the scope empty for now.

  • Click Save.

This photo shows what should display when you are in the Policies tab in Jamf Pro.


7. Open the Jamf Connect Configuration App copied from the DMG earlier.

8. Create a New configuration and configure the minimum keys required for your Identity Provider outlined in Authentication Settings.
An example for Okta is below (Your_Okta_URL would be adjusted to match your Okta instance):

This photo is an example of what your Identity Provider tab should look like when Create a New Configuration.


9. Configure the settings that you would like for Jamf Connect Menubar. (NOTE: For initial testing, it is always best to configure the minimum required keys so that we can verify things work as planned. We can add additional desired keys later outlined in Authentication Settings)

A few commonly configured keys above and beyond the minimal configured are:

  • Change Password URL

  • Password Policy

  • Hidden Menu Items


10. Select the Test button in the upper right hand corner to test the initial setup. Follow the onscreen prompts. If you receive a message that says “You got Tokens” then the configuration is successful.

This photo shows where the Test window will pop up to enter your User name and Password.

11. Select File > Save. Save it as a Property List .plist.

This photo shows where to select your Application type and File Format.


12. In your Jamf Pro instance, go to Computers > Configuration Profiles and click New.

13. On the General payload, complete the Display name. It is suggested to include “Jamf Connect Login.”

14. Select the Applications & Custom Settings payload, click Upload, and click + Add in the upper-right corner.

15. Name the Preference Domain com.jamf.connect.

16. Upload the plist that was saved from the Jamf Connect Configuration app.

Example

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

<key>IdPSettings</key>

<dict>

<key>OktaAuthServer</key>

<string>Your_Okta_URL</string>

<key>Provider</key>

<string>Okta</string>

</dict>

</dict>

</plist>

This photo shows where to enter your plist that was saved from the Jamf Connect Configuration app.


17. Scope to a test computer.

18. Go back to the initial Jamf Connect package deployment policy we created in step 6 and scope that to the same test computer.

19. On the test computer, verify the Jamf Connect Menubar Profile is installed in System Preferences > Profiles.

20. In Terminal we can run the following command to install the policy for Jamf Connect or wait till the computer checks in to Jamf pro: "sudo jamf policy"

21. After the policy installs we should see a Jamf Connect Menubar icon in the upper-right corner and depending on the settings we deploy we should may have a Login window for Jamf Connect Menubar prompt for credentials.

This photo shows what the Jamf Connect Menubar prompt for credentials should look like if it appears. .

Did this answer your question?