Mobile Device Management (MDM)

Still need help?

The Atlassian Community is here for you.

Ask the community

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

  • Deploy the Confluence Server app to company-approved iOS and Android devices.
  • Pre-populate your Confluence 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 Confluence Server iOS app version 1.8.0 / Android app version 0.4.3 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 Confluence Site", "baseURL": "https://conf.example.com"}
    ]

    For multiple URLs: 

    [ 
     {"title": "My Docs Site", "baseURL": "https://docs.example.com"} ,  
     {"title": "Intranet", "baseURL": "https://team.example.com/confluence", "skipInfo": false} 
    ]

    Copy the JSON carefully, including the [ and ].

  4. Save your changes. We recommend you access the Confluence 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. 

Parameters

The following parameters are accepted for the sites key in app config. 

ParameterRequiredDescription
titleYesDescriptive name of your Confluence instance. This will appear above the URL on the app login screen.
baseURLYes

The base URL of your Confluence site. To check it, go to  > General Configuration.

skipInfoNo

Use this parameter if you have log in problems 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 will redirect your users to your single sign-on page.

Make sure the Confluence Mobile plugin is enabled...

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

(Requires iOS app 1.14.0 / Android app 0.6.2)


Here's an example of how the AppConfig looks in AirWatch and MobileIron, two popular MDMs. These screenshots are for the Jira Server app, but the process is the same for Confluence. 

  


Last modified on Apr 6, 2021

Was this helpful?

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