Creating an app configuration

Create an app configuration profile in the IBM® MaaS360® Portal.

You can create an app configuration from the following workflows.
  • App Configurations
  • App Catalog
  • App Summary

Adding an app configuration through the App Configurations workflow

Follow the steps to add an app configuration.
  1. From the IBM MaaS360 Portal home page, go to Apps > App Configurations.
  2. Click Add Configuration.
  3. On the Add app configuration window, enter the following details.
    App configuration name
    Enter a name for your configuration.
    Create from existing configuration
    Use an existing configuration as a base for your new configuration instead of creating a new configuration.
    Select the app you want to configure
    Use the search icon to find an app that you want to add the configuration to. MaaS360 displays a list of apps that are added to the App Catalog that match the search criteria.
    Select managed config
    Click the drop-down list to view the app configurations that are configured for the selected app. The configurations from the selected app configuration are used as a base for the new configuration.
  4. Click Next. The configuration settings that are available for the app are displayed on the Configuration tab.
    The following configuration options are displayed based on the type of app.
    App type Configuration options
    Google Play app Supported app configurations are displayed
    Private app for Android Enterprise Supported app configurations are displayed
    Enterprise app for Android Upload XML template file
    iOS app Select a mode of base configuration:
    AppConfig community
    The supported configuration settings that are natively coded to the app by the AppConfig community.
    XML template upload
    Use the XML template to enter the configuration settings for the app.
    Manual configuration
    Enter configuration attributes that are provided by the app developer. For these values, you can use variables such as a fixed string, username (%username%), domain (%domain%), email (%email%), deviceId (%csn%), or any other custom user attributes.
    Notes:
    • The apps that support managed app configuration must be added to the App Catalog before you can add configuration settings for those apps.
    • Use custom attributes such as username (%username%) or domain (%domain%) to configure the settings.
    • Bundle array configurations are supported on Android 6.0+ only. For more information, see Understanding OEMConfig settings.
    • The app configurations apply to the primary version of the iOS enterprise apps only. The additional versions of iOS enterprise apps do not support app configurations.
    • By default, the XML template that the administrator selects for the first app configuration is used for all app configurations that are created for an app. MaaS360 does not allow administrators to override XML templates later.
    • The app and its configuration can be distributed only if it is the same device group.
  5. Click Next.
  6. On the Distributions tab, choose the entities to distribute the app configuration
    Set as default configuration
    The default configuration is automatically distributed to the device if another configuration is not specified for that device through a group-based or a device-based distribution.
    Groups
    Select the groups that receive the app configuration. The app and its configuration can be distributed only if it is the same device group. If the target group is specified incorrectly, the app configuration is not deployed to the devices.
    Specific devices
    Select the individual devices that receive the app configuration.
    Distribute application
    The application is distributed to the selected groups and devices along with the app configuration.
  7. Click Publish. The configuration settings are deployed to the device. The app configuration is displayed at Apps > App Configurations. The app is added to the App Catalog and the corresponding app configurations are displayed in the App Configurations section on the App Summary page.

Adding an app configuration through the App Catalog workflow

Create an app configuration when you add the app to the App Catalog. For existing apps, you can add app configurations from the App Summary page.

Follow the steps to add an app configuration.
  1. From the IBM MaaS360 Portal home page, go to Apps > Catalog.
  2. Click Add and select the app that you want to add. For example, you can go to iOS and select apps from the iTunes App Store App or Enterprise App for iOS, and for Android, you can select apps from Google Play and Google Enterprise App.
  3. Select the app that supports managed configuration. Details about managed configuration for the app are mentioned under the Contains Ads section.
  4. Click the Policies and Distributions tab.
  5. Select Set App Configuration and then click Add and Configure.

    The detail view of the app configuration page is displayed.

  6. Click Configuration tab and the configuration settings that are available for the app are displayed.
  7. Click Next. On the Distributions tab, choose the entities to distribute the app configuration.
  8. Click Publish. The configuration settings are deployed to the device.

Adding an app configuration through the App Summary page

Follow the steps to add an app configuration from the App Summary page.
  1. From the IBM MaaS360 Portal home page, go to Apps > Catalog. Search for the app for which you want to add the configuration.
  2. Click the View option under the app.
  3. On the App Summary page, go to the App Configurations section and click Add Configuration.

    The detail view of the app configuration page is displayed.

  4. Click Configuration tab and the configuration settings that are available for the app are displayed.
  5. Click Next. On the Distributions tab, choose the entities to distribute the app configuration.
  6. Click Publish. The configuration settings are deployed to the device.