Packaging Jamf Connect Files and Images with Composer

Jamf Connect Documentation
Solution
Application
Jamf Connect
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

If you intend to use custom files or images in your Jamf Connect or Self Service+ deployment, you can use Composer to package them. Create a package source by creating a folder on your computer where you want your custom files to be installed during Jamf Connect or Self Service+ deployment, and then use drag-and-drop to create the new package source and build the package in Composer.

Requirements

  • Composer

  • Files and images to use with Jamf Connect or Self Service+

    Note:

    For the Sign In window, ensure that your image is 449 pixels wide by 131 pixels tall. Larger images are scaled down.

  • A valid certificate to sign the package, if deploying via Automated Device Enrollment. If deploying Jamf Connect or Self Service+ with a Jamf Pro PreStage enrollment package, see the Creating a Signing Certificate using Jamf Pro's Built-in Certificate Authority article.

  • Access to the Jamf Connect and Self Service+ PKG files, which are located in the DMG downloaded from Jamf Account

  1. Open Finder.
  2. Press Command-Shift-G to prompt a Finder search window.
  3. Enter the file path that you want to use to store your Jamf Connect or Self Service+ files and images during deployment, and then click Go.
    Best Practice:Recommended locations include /usr/local/, /Users/Shared/, /Library/Application Support.
  4. Create a new folder in your chosen location.

    If creating the folder at /usr/local or another privileged space, you may be prompted to authenticate as an administrator to create the folder.

  5. Name the folder jamfconnect or something similar.
  6. Add your custom files and images to the folder.
  7. Open and authenticate to Composer, and then drag your created file from the Finder to Composer's sidebar.
    A new package source appears.
  8. Navigate to your Jamf Connect or Self Service+ folder in Composer and configure the following ownership settings:
    1. Choose "root (0)" from the Owner pop-up menu.
    2. Choose "wheel (0)" from the Group pop-up menu.
    3. Click the Action button to the right of the X-column, and select "Apply Owner and Group to jamfconnect and All Enclosed Items" in the pop-up menu.
  9. For each file type in your folder, apply the following permissions:

    File Type

    Permissions

    Parent Folder

    Parent folder mode 755

    Images

    Images mode 444

    Login window scripts

    login window scripts mode 754

    Self Service+ scripts

    menu bar scripts mode 755
  10. In the toolbar, click Build as PKG .
  11. Select a location to save the package and click Save.

Your PKG with Jamf Connect or Self Service+ files and images can now be deployed using a policy or via the Enrollment Packages payload in a PreStage Enrollment with Jamf Pro 10.19.0 or later.

Note:

Packages must be signed using a certificate that is trusted by the computer at the time of enrollment. Signing the package with a certificate generated from either the Jamf Pro built-in CA or from an Apple Developer Program account is recommended.

Make sure the Jamf Connect or Self Service+ app is configured to use these images and icons that you just packaged.