Creating an extended integration for SOTI MobiControl assets

Let Oomnitza be your single source of truth!

You'll get complete visibility of your mobile assets as data from SOTI MobiControl is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and SOTI MobiControl in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key mobile asset information
• Configurable reports to share information about mobile assets with your colleagues and management
• Configurable workflows that you can easily create such as:
  • Workflows for automating onboarding and offboarding tasks
  • Workflows for identifying lost and stolen mobile assets
  • Workflows for ensuring that the latest software upgrades and virus definitions are installed on mobile assets

Before you start

To stream SOTI MobiControl data into Oomnitza, you must add OAuth 2.0 credentials to the credentials vault in Oomnitza. To do this, you create OAuth 2.0 credentials. Then, you use the OAuth 2.0 credentials when you add credentials to the Oomnitza vault.

Requirements

Client ID and Client Secret

You can find your SOIT MobiControl Client ID and Secret by running a command on the Windows Server where the SOTI MobiControl instance is hosted. You'll need to supply the following redirect URI:https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_urlwhen running the command.

For further information, refer to the SOTI MobiControl documentation or the SOTI MobiControl Swagger documentation.

Customer domain

The customer domain is your SOIT MobiControl URL. If your URL is https://a008172.mobicontrol.cloud enter the highlighted part of the URL, which is a008172.mobicontrol.cloud

Username and password

Your username and password for your local SOTI MobiControl account. For further information, refer to the SOTI MobiControl documentation.

Add credentials to the vault in Oomnitza

To add your SOTI MobiControl credentials in Oomnitza, complete the following steps:

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration. 
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. On the INFORMATION tab, complete these actions:
   1. Add the name of the credential.
   2. Add the name of the owner. 
2. Ensure that OAuth 2.0 is selected as the Authorization type.
3. Ensure that SOTI MobiControl is selected from the SaaS list.
4. Enter the details listed in the Requirements section.
5. Click Authenticate. You are prompted to log into SOTI MobiControl to authorize your request.
6. Click CREATE.

Next step

Create a SOTI MobiControl global variable before you create the integration.

Add your SOTI MobiControl URL as a global variable

To save time entering information when you create the integration, you can add your SOTI MobiControl URL as a global variable in Oomnitza.

Procedure

1. Log into Oomnitza.
2. Click Configuration > General > Global Settings.
3. Click Add new variable (+).
4. Add the following variable as the key Soti MobiControl.Url
5. Enter your full URL as the value, for example: https://a008172.mobicontrol.cloud 
6. Save your changes.

Next step

Create the SOTI MobiControl integration with Oomnitza.

Integrate SOTI MobiControl with Oomnitza

1. In Oomnitza, click Configuration> Integrations> Overview.
2. Click Block view
3. Scroll down to the Extended section for asset integrations.
4. Click NEW INTEGRATION.
5. Select the integration in the sidebar.
6. Click ADD.

Integration details overview

More information is provided about the following fields to help you complete the integration:

Installation type

Select Cloud if you want to store credentials in the Oomnitza cloud.

Select Local if you want to store credentials locally. Local extended integrations do not support AWS and OAuth authentication. If you want to sync Oomnitza with vendor applications that require AWS or OAUTH authentication, select Cloud.

Integration preferences

By default, the option Create & Update option is selected. Select this option  when you want to edit records and add new records. If you want to edit records and not add new records, select Update Only. If you only want to add new records, select Create Only.

Integration details

To review or update the integrations details, click Edit .

1. Update the integration name if necessary. 
2. Select an installation type.
3. For integration preferences, select an option.
4. Enter the name of the integration user.

Credential details

If you selected Cloud as the installation type, choose one of the following options:

• Select the credentials that were created for the integration.
• Edit the credentials that were created for the integration.
• Create new credentials

Schedule

By default, data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Click the Edit .
2. Configure your schedule.
3. Click Update.

Mappings

To map the fields to Oomnitza, click Edit .

You can define rules for your integration by selecting Edit integration on the mapping page. For example, you may only want to run the integration if a certain contact or region exists. See Filtering integration results.  
You can add new fields to your integration by selecting Add new field   on the mapping page. All you need to do is specify the property name. See Creating custom API fields. 

Creating custom mappings

Map the SOTI MobiControl fields to Oomnitza fields and create custom mappings to get the information that you need to manage your desktop assets.

Launching the integration

Your integration is in Draft mode until the required mandatory fields are added. When added, click Launch to activate your integration. 

If you selected Cloud as the installation type when creating the integration, see Running an extended integration

If you selected Local as the installation type when creating the integration, see Running an extended integration locally.

Viewing data ingested by Oomnitza

Viewing ingested asset data

For asset integrations, click Hardware. If the asset integration also ingests software data, click Software.

Viewing ingested user data

For user integrations, click People. If you chose the option to ingest User and SaaS user data, click Software > SaaS, click the SaaS app, and then click the Users tab. 

Related Links

• Running an extended integration
• Troubleshooting integrations
• Mapping extended integrations

Take advantage of built-in presets to automate tasks

To automate onboarding and offboarding tasks and complete device actions, such as installing or updating plugins on Android devices, you can create workflows .

1. Click Configuration > Workflows 
2. Click Add (+) and select Assets from the list.
3. Drag and drop the API block in the Sandbox.
4. Select a preset:
   • SOTI MobiControl Delete Device
   • SOTI MobiControl Delete Device User
   • SOTI MobiControl Set Device User
   • SOTI MobiControl Device Actions. See Table: List of supported actions.  
5. Configure your workflow.
6. Save, validate, and activate your workflow.

Understanding Workflows

SOTI MobiControl actions

When you create a device action workflow, you are asked to enter the action. In the table below, a list of the actions that are supported in Oomnitza are provided. 

Information source
SOTI MobiControl provided the list of actions that is shown in the table below. To open the original source of this information, replace the {customer domain} part of the URL with your customer domain and then enter this URL in your browser: https://{customer_domain}/MobiControl/api/docs/index#!/Devices/Devices_ExecuteAction

Table: List of supported actions

Action	Description
AdsInstallPlugIns	Installs or updates plugin for an Android device
AllowExchangeAccess	Allow device to access Exchange server through the Enterprise Resource Gateway
AllowSotiSurf	Allow device to access content delivered through the SOTI Surf application
AppFeedbackUpdate	Request the Android device to upload a report containing any changes in its app status to Google Play Server
AppleSoftwareUpdateRefreshStatus	Request the Apple device to refresh OS update status
AppleSoftwareUpdateScan	Request the Apple device to send a list of available OS updates
AppleSoftwareUpdateSchedule	Request the Apple device to update the OS
BlockExchangeAccess	Allow device to access exchange server through the Enterprise Resource Gateway
BlockSotiHub	Block Access to SOTI Hub
BlockSotiSurf	Block Access to SOTI Surf
BypassActivationLock	Bypasses activation lock on the device
Checkin	Requests the device to communicate with the server and update its information
ClearRestrictions	Clears the restrictions password and restrictions set by the user on the device
ClearSotiSurfCache	Clear SOTI Surf cache
Disable	Disconnects a device from the MobiControl deployment server. Disconnected devices will not receive configuration changes or updates from MobiControl until they are re-enabled
DisableAgentUpgrade	Prevent devices from upgrading their agent at the next scheduled or manually requested checkin
DisableAdminMode	To enter user mode (Android only). Corresponding device action in the MobiControl Web Console: "Enter User Mode"
DisableKioskMode	To disable kiosk screen (Android, Windows CE, Windows Desktop Classic only). Corresponding device action in the MobiControl Web Console: "Disable Kiosk Screen"
DisableLostMode	Disable Lost Mode on device
DisablePasscodeLock	Disable passcode on the device
EnableAgentUpgrade	Allow devices to upgrade their agent at the next scheduled or manually requested checkin
EnableAdminMode	To enter admin mode (Android only). Corresponding device action in the MobiControl Web Console: "Enter Admin Mode"
EnableKioskMode	To enable kiosk screen (Android, Windows CE, Windows Desktop Classic only). Corresponding device action in the MobiControl Web Console: "Enable Kiosk Screen"
EnableLostMode	Enable Lost Mode on the device
FactoryReset	Performs device factory reset
Locate	Request the device to send its current location
Lock	Request the device return to the lock screen and in some cases display a message
MigrateToELMAgent	Migrate MobiControl agent on Samsung devices to the ELM agent
PlaySound	Play sound on the device
ResetPasscode	Reset the passcode on the target Android or Android+ device.
RemoteRing	Ask the phone to ring to locate it
ScanForViruses	Scan for virus on the device
SharedDeviceLogout	Logs the current user out of a shared device
SharedDeviceTroubleshoot	Attempts to resolve any issue experienced by a shared device during the login or logout process
SyncFilesNow	Sync files now
SendMessage	Sends a message to the MobiControl agent that is displayed to the active user
SoftReset	Performs device soft reset
SendScript	Sends a script to the device to be executed immediately upon receiving it
SendScriptViaSms	Sends a script via SMS, long scripts will be separated and sent in multiple messages
SendScriptViaPns	Sends a script via Platform Notification Service. (Android Plus only)
SendTestPage	Print test page on the device
TurnOffSuspend	Requests the device to turnoff or enter suspended state
Unenroll	Request the device remove its management configuration, all organization information, and return to an unmanaged state
UpdateVirusDefinition	Request the device to update its virus definitions
UpgradeAgentNow	Upgrade agent immediately if the agent has already enabled for upgrade
UpdateLicense	Upgrade agent immediately if the agent has already enabled for upgrade
Wipe	Request a complete erase of the device and restore it to factory defaults

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your users and software
• Configure custom reports about your users and software
• Create workflows to automate tasks

See Getting started for more information.