The Jamf Pro API Developer Hub

Welcome to the Jamf Pro API developer hub. You'll find comprehensive guides and documentation to help you start working with Jamf Pro API as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Managed App Configuration

Learn the basics of Managed App Configuration and how your app users could benefit

Overview

Managed App Configuration, commonly referred to simply as App Config, allows iOS app developers to customize the app and app user experience when paired with a Mobile Device Management (MDM) solution such as Jamf. Continue reading to learn more about the use cases and benefits of supporting App Config within your app.

What is App Config?

Apple introduced App Configuration in iOS 7 and demand for enterprise apps to support this functionality has grown as Apple devices continue to permeate the enterprise work space. App Config allows MDM solutions to remotely deliver data to a managed device, which can be used by the app to customize the user experience or app behavior.

Why is App Config Valuable?

Building a single app that can be deployed and customized to meet the needs of all your consumers reduces the longterm cost and maintenance of app development. Apps that support App Config will continue to function as originally designed for general consumer use cases, while in enterprise deployments they can be extended to support more customized workflows or environments.

Use Cases

The list of use cases is infinite, but here are a few to help you imagine how supporting App Config within your app could improve the experience of users in an enterprise environment.

UI Customizations

Enterprise organizations often like to rebrand apps to match the branding of their own organization. Instead of building an app for each organization, App Config allows organizations to specify the colors, text or other UI elements that may be unique to their organization.

These changes don't necessarily need to be limited to the look and feel of the app, they can also fundamentally change the behavior or experience of the app. Consider an app that requires connectivity to a server tenant owned by the organization. Rather than prompting a user to input the information themselves, this information could be provided by the MDM server via App Config, making the setup process invisible to the consumer.

Access to User and Device Information

Apple limits the scope of what data apps have access to on iOS devices, for privacy purposes. Having access to information such as device serial number, UDID or even the user the device has been assigned to, can enable app workflows that may not be possible without MDM and App Config. The MDM framework allows for collection of a plethora of data points not available to apps installed directly on a device, and many of these can be made available to the app via App Config. Click here.
to see a full list of data points that can be passed to your app via App Config.

Resources

Now that we understand the premise of App Config, it's time to ideate on how your app could leverage the technology to streamline app deployments in the enterprise. Jamf's Solution Partner Program provides you with access to a team dedicated to helping developers like you, provide valuable solutions that enable Apple in an enterprise ecosystem. Included in your membership to the program is access to an environment of Jamf Pro which will allow you to test and validate your implementation of App Config.

In addition to the resources that Jamf provides, you'll find the following resources essential for building and supporting App Config within your app.

appconfig.org - The central hub that connects app developers, resources and MDM vendors.

Apple's Developer Documentation - Learn how to build support for App Config into your app, including code samples.

Publication

Congratulations, you’ve implemented App Config into your application for an enhanced admin or end-user experience! Now that your app supports this standard, it’s important to take a few steps to make it easy for administrators to deploy this configuration file, and become aware that your app supports it.

  1. Create an AppConfig Spec file with this Spec Creator or the new Beta version.
    1. This describes valid input for your appconfig, and makes generating the appconfig easier.
    2. The result of this is an XML file.
  2. Upload the XML file into the AppConfig Generator or the new Beta version.
    1. This will present a GUI that is helpful for administrators generating this configuration file.
    2. Test this AppConfig in an MDM to ensure it works. Here is documentation on AppConfig for admins in Jamf Pro and Jamf School.
  3. Email the correct spec file to [email protected] to get it listed in the AppConfig generator.
    1. This makes it easy for admins to identify apps that support AppConfig, and configure them accurately.
    2. In the future, this will be a self-serve process. Stay tuned to this page for updates to this process.

Updated about a month ago

Managed App Configuration


Learn the basics of Managed App Configuration and how your app users could benefit

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.