Deploying the Coro Agent with JAMF School

note

If you have questions about using JAMF School or the Composer tool, contact JAMF Support (see https://www.jamf.com/contact/).

For JAMF School documentation, see https://learn.jamf.com/en-US/bundle/jamf-school-documentation/page/Jamf_School_Documentation.html.

To deploy the Coro Agent to your macOS endpoint devices via JAMF School, complete the following processes:

  1. Meet the listed prerequisites
  2. Download the Coro Agent .pkg file
  3. Create and deploy a configuration profile
  4. Create a deployment package
  5. Create a deployment policy
  6. Verify the installation

Prerequisites

Make sure you have:

  • A working JAMF School environment configured for your macOS devices that allows package and configuration profile deployment.
  • The Composer application downloaded and installed. For more details, see https://getcomposer.org/download/ .

Downloading the Coro Agent .pkg file

To download the Coro Agent .pkg file from the Coro console, perform the following actions:

  1. Sign in to the Coro console .
  2. From the sidebar, select Control Panel to access the Control Panel .
  3. Select Devices :

    Devices button

  4. Select Agent Deployment :

    Agent Deployment tab

  5. Select Actions > Download adjacent to the desired macOS Agent version:

    Download link

Coro downloads the Agent installer to your local device.

Creating a new Privacy Preferences Policy Control profile

When deploying Coro to macOS devices through JAMF School, administrators can set up Privacy Preference Policy Control (PPPC) profiles to remotely manage automatic approval for app permissions on target devices. To obtain the necessary configuration for PPPC profiles, see Code Requirements for macOS PPPC profiles.

For details of how to configure PPPC profiles, refer to https://learn.jamf.com/en-US/bundle/jamf-school-documentation/page/Jamf_School_Documentation.html.

Creating a deployment package

Create a nested deployment package for Coro, based on the Coro Agent .pkg file (see Prerequisites).

To create the nested package:

  1. Open Finder , select command+shift+g to open the Go to menu, then type in /tmp .
  2. In /tmp, create and name a folder (for example, coro ).
  3. Drag the Agent installer package into the folder.
  4. Open Composer . If prompted for a snapshot, select Cancel .
  5. In Finder , drag the folder created in step 2 to the left side of Composer . The cursor changes to include a green plus icon.
  6. In Composer , locate and select the folder created in step 2 and confirm that the Owner is set to root and the Group is set to wheel .
  7. Expand the package on the left side of Composer and select and hold (or right-click) scripts . Select Shell Script , then select post-install .

    In the post-install script, replace the content with:

    Copy
    Copied
    #!/bin/bash 
    
    installer -pkg /private/tmp/PACKAGENAME.pkg -target /
    Important

    Replace PACKAGENAME.pkg with the name of the Coro Agent package file.

  8. Select the package on the left side of Composer to save the post-install script.
  9. Select Build as PKG and save to the desktop or another folder location.

See Creating a deployment policy for details of how to deploy the nested package.

Creating a deployment policy

If you already have a software distribution policy in place, add the nested .pkg file you created in Creating a deployment package. Otherwise, create a policy to deploy your nested .pkg file .

To create a software distribution policy:

  1. From JAMF School, go to Computers > Policies .
  2. Select + New .

    JAMF School displays the Options tab.

  3. Provide a name for the new policy, for example, InstallCoro .
  4. Enable the following Triggers :
    • Login
    • Enrollment Complete
    • Reoccurring Check-in
  5. Set Execution Frequency to Once per Computer .
  6. Enable Automatically re-run policy on Failure . Then, set Retry Event to 3 retry attempts .
  7. From the left panel, select Packages > Configure :
    • Add the nested .pkg file you created in Creating a deployment package .
    • From the top, select Scope .
    • Add the devices and groups to which to distribute the Coro Agent.
  8. Select the User Interaction tab.
  9. Set Deferral to No Deferral Type .
  10. Set Example Policy to deploy Coro .PKG and force install .

JAMF School distributes the .pkg to the devices within the chosen scope, and the previously configured Configuration Profile enables all the necessary extensions and components without requiring an Administrator login. This installs the Coro Agent on the devices.

Verifying installation of the Coro Agent on macOS devices

On macOS device, the Coro Agent appears as an application in both the Launchpad and the system tray:

Verify installation on macOS

In the Coro Console, from the sidebar select Views > Devices to view your device:

Verify device in Coro