This page describes how to deploy Reflex on a number of Android devices using an MDM tool like Microsoft Intune, Soti, etc.
Prerequisites
The Reflex Android application supports the "managed configuration" feature provided by Android Enterprise.
It only works for terminals running Android 6 or later.
Your MDM tool will therefore need to be able to deploy “managed applications” in accordance with Android Enterprise rules.
Configuration
Each tool is different, however, here we will look at a configuration defined in Microsoft Intune.
- Open Microsoft Intune.
- Search for the Reflex Web application in the Google Play Store, which can be accessed from the MDM tool: https://play.google.com/store/apps/details?id=hardis.com.wagonandroid&hl=en
- Make the application available.
- In the application properties, assign the application to the relevant users or terminals.
- Return to the main menu and select "App configuration policies".
- Create a "managed devices" policy and assign it to the Reflex Web application.
You then need to input the parameters exposed by Reflex Web.
Depending on your MDM tool's capabilities, you can choose between two configuration methods:
Reflex Web parameters
Assisted configuration
Microsoft Intune provides a "Designer" configuration but unfortunately it does not support the "bundleArray" parameter lists exposed by Reflex Web. You will therefore need to use a json file for the configuration.
You will find the description of the parameters further down on this page.
Configuration via json file
The json file consists of lists of keys to which a value must be assigned.
Extract from the json file:
{
"kind": "androidenterprise#managedConfiguration",
"productId": "app:hardis.com.wagonandroid_beta",
"managedProperty": [
{ "key": "configurations",
"valueBundleArray": [
{ "managedProperty": [
{ "key": "pref_name", "valueString": "Test" },
{ "key": "pref_icon", "valueString": "favicon.ico" },
{ "key": "pref_cat_connection",
"valueBundle": {
"managedProperty": [
{ "key": "pref_url", "valueString": " https://10.209.5.47:443/reflex " },
{ "key": "pref_environment", "valueString": "formation" },
{ "key": "pref_application_profile", "valueString": "RFXPGM=HEPWAG&RFXFOR=01" },
{ "key": "pref_url_parameters", "valueString": "" },
{ "key": "pref_desktop", "valueString": "android" },
{ "key": "pref_keep_alive", "valueInteger": 10 }
]
...
You can define several configurations (parameter groups) to enable access to your test environment or production environment, for example, by duplicating the data block, as shown below.
Example of a json file with two parameter groups:
{
"kind": "androidenterprise#managedConfiguration",
"productId": "app:hardis.com.wagonandroid_beta",
"managedProperty": [
{ "key": "configurations",
"valueBundleArray": [
{ "managedProperty": [
{ "key": "pref_name", "valueString": "Test" },
...
]
},
{ "managedProperty": [
{ "key": "pref_name", "valueString": "Production" },
...
Description of Reflex Web parameters
Configurations
Configurations table. A configuration is a set of parameters corresponding to a Reflex environment (e.g.: a test or production environment).
Description | Json key (type) | Mandatory? | Purpose and possible values | ||||||||||||||
Title | Pref_name (string) | yes | Name of the parameter group, possible value: "Test" | ||||||||||||||
Icon | Pref_icon (string) | Shortcut icon file, recommended value: "favicon.ico" | |||||||||||||||
Connection parameters | |||||||||||||||||
Application URL | Pref_url (string) | yes | Root URL for the Reflex server. Possible value "http://10.209.5.46:8080/reflex" /reflex must be included as the suffix. | ||||||||||||||
Name of the environment | Pref_environment (string) | yes | Reflex environment name; possible value: "Test" | ||||||||||||||
Application | Pref_application_profile (string) | yes | If you opted for assisted configuration, you will just need to select the designation from the drop-down list. If you are using the json file for the configuration, you will need to assign the corresponding value to the parameter.
| ||||||||||||||
URL parameters | Pref_url_parameters (string) | Additional parameters to be added to the URL. Freely input value. | |||||||||||||||
Desktop | Pref_Desktop (string) | Recommended value: "android" | |||||||||||||||
Connection time | Pref_Keep_alive (integer) | Time in seconds (between 5 and 60) after which a ping is sent in order to prevent disconnection from the network. Recommended value =30 | |||||||||||||||
| Security parameters | |||||||||||||||||
Using the system's browser for user authentication | Pref_Use_external_browser_auth (boolean) | If this option is selected, user authentication (JEE, OpenID) will be based on the system's browser. Recommended value: true | |||||||||||||||
The server name is not verified. | Pref_Ssl_allow_all_hosts (boolean) | If this option is selected, the server name will not be verified during the SSL connection. | |||||||||||||||
Private SSL certificate | Pref_Private_ssl_certificate (string) | Environment certificate in Base64 “cer" or "pem" format over a single line. | |||||||||||||||
Display parameters | |||||||||||||||||
Orientation | Pref_Display_orientation (integer) | yes | Recommended value: 1 Possible values: 1: Based on terminal screen 2: Based on screen rotation 3: Portrait 4: Landscape 5: Reverse portrait 6: Reverse landscape | ||||||||||||||
Emulated screen resolution | Pref_Resolution (string) | yes | Possible values: -1 -1 : Based on terminal screen 320,240: Emulation 320 x 240 (QVGA) 640,480: Emulation 640 x 480 (VGA) 800,600: Emulation 800 x 600 (SVGA) | ||||||||||||||
Full screen | Pref_Full_screen (boolean) | Execution in full screen mode. Expands the application so that it displays on top of the Android tool bar. Recommended value: false | |||||||||||||||
Ide the toolbar | Pref_Hide_action_bar (boolean) | Hides the Reflex tool bar. To display it again, swipe the screen. Recommended value: true | |||||||||||||||
Message fonts | Pref_Message_font (integer) | Font size of characters in error messages. Recommended value =8 | |||||||||||||||
Prevents sleep mode. | Pref_Keep_screen_on (integer) | Recommended value =0 0: Deactivated, sleep mode is managed by the system's parameters. < 0: The terminal never goes into sleep mode. >0: Sets the period of inactivity in seconds after which the terminal will switch to sleep mode. | |||||||||||||||
Miscellaneous parameters | |||||||||||||||||
Enables notification of incoming intents | Pref_Enable_Notification | Value: true/false. | |||||||||||||||
Deactivating keyboard focus | Pref_Disable_keyboard_focus (boolean) | If this option is selected, the Android keyboard will not display automatically when a field is activated. Recommended value =false | |||||||||||||||
Activating automatic focus | Pref_Enable_auto_focus (boolean) | Activates automatic focus management during confirmation of an input field. Recommended value =false | |||||||||||||||
Shaking to refresh | Pref_Shake_to_reload (integer) | Sensitivity level of the shake sensor. 0: deactivated 3: Very sensitive 10: Normal 25: Not very sensitive Recommended value: 0 | |||||||||||||||
Number of shakes | Pref_Num_of_shakes (integer) | Recommended value: 0 | |||||||||||||||
Display error details | Pref_Error_detail (boolean) | Recommended value: true | |||||||||||||||
Activating NFC support | Pref_Enable_nfc (boolean) | ||||||||||||||||
Activating Zxing support | Pref_Enable_zxing (boolean) | Activates the camera for bar code scanning Recommended value: false | |||||||||||||||
Logging parameters | |||||||||||||||||
Activating the log | Pref_Enable_logging (boolean) | Activates logging Recommended value: false | |||||||||||||||
Detail level | Pref_Log_level (string) | Log level Possible values: ERROR, WARN, INFO, DEBUG, TRACE. Recommended value: ERROR | |||||||||||||||
Transfer protocol | Pref_Log_upload_protocol (string) | Possible values: FTP, AWS | |||||||||||||||
Server URL | Pref_Log_upload_server (string) | Server URL Example: ftp://xxx or http :xxx | |||||||||||||||
Profile | Pref_Log_upload_login (string) | ||||||||||||||||
Password | Pref_Log_upload_password (string) | ||||||||||||||||
Backup directory | Pref_Log_upload_directory (string) | Directory on the server where the log files will be saved. AWS bucket FTP directory | |||||||||||||||
| Permissions on menus parameters | |||||||||||||||||
Environments | Pref_enable_environment_menu (boolean) | Makes the environments menu visible Recommended value: true | |||||||||||||||
Private_ssl_certificate
Description | Json key (type) | Mandatory? | Purpose and possible values |
Private SSL certificate | Private_ssl_certificate (string) | Certificate in Base64 "cer" or "pem" format over a single line. You can configure this value here once, so that it is used globally for all configurations. |
Warnings
It is up to the MDM tool to push updates from the Reflex Android application to the terminals.
The parameters set by the MDM tool can no longer be modified by the user. If you want users to be able to decide this, the MDM tool should not populate the parameter.
Parameters modified by the MDM tool will be taken into account when the Reflex Android application is started.
Desktop shortcuts that enable users to access each Reflex environment directly cannot be deployed automatically. These will need to be created by the user manually using the environment menu in Reflex Apk.
Ajouter un commentaire