Android Deployment

After Mobile Eye is successfully installed on any device, go to Configuration >  Licenses > Unassigned to find it. Check the box to the left, then click the Activate button. Within 5 or 10 minutes you should see your first data points for your device.

Starting with Android 11, MAC addresses are no longer provided by the operating system to applications, like Mobile Eye. Therefore, to uniquely identify devices, 7SIGNAL will assign an ID as the device hostname by default, unless otherwise specified by your MDM/EMM deployment solution.

Permissions

First, location services must be turned "on" for your devices.  Then, with your mobile device management (MDM) software, you should be able to auto-grant the four required permissions below.

  • Contacts – to associate results with a device’s host name
  • Location (allow all the time) – to detect if there is a better access point close by
  • Phone – to associate results with a device’s identifier
  • Storage – to check its configuration file

Additionally, you may need to put the device in an administrator mode or revoke the lockdown screen first before pushing the install. 

Microsoft Endpoint Manager (Intune)

  • Add Managed Google Play app, 7SIGNAL Mobile Eye Enterprise
  • Create new app configuration policy with permissions and organization ID
  • Assign both to your group

SOTI MobiControl

  • Create a profile configuration to contain the "high accuracy location permission" which is required by 7SIGNAL Mobile Eye to obtain SSID and BSSID information.
    • Go to Profile Configuration > Restrictions > Feature Control > Location Accuracy
    • Select the High Accuracy option, click Save, then Assign to the device group. 
  • Build a package with SOTI's Package Studio. From 7SIGNAL, get the current APK and a configuration file containing your organization ID. 
  • When building the package, indicate that you want to start the app after it is installed.
  • You may also wish to add a reboot script to your package.
  • Load the package into a profile.
  • Assign the profile to the device group.

If you do not add a reboot script to your package, then you may need to reboot the device with SOTI to launch Mobile Eye.

VMWare's Workspace ONE

Instructions are only applicable for devices in Work Managed Device Mode. Additionally, Location Services must be turned on each device. Go to Devices → Profile → Launcher → Restrictions → Location Services to enable it for your devices in Workspace ONE.

An issue has been identified by VMWare, where setting the Master Permission to Grant All Permissions does not automatically grant permissions to apps on the device if you have devices on Android 9 and below.  Read more about it here Grant Permissions to Android Internal and System Apps via Workspace ONE (WS1) (78590) 

Adding the Organization ID - 1st method

If you obtain Mobile Eye from Google Play, then with Workspace ONE you may use the ‘Application Configuration’ option, then add an ‘Assignment’ where you can modify the following settings:

Restrictions → Managed Access

Distribution → App Delivery Method → Auto

Application Configuration  → 

  • Configuration Key = organization
  • Value Type = string
  • Configuration Value = YourOrgID

WS1-8

Adding the Organization ID - 2nd method

Alternatively, you can add a device profile and add it to assigned device groups.

  • Go to DEVICES → Profiles & Resources → Profiles
  • On the General tab, give this profile the name 7SIGNAL Mobile Eye Org ID
  • On the Custom Settings tab, add the following:
<characteristic type="com.airwatch.android.androidwork.app:com.sevensignal.MobileEyeEnt" uuid="568bc89d-1df8-

4ce9-a041-e5a24acdb7ec">

<parm name="organization" value="globalcorp123" type="String"/>

</characteristic>
  • Click Save and Publish

Auto-Launch App - Two Step Process

  • Go to DEVICES → Provisioning → Components → Files/Actions → ADD FILES/ACTIONS
  • Select Android when prompted for the operating system.
  • On the General tab, give it the name 7SIGNAL Mobile Eye Auto Start
  • Go to the Manifest tab, the Action to Perform is Run Intent. Copy and paste the command line to run below.
mode=explicit,broadcast=false,action=android.intent.action.MAIN,package=com.sevensignal.MobileEyeEnt,class=com.sevensignal.MobileEyeEnt.View.MainActivity

launchapp3
  • Click Save when finished.

Now the second part where we use this newly created action to create a product. Products bundle provisioning components together in Workspace ONE and then can be assigned to groups of devices.

  • Go to DEVICES → Provisioning → Product List View → ADD PRODUCT
  • Select Android when prompted for the operating system.
  • On the General tab, give it the name 7SIGNAL Mobile Eye Product and select the groups of devices that will use this product (called Smart Groups). 
  • On the Manifest tab, click Add.
    • The Action to Perform is File/Action - Install
    • For Files/Actions, select 7SIGNAL Mobile Eye Auto Start (you just created this)
launchapp4
  • Click Save when finished.
  • If the Mobile Eye app does not start after deployment on some or all devices, then you may need to reprocess the action again.
    • Go to Go to DEVICES → Provisioning → Product List View
    • For the Mobile Eye product, click on the the number, indicating the quantity of devices that are "Compliant" or  "In Process" or "Failed".
    • When the list of devices appears, select the ones where Mobile Eye did not start. 
    • Then click the FORCE REPROCESS button.

No Connection to Google Play

An APK version of Mobile Eye is available through 7SIGNAL. 

Organization ID

If you are not obtaining Mobile Eye from Google Play, then you will likely need to manually enter the Organization ID for each device. 

{"organization":"globalcorp123"}
  • You can obtain a copy of this file from 7SIGNAL.
  • Edit the file to include your organization's unique ID.
  • You’ll place the file in the ‘Downloads’ directory of the device.
  • The location of the directory depends on the type of device, for example:

sdcard\download

storage\emulated\0\download\

Note on Running App After Install

There are some MDM/EMM solutions that allow you to automatically launch the application after it’s been pushed to the device. In some cases, its a simple checkbox. If not, then you will need to launch the app manually. 

Full List of Permissions

[{“packageName”:”com.sevensignal.MobileEyeEnt”,”permissions”:[{“name”:”android.permission.INTERNET”,”value”:”1″},{“name”:”android.permission.GET_ACCOUNTS”,”value”:”1″},{“name”:”android.permission.ACCESS_NETWORK_STATE”,”value”:”1″},{“name”:”android.permission.READ_PHONE_STATE”,”value”:”1″},{“name”:”android.permission.WRITE_EXTERNAL_STORAGE”,”value”:”1″},{“name”:”android.permission.FOREGROUND_SERVICE”,”value”:1″},
{“name”:”android.permission.ACCESS_BACKGROUND_LOCATION”,”value”:1″},
{“name”:”android.permission.ACCESS_FINE_LOCATION”,”value”:”1″},{“name”:”android.permission.ACCESS_WIFI_STATE”,”value”:”1″},{“name”:”android.permission.CHANGE_WIFI_STATE”,”value”:”1″},{“name”:”android.permission.WAKE_LOCK”,”value”:”1″},{“name”:”android.permission.RECEIVE_BOOT_COMPLETED”,”value”:”1″}]}]