Mobile Device Management (MDM)

Mobility for Jira supports the AppConfig standard for Mobile Device Management. This is supported by several MDM systems such as Microsoft Intune, MobileIron, JAMF, AirWatch, etc. With this standard you can control some security features and push out settings to your Mobility for Jira users.

Example configuration:

<dict>
  <key>VERSION</key>
  <integer>1</integer>
  <key>ADD_ACCOUNT</key>
  <true/>
  <key>CAN_REMEMBER_CREDENTIALS</key>
  <true/>
  <key>REMEMBER_CREDENTIALS</key>
  <false/>
  <key>ACCOUNTS</key>
  <array>
    <dict>
      <key>UID</key>
      <string>account_1</string>
      <key>URL</key>
      <string>https://jira.yourorganization.com</string>
      <key>USERNAME</key>
      <string>{{UserPrincipalName}}</string>
      <key>REMEMBER_CREDENTIALS</key>
      <true/>
      <key>CAN_DELETE</key>
      <false/>
    </dict>
    <dict>
      <key>UID</key>
      <string>account_2</string>
      <key>URL</key>
      <string>https://jira.yourorganization.com</string>
      <key>AUTH_TYPE</key>
      <string>web</string>
      <key>REMEMBER_CREDENTIALS</key>
      <true/>
      <key>CAN_DELETE</key>
      <true/>
    </dict>
  </array>
</dict>

VERSION: integer - integer value that represents version of configuration. When value changes clients will remove all previously created accounts and will create new accounts from configuration.

ADD_ACCOUNT: bool - if value is set to false users will not be able to add account on their own. Only accounts provided by this configuration will be available for them. Default value: true.

REMEMBER_CREDENTIALS: bool - global setting that defines initial value of Keep me logged in switches in the app. Default value: false.

CAN_REMEMBER_CREDENTIALS: bool - if value is false, Keep me logged in switches will be disabled in the app and users will not be able to ask app store credentials. Default value: true

SUPPORT_EMAIL: string - use this parameter if want to provide custom support email for users of your organization. Default value: support@mobilitystream.atlassian.net

SHOW_DESCRIPTION_ON_ISSUE_TABLE: bool - if value is true issue list screen will display up to 5 lines of issue description in each row. Default value: false

ACCOUNTS: array - list of pre-configured account. Element type: dict

Account configuration has the following structure:

UID: string (required) - unique identifier of account. If value is missing, account with this configuration will not be created.

URL: string (required) - Jira URL. If value is missing, account with this configuration will not be created.

USERNAME: string - predefined username. Used only for regular login, ignored if Login with 🌐 option used.

AUTH_TYPE: string, possible values: credentials, web, any - authentication type for this account. With credentials auth type, users will not be able to use Login with 🌐. With web auth type users will not be able to use regular login and will be forced to use web login. Default value: any

REMEMBER_CREDENTIALS: bool - global setting that defines initial value of Keep me logged in switches in the app. Default value: false. This value overrides global value for the account.

CAN_REMEMBER_CREDENTIALS: bool - if value is false, Keep me logged in switches will be disabled in the app and users will not be able to ask app store credentials. Default value: true. This value overrides global value for the account.

CAN_DELETE: bool - if value is true, user will be able to use swipe to delete for the account. Default value: false.