In-House Apps

In-house apps are enterprise apps developed through the Apple Developer Enterprise Program. Jamf Pro allows you to distribute in-house apps to users, iOS devices, iPadOS devices, and Apple TV devices with tvOS 10.2 or later. After an app has been distributed, you can also use Jamf Pro to update or remove the app from mobile devices.

For more information on the Apple Developer Enterprise Program or to register, see this documentation from the Apple Developer website.
https://developer.apple.com/programs/enterprise/

When you distribute an in-house app, you configure settings for the app, such as the hosting location, distribution method, whether to make the app managed, and which users and devices should receive it (called "scope").

Note: To distribute or remove managed in-house apps from personally owned devices, you must use the Apps payload of the Personal Device Profile that is used to perform management tasks on the devices. For more information, see Personal Device Profiles.

Managed in-house apps that have been distributed to mobile devices can be validated using the app validation settings. For more information, see In-House App Maintenance Settings.

Managed App Configuration

You can use Jamf Pro to configure settings for a managed app before distributing it to mobile devices.

Note: Managed App Configuration only applies to mobile devices with iOS 7 or later, or Apple TV devices with tvOS 10.2 or later.

There are also several variables that you can use to populate settings in a managed app with attribute values stored in Jamf Pro. This allows you to create preferences containing information about each user and mobile device to which you are distributing the app.

When the app is installed on a mobile device, the variable is replaced with the value of the corresponding attribute in Jamf Pro.

Variable

Mobile Device Information

$DEVICENAME

Mobile Device Name

$SERIALNUMBER

Serial Number

$UDID

UDID

$USERNAME

Username

$FULLNAME or $REALNAME

Full Name

$EMAIL

Email Address

$PHONE

Phone Number

$ROOM

Room

$POSITION

Position

$MACADDRESS

MAC Address

$JSSID

Jamf Pro ID

$APPJSSID

Jamf Pro ID of the App

$SITEID

Site ID

$SITENAME

Site Name

$BUILDINGNAME

Building Name

$BUILDINGID

Building ID

$DEPARTMENTID

Department ID

$DEPARTMENTNAME

Department Name

$JPS_URL

Jamf Pro URL

General Requirements

To distribute an in-house app, you need:

  • The bundle identifier for the app (located in the PLIST file for the app)

  • The archived app file (.ipa) or the URL where the app is hosted on a web server

    Note: If you are hosting the app from a web server, the MIME type for the archived app file must be "/application/octet-stream".

Distributing an In-House App

  1. Log in to Jamf Pro.

  2. Click Devices at the top of the page.

  3. Click Mobile Device Apps.

  4. Click New images/download/thumbnails/81552786/Icon_New_Button.png .

  5. Select In-house app and click Next.

  6. Use the General pane to configure settings for the app, including the distribution method and hosting location.
    If you choose "Distribution Points" or "jamfsoftware database" from the Hosting Location pop-up menu, be sure to upload the archived app file.

    Note: Beginning with iOS 10.3, you can require a mobile device to have a tethered network connection to download the app. A tethered network connection requires a computer with macOS 10.12.4 or later, and must be connected to the Internet via Ethernet and have Wi-Fi turned off. Portable computers must be plugged in to a power source because the tethered caching service prevents computers from going to sleep. Select the Require tethered network connection for app installation checkbox. This checkbox is only displayed if "Install Automatically/Prompt Users to Install" is chosen in the Distribution Method pop-up menu. App updates will not require tethering; this setting is for initial installations of an app only.

  7. Click the Scope tab and configure the scope of the app.
    For more information, see Scope.

  8. (Optional, iOS and iPadOS only) Click the Self Service tab and configure the way the app is displayed in Self Service. You can customize the text displayed in the description for the app in Self Service by using Markdown in the Description field.
    For information about Markdown, see the Using Markdown to Format Text Knowledge Base article.

    Note: The Self Service tab is only displayed if "Make Available in Self Service" is chosen in the Distribution Method pop-up menu.

  9. (Optional) Click the App Configuration tab and configure the preferences as needed.

    Note: The App Configuration tab is only displayed if the Make App Managed when possible checkbox is selected.

    For help generating the preferences, click the AppConfig Generator link. The AppConfig Generator enables you to generate the PLIST file to enter in the Preferences field. For more information about AppConfig, see the AppConfig Community website:
    https://www.appconfig.org

  10. Click Save.

The app is distributed the next time mobile devices in the scope check in with Jamf Pro. If users were added as targets to the scope, the app is distributed to the devices those users are assigned to the next time the devices check in with Jamf Pro.

Distributing an In-House App Update

  1. Log in to Jamf Pro.

  2. Click Devices at the top of the page.

  3. Click Mobile Device Apps.

  4. Click the app you want to update.

  5. Do one of the following:

    • To distribute an update for an in-house app that is hosted on a web server, upload the new archived app file to the web server and update app URL.

    • To distribute an update for an in-house app that is hosted on distribution points or in the jamfsoftware database, upload the new archived app file using Jamf Pro.

  6. Enter the new version number for the app.

    Important: Do not change the bundle identifier. Jamf Pro uses the existing bundle identifier to distribute the update.

  7. Click Save.

The update is distributed the next time mobile devices in the scope contact Jamf Pro.

Related Information

For related information, see the following sections in this guide:

For related information, see the following Knowledge Base article:

Hosting In-House Books and Apps on a Tomcat Instance
Find out how to host in-house apps on the Tomcat instance that hosts Jamf Pro.

Copyright     Privacy Policy     Terms of Use     Security
© copyright 2002-2020 Jamf. All rights reserved.