Description
A custom configuration profile is a configuration profile (.mobileconfig) that was created outside of Jamf School and uploaded for deployment.
This could a configuration profile that was created with a tool like the iMazing Profile Editor or a configuration provided by a software vendor (commonly seen with content filters).
Uploading a Custom Configuration Profile
Locate the configuration file you want to upload.
In Jamf School, go to Profiles > Overview.
In the upper right click + Create Profile.
Select the option for Upload Custom Profile from the platform selection options in the pop-up and click the Next button in the lower right of the pop-up.
Drag and drop your file onto the designated area (or click the drag and drop area to open a file explorer and select the file) and then click Next.
If done correctly, you should see your file name and some basic information that gets parsed from the configuration profile provided (parsed information may vary).
Give your profile a name and a description.
This is the name for the profile as it will be display in Jamf School, note that the display name of the profile may differ on the device as it will look the
PayloadDisplayName
key from within the configuration profile.
(Optional) Enable your time filter and configure it accordingly if desired, the click the Finish button.
Updating a Custom Configuration Profile
When updating custom configuration profiles the updated profile needs to have the same PayloadIdentifier as the original profile otherwise the original profile will be orphaned on the devices in scope.
To avoid ending up with orphaned profile use these techniques one of these 2 techniques:
Upload a New Configuration Profile (less technical option)
This scenario will be used most commonly when a configuration profile is provided by a vendor.Create a new configuration profile using the steps outlined previously.
Scope this configuration profile to the devices that need it.
Un-scope the old configuration profile from devices.
Note:
Steps 2 and 3 may need to be swapped depending on the settings in your profile as some configurations can only have one on a device at a time.
It is recommended to wait at least 7 days before deleting a configuration profile from your instance after un-scoping.
Download your configuration from Jamf School and modify it (much more technical option)
This option requires unsigning the profile and modifying XML or modifying in a tool like iMazing Profile Editor).Navigate to your profile in Jamf School and click the Download button to get the current configuration profile.
In Terminal run:
openssl smime -inform DER -verify -in your_file.mobileconfig -noverify -out unsigned_file.mobileconfig
You need to provide the path to your downloaded configuration profile as well as a path for unsigned configuration profile that will be output
For example, if the profile is in downloads and the unsigned profile will be put on the desktop:
openssl smime -inform DER -verify -in ~/Downloads/configuration_profile.mobileconfig -noverify -out ~/Desktop/configuration_profile.mobileconfig
(Optional) Delete the signed profile to avoid confusion when you go to make changes.
Make the desired changes to the unsigned configuration profile.
Depending on what payloads are in the profile you can open the profile with a tool like the iMazing Profile Editor and use that application to make changes to the configuration.
Or you can open the file with a text editor and modify the XML keys as needed
Make sure not modify the
PayloadIdentifier
keys with in the profile if you are doing this.
Save your changes to the file.
While viewing the profile in Jamf School click the Replace button and provide the file for the updated configuration profile then click Save.
Orphaned Profiles
In the event of an orphaned profile you will likely see one of two scenarios:
Your profile fails to install because one or more of the payloads requires exclusivity (the only payload of its type on the device).
Since your profile is orphaned on the device the new profile cannot install.
Your device is not behaving the way you expect.
This is likely because both your new profile and your orphaned profile are still installed on the device and are fighting over what settings should be applied.
Checking Jamf School for Orphaned Profiles
To check for an orphaned profile do the following:
In Jamf School navigate to Device > Inventory.
Search for the device in questions and view the inventory record.
From the inventory record navigate to the Other Profiles and view the User Installed Profiles table.
Note: Not all profiles listed in this table are orphaned, look for a profile that is one that you deployed from Jamf School as evidence.
If you have any orphaned profile you might see something like this:
Fixing Orphaned Profiles
If you find that you have an orphaned profile on your device(s) try the steps to resolve.
macOS
Open a terminal and run the following command to get the
PayloadIdentifier
for the profile:sudo profiles show
Note: This command requires admin access so the
sudo
is required.
In the output find the name of the Profile that is orphaned and collect the
PayloadIdentifier
which should look like this:_computerlevel[1] attribute: profileIdentifier: 3066A2DF-FA29-4C8B-A4F9-62574C80E049
Not be confused with a very similar line that has some additional whitespace (this is interior
PayloadIdentifier
and not what is needed):_computerlevel[1] payload[1] identifier = 70379E7C-8D86-4A0E-924B-AD97A7C27FC0
Open iMazing Profile Editor and create a new macOS configuration profile (no payloads need).
In the General settings for the profile enter the identifier that you collected in step 2 into the Identifier field (example below).
Save the configuration profile.
Upload this configuration profile to Jamf School as a new custom configuration. See Uploading a Custom Configuration Profile section above these for steps.
Note: Do not scope this profile to any device we want it to remove the orphaned profile from devices when they check in.
Once the device(s) check in they will see they are no longer in scope of a profile with that identifier and they orphaned profile will be removed from the device.
iOS
For iOS devices with orphaned profile please reach out to support of assistance with gathering the PayloadIdentifier of the orphaned profile.