EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

EMM | IOS | How to leverage AppConfig on MicroStrategy Mobile app and MicroStrategy Library app


Menglu Xia

Product Owner, Principal • MicroStrategy


This article introduced how to enable AppConfig on iOS MicroStrategy Mobile apps and iOS MicroStrategy Library app. This article is based on AirWatch. But it should be the same with other EMM venders in AppConfig community.

There's no difference between the usage of iOS Strategy Mobile app and iOS Strategy Library app to enable the AppConfig. The only difference is in Part II upload apps. Please upload the app you want to use: Strategy Mobile app or Strategy Library app.

Part I  Enroll device


1. Download "Intelligent Hub" on your device. Go to App Store and search airwatch you will find an app named “Intelligent Hub” and download it to your device.

ka04W000001IstwQAC_0EM44000000RCaG.png

2. Open "Intelligent Hub" on your device. You will be required to register it via email address or server or QR code.

ka04W000001IstwQAC_0EM44000000RCaL.png

3. Go to AirWatch console to enroll your device. 
a. Login to AirWatch console and DEVICES -> List View -> ADD DEVICE.
b. Choose the user you want to enroll.

ka04W000001IstwQAC_0EM44000000RCaV.png
ka04W000001IstwQAC_0EM44000000RCaa.png

Then you will receive an email.

ka04W000001IstwQAC_0EM44000000RCaf.png

4. Use your device to scan the QR code to enroll your device. Then the "Intelligent Hub" will show you login page.

ka04W000001IstwQAC_0EM44000000RCak.png

login with your AirWatch console account. Then follow the instructions to install profile and create passcode.

ka04W000001IstwQAC_0EM44000000RCb4.png
ka04W000001IstwQAC_0EM44000000RCb9.png
ka04W000001IstwQAC_0EM44000000RCbE.png
ka04W000001IstwQAC_0EM44000000RCbJ.png
ka04W000001IstwQAC_0EM44000000RCbO.png

Now you have enrolled your device successfully.
 

Part II  Upload App


You can add public apps like the apps in the app store to your AirWatch console or add internal app to AirWatch for users to download.

Add a public application


1. Login to AirWatch console and APPS & BOOKS -> Native -> Public -> ADD APPLICATION

ka04W000001IstwQAC_0EM2R000000n0cI.jpeg

2. Choose the platform of "Apple iOS" and search for "Strategy" to find Strategy applications.

ka04W000001IstwQAC_0EM2R000000n0cm.jpeg

3. Click "SELECT" for the application you want to add.

ka04W000001IstwQAC_0EM2R000000n0cw.jpeg

4. Edit the application, such as upload a different icon, set appropriate category, click "Save and Assign"

ka04W000001IstwQAC_0EM2R000000n0dk.jpeg

Upload an internal application


1. Login to AirWatch console and APPS & BOOKS -> Native -> Internal -> ADD APPLICATION

ka04W000001IstwQAC_0EM44000000RCcH.png

2. Choose the app you want to upload, MSTR app or Library app.

ka04W000001IstwQAC_0EM44000000RCcR.png

3. fill the information of the app you upload. Including app name, version and so on.

ka04W000001IstwQAC_0EM44000000RG99.png

You will find the app in the list after you finished upload the app.

ka04W000001IstwQAC_0EM44000000RG9J.png

 

Part III  Assign App


You can assign the app you uploaded to users.
1. Login to AirWatch console then APPS & BOOKS -> Native to open the app you uploaded.

ka04W000001IstwQAC_0EM44000000RG9J.png
ka04W000001IstwQAC_0EM44000000RG9T.png

2.  Click "ASSIGN" button to open assign page then Click "ADD ASSIGNMENT"

ka04W000001IstwQAC_0EM44000000RG9Y.png
ka04W000001IstwQAC_0EM44000000RG9d.png

3. Choose the "SMART GROUP" you want to assign.

ka04W000001IstwQAC_0EM44000000RG9n.png

4. Fill the other information for assignment. I enable "App Tunneling" and "Application Configuration" here.

ka04W000001IstwQAC_0EM44000000RG9s.png

In Application Configuration part, set configuration key and value to control application behaviors. Please see the below table for all supported keys and sample values.

ConfigurationURL
String

ConfigurationURL
String

mstr://?url=http%3A%2F%2F10.199.56.62%3A80%2FMicroStrategyMobile%2Fasp%2FTaskProc.aspx%3FtaskId%3D getMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3Dc45a415b-0609-4ab3-aaf8-1b82d5c0bf4c&authMode=1&dt=2

For Library Configuration link, please refer to KB484751

EnableDataLossPrevention
Booltrue/false

EnableDataLossPrevention
Booltrue/false

EnableDataLossPrevention
Booltrue/false

DisableEmail
Booltrue/false

DisableEmail
Booltrue/false

DisableEmail
Booltrue/false

DisableOpenIn
Booltrue/false

DisableOpenIn
Booltrue/false

DisableOpenIn
Booltrue/false

DisablePrint
Booltrue/false

DisablePrint
Booltrue/false

DisablePrint
Booltrue/false

DisableCopyPaste
Booltrue/false

DisableCopyPaste
Booltrue/false

DisableCopyPaste
Booltrue/false

DisableCameraAccess
Booltrue/false

DisableCameraAccess
Booltrue/false

DisableCameraAccess
Booltrue/false

DisableLocationServices
Booltrue/false

DisableLocationServices
Booltrue/false

DisableLocationServices
Booltrue/false

DisableSaveToPhotos
Booltrue/false

DisableSaveToPhotos
Booltrue/false

DisableSaveToPhotos
Booltrue/false

EnableDataLossPrevention should be set to true to make other boolean values to take effect.
5. Click "ADD" then "SAVE AND PUBLISH" to publish your assignment.

Part IV  Download App


After you enrolled your device with "Intelligent Hub" you will find there is another app named "Catalog" on your device.

ka04W000001IstwQAC_0EM44000000RChl.png

Open "Catalog" you will see the app you have assigned to you and download it.

ka04W000001IstwQAC_0EM44000000RGAW.png

Part V  Configure AppConfig


In previous section. When I create assignment I have enabled "App Tunneling" and choose a existed Per-App VPN Profile and enabled "Application Configuration" and add two key-values pairs to control my app can send email or not.

ka04W000001IstwQAC_0EM44000000RG9s.png

Since I have enabled App Tunneling and choose a Per-App VPN Profile there will be a profile auto downloaded to my device and you will see it in the Settings -> VPN

ka04W000001IstwQAC_0EM44000000RCjI.png

You need to download an app named "Tunnel" for App Tunneling feature. 

ka04W000001IstwQAC_0EM44000000RGAb.png

When you open the app you assigned to your device with App Tunneling feature on you will see the VPN mark on the left top corner on your device.

ka04W000001IstwQAC_0EM44000000RGAg.png

Here I have enabled "Application Configuration" and add two key-values pairs to control my app can send email or not.
EnableDataLossPrevention: true
DisableEmail: true
This means that I have disabled the send email feature in my app.
We can also view the configuration we push in the log:

ka04W000001IstwQAC_0EM44000000RGAv.png

 

Part VI  Change AppConfig


1. Login to AirWatch console then go to  APPS & BOOKS -> Native and choose your app and click it.
2. Click "ASSIGN" button.

ka04W000001IstwQAC_0EM44000000RG9Y.png

3. Choose the assignment you want to modify and click "EDIT".

ka04W000001IstwQAC_0EM44000000RGBF.png

4. Modify the configuration in your assignment. I disable App Tunneling and change the DisableEmail to false which means I don't disable email in my app.

ka04W000001IstwQAC_0EM44000000RGBK.png

5. Add and publish. Then you will find that the VPN mark has gone and I can send email in my app.
We can also view the result in the log:

ka04W000001IstwQAC_0EM44000000RGBZ.png

  KB442304


Comment

0 comments

Details

Knowledge Article

Published:

November 27, 2018

Last Updated:

December 10, 2021