iOS 9.3 Custom Profiles

iOS 9.3 offers a variety of advanced MDM functionality that can be configured through Profiles in AirWatch Admin Console. New iOS 9.3 features and device restrictions will be available in future AirWatch Console releases. However, we understand that not all customers will be able to upgrade to this version immediately. In order to help these customers, AirWatch built a "custom profiles" feature to allow you to push device profiles and restrictions down to iOS 9.3 devices.  

Example code for the following profiles is given below.  Note that all of these profiles require that devices are Supervised.

  • Notification settings
  • Blacklist/Whitelist apps
  • Homescreen layout
  • Lockscreen text

Using Custom Profiles 

The "Custom Settings" payload allows admins to enter their own XML into a profile and apply the profile to devices. Follow the steps below using the iOS 9.3 code found at the end of this document.

1. Configure the General payload and deployment options as desired.

2. If you would like to include any iOS 9.3 features that are not available in the UI for your version, you can add the associated XML below to the Custom Settings payload for your profile. 

  • This XML should contain the complete block of code as listed below, from <dict> to </dict>. 
  • Administrators should configure the setting from <true /> to <false /> as desired. 
  • If certificates are required, then configure a Certificate payload within the profile and reference the 'PayloadUUID' in the Custom Settings payload. See further information within the examples below.

custom_XML.png

 

Notifications settings

<dict>
        <key>NotificationSettings</key>
        <array>
          <dict>
            <key>BundleIdentifier</key>
            <string>com.apple.MobileAddressBook</string>
            <key>NotificationsEnabled</key>
            <true />
            <key>ShowInNotificationCenter</key>
            <true />
            <key>ShowInLockScreen</key>
            <true />
            <key>BadgesEnabled</key>
            <true />
            <key>SoundsEnabled</key>
            <false />
            <key>AlertType</key>
            <integer>1</integer>
          </dict>
        </array>
        <key>PayloadDisplayName</key>
        <string>Notifications</string>
        <key>PayloadDescription</key>
        <string>Notifications</string>
        <key>PayloadIdentifier</key>
        <string>48cb263f-d26a-4c44-9ed6-777ddf28f6f6.Notifications</string>
        <key>PayloadOrganization</key>
        <string></string>
        <key>PayloadType</key>
        <string>com.apple.notificationsettings</string>
        <key>PayloadUUID</key>
        <string>ae06e457-dfe8-4d2f-92a8-a11ecade30c4</string>
        <key>PayloadVersion</key>
        <integer>1</integer>
</dict>

 

Configurable options

This feature is for Supervised devices only.  The following options are configurable in this profile:

  • BundleIdentifier - The identifier of each app being configured.
  • NotificationsEnabled - Are notifications allowed for this app?  Set to true by default.
  • ShowInNotificationCenter - Can notifications be shown in notification center?  Set to true by default.
  • ShowInLockScreen - Are notifications shown in the lock screen?  Set to true by default.
  • AlertType - 0:None, 1:Banner, 2:Modal Alert
  • BadgesEnabled - Are badges enabled?  Set to true by default.
  • SoundsEnabled - Are sounds enabled?  Set to true by default.

 

Blacklist/Whitelist apps

<dict>
        <key>blacklistedAppBundleIDs</key>
        <array>
          <string>com.apple.mobilecal</string>
          <string>com.apple.MobileAddressBook</string>
        </array>
        <key>whitelistedAppBundleIDs</key>
        <array>
          <string>com.apple.MobileSMS</string>
        </array>
        <key>PayloadDisplayName</key>
        <string>Restrictions</string>
        <key>PayloadDescription</key>
        <string>RestrictionSettings</string>
        <key>PayloadIdentifier</key>
        <string>4313979d-13b4-424c-b902-c1da7ff0fb83.Restrictions</string>
        <key>PayloadOrganization</key>
        <string></string>
        <key>PayloadType</key>
        <string>com.apple.applicationaccess</string>
        <key>PayloadUUID</key>
        <string>21a3fd1c-6364-491e-92ca-e655a0a59b3b</string>
        <key>PayloadVersion</key>
        <integer>1</integer>
</dict>

 

Configurable options

This feature is for Supervised devices only.  The following options are configurable in this profile:

  • Note: You may only include one of the options below.  Depending on the type of profile you are configuring, make sure to remove the entire other section.  For example, in a whitelist profile, remove the <key>blacklistedAppBundleIDs></key> line, as well as the following <array>...</array> section.
    • blacklistedAppBundleIDs - If present, all bundleIDs listed in the array will not be shown on the device.
    • whitelistedAppBundleIDs - If present, only bundleIDs listed in the array will be shown on the device.
  • Additionally, note that the bundleIDs are case sensitive.  For example, com.apple.Maps will work, but com.apple.maps will not work.
  • If an invalid bundleID is specified (or a bundleID that is not installed on the device), the profile will still install successfully.
  • You are unable to blacklist the Settings app (com.apple.Preferences).

 

Homescreen layout

   <dict>
        <key>Dock</key>
        <array>
          <dict>
            <key>Type</key>
            <string>Application</string>
            <key>BundleID</key>
            <string>com.apple.MobileAddressBook</string>
          </dict>
        </array>
        <key>Pages</key>
        <array>
          <array>
            <dict>
              <key>Type</key>
              <string>Application</string>
              <key>BundleID</key>
              <string>com.apple.mobilecal</string>
            </dict>
            <dict>
              <key>Type</key>
              <string>Folder</string>
              <key>DisplayName</key>
              <string>Photography</string>
              <key>Pages</key>
              <array>
                <array>
                  <dict>
                    <key>Type</key>
                    <string>Application</string>
                    <key>BundleID</key>
                    <string>com.apple.mobileslideshow</string>
                  </dict>
                  <dict>
                    <key>Type</key>
                    <string>Application</string>
                    <key>BundleID</key>
                    <string>com.apple.camera</string>
                  </dict>
                </array>
              </array>
            </dict>
          </array>
          <array>
            <dict>
              <key>Type</key>
              <string>Application</string>
              <key>BundleID</key>
              <string>com.apple.Preferences</string>
            </dict>
          </array>
        </array>
        <key>PayloadDisplayName</key>
        <string>Home Screen Layout</string>
        <key>PayloadDescription</key>
        <string>HomeScreenLayout</string>
        <key>PayloadIdentifier</key>
        <string>47b294b1-c14c-4446-9299-e5349ef0705e.Home Screen Layout</string>
        <key>PayloadOrganization</key>
        <string></string>
        <key>PayloadType</key>
        <string>com.apple.homescreenlayout</string>
        <key>PayloadUUID</key>
        <string>d0dbcad2-d2ee-4901-83ef-1a65c9af6324</string>
        <key>PayloadVersion</key>
        <integer>1</integer>
   </dict>

 

Configurable options

This feature is for Supervised devices only.  The following options are configurable in this profile:

  • Dock/Pages - Configure whether you are setting apps that appear on the Dock or in the main home screen.
  • Type - Must be set to Application, or Folder.
  • DisplayName - Name below the icon to be shown to the user.
  • BundleID - Required for Application type.  The BundleID of the app.
  • Pages - Required for Folder type.  Used to specify the icons within the folder.  This is an array of arrays of dictionaries.

 

Lockscreen text

<dict>
    <key>IfLostReturnToMessage</key>
    <string>Return to AirWatch</string>
    <key>AssetTagInformation</key>
    <string>AW-123-456-789</string>
    <key>PayloadDescription</key>
    <string>Configures lockscreen with asset info</string>
    <key>PayloadDisplayName</key>
    <string>Shared</string>
    <key>PayloadIdentifier</key>
    <string>com.apple.shareddeviceconfiguration.9AD88C7B-7478-44D0-BEDD-4B1709002917</string>
    <key>PayloadType</key>
    <string>com.apple.shareddeviceconfiguration</string>
    <key>PayloadUUID</key>
    <string>9AD88C7B-7478-44D0-BEDD-4B1709002917</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
</dict>

 

 Configurable options:

This feature is for Supervised devices only.  The following options are configurable in this profile:

  •  IfLostReturnToMessage - The text displayed on the login window and lock screen.
  • AssetTagInformation - Asset tag information for the device displayed on the login window and lock screen.
Have more questions? Submit a request

0 Comments

Article is closed for comments.