Mobile Device Management (MDM)

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

You can distribute the Jira Server app to people in your organisation using your MDM solution. This allows you to:

  • Deploy the Jira Server app to company-approved iOS and Android devices.
  • Pre-populate your Jira site URLs (just the URL, we don't pass login credentials). People will still be able to enter a URL, which is useful if you have some rarely used sites, and don't want to pre-populate them all. Requires Jira Server iOS app version 1.3.2 / Android app version 0.7.5 or later. 
Summary of MDM functions...
MDM FunctionSupported for Jira Server app
App deploymentYes
App configurationYes - to pre-populate the site URL only
App tunnelYes 
Single sign-on (SSO)No
Access controlNo
Security policiesNo

Read more about AppConfig and what we currently support in our AppConfig Technical Capabilities white paper.

Distribute the app to managed devices

The way you do this will depend on your particular MDM provider. In most cases you will:

  • Add the app to your MDM app catalog. 
    • For iOS you will likely bulk purchase through the Apple VPP store, then link the app in your MDM solution (this might be by providing an sToken, or could happen automatically)
  • Choose which devices should be able to install the app (this might be called something like distributing or assigning the app).

Refer to the documentation for your MDM provider for more information. 

Pre-populate site URLs on the login screen

If your MDM solution supports the AppConfig standard, you can save your users time and prevent mistakes by pre-populating your site URL in the app.  

To pre-populate the mobile app login screen with one site URL:

  1. In your MDM, navigate to the App Config section. Check the documentation for your MDM for how to do this. 
  2. Add a new key called "sites"
  3. In the Value field for the key, enter your site title and URL in JSON format as shown in the examples below. Replace the title and base URL with your own site details. 

    For a single URL: 

    [
    { "title": "My Jira Site", "baseURL": "https://jira.example.com"}
    ]

    For multiple URLs: 

    [ 
     {"title": "My Jira Site", "baseURL": "https://jira.example.com"} ,  
     {"title": "Bug Tracker", "baseURL": "https://bugs.example.com/jira"} 
    ]

    Copy the JSON carefully, including the [ and ].

  4. Save your changes. We recommend you access the Jira Server app on a device to check you have passed the URLs correctly, before distributing the app config changes to your users. You'll see an error if the app can't display your list of sites. 

Here's an example of how the AppConfig looks in AirWatch and MobileIron, two popular MDMs.

 Sample AppConfig in AirwatchSample AppConfig in MobileIron

Parameters

ParameterRequiredDescription
titleYesDescriptive name of your Jira instance.
baseURLYes

URL of your Jira instance. You can check it in Administration > System > General configuration.

URL of your Confluence instance. You can check it in Administration > General configuration.

skipInfo

No

Use this parameter if you’re having problems with logging in because your proxy server blocks any unauthenticated requests. When set to true, the mobile app won’t make login/server-info calls that require authorization and instead redirect your users to your single sign-on page.

Make sure that the Mobile Plugin for Jira is enabled...

In general, the Mobile plugin for Jira is a prerequisite for using the mobile app. However, if you’re using the skipInfo parameter (set it to true) and have the plugin disabled, your users will be able to view a desktop version of Jira and log into it, which is not the correct behavior, but might not look like an obvious error.

If you’re having any problems with logging in, see our knowledge base articles: Jira Server and Data Center mobile apps

(Requires iOS app 1.13.0 / Android app 0.12.1)

Last modified on Dec 1, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.