MWM Silverback

Last updated
Save as PDF

Configuring Data Provider

For information on required ports, see Ports Used by Connectors and Data Providers.

The MWM Silverback Data Provider is designed for establishing the integration between Matrix42 Software Asset and Service Management and an MDM server (Silverback server).

To configure the MWM Silverback Data Provider:

In Matrix42 Software Asset and Service Management switch to the Administration application and open the Integration > Data Providers search page.
Double-click the MWM Silverback Data Provider to open it. The properties dialog contains the Configurations list where configurations for this provider can be managed.

To add a new configuration for the Data Provider, click + above the Configurations list. The new properties dialog will open.

Filling new configuration data

General

Data Gateway: Select the Data Gateway instance that will execute the configuration.
Description: Provide additional details about this configuration.
Enable Import: Select the checkbox to activate this configuration for import.

Settings

Server

Server, API Key: Provide the URL and API key for the Silverback server. You can find the API key on the Admin page of the Silverback Console, under User Management > System Users > Admin > Edit > Active API Tokens. To create a new API key, specify the user permissions under Create API Token by selecting the corresponding checkboxes, and then click Create.

Enrollment Service

Category: Select the default Matrix42 Self Service Portal category to place all services for mobile devices that are newly created during the import from Silverback.
Provisioning Workflow: Select the workflow that is used for mobile device enrollment.

Tag Service

Import Tag Catalog: Select this checkbox to import the entire Silverback tag catalog. Selection of this checkbox also activates the Tag Category and Tag Provisioning Workflow fields.
Tag Category: Select the default Matrix42 Self Service Portal category to place all tag-related services.
Tag Provisioning Workflow: Select the workflow that is used for assigning enrolled mobile devices to tags.

Inventory Import Settings

Asset State for New Devices: After the import, the selected status will be assigned to mobile devices that are imported for the first time.
Asset State for Deleted Devices: After the import, the selected status will be assigned to mobile devices that are deleted from Silverback.
Enable automatic assignment of principal user to Device: Select this checkbox for automatic assignment of principal user to Device.
Enable automatic assignment of principal user to SIM Card: Select this checkbox for automatic assignment of principal user to SIM Card.

PIN Settings

PIN: Provide a security PIN that will be used for some of the Silverback actions.

Click Save or Done to save the configuration.

Testing Configuration

You can run the Test Configuration action to check whether all configured settings are correct. As a result, the additional dialog will display validation results for this configuration.

Attribute Mapping

Below is a list of attributes and data definitions that are included in mapping rules for the MWM Silverback Data Provider import definitions. The article describes attribute mapping for the following CIs:

Mobile Device
SIM Card
Business Partner
Stock Keeping Unit
Service
Silverback Tag Service Form

Mobile Device

By default, the data provider imports iOS (including iPadOS) and Android (including Samsung Safe/Knox) devices. The import of Windows 10/11 or macOS devices can be realized with the Unified User Experience and the Enterprise Service Bus.

Mapping

Staging.MDMDeviceID = Production.RelatedSPSAssetClassMobile.MDMDeviceID OR Staging.UUID = Production.RelatedSPSAssetClassMobile.UUID

Attributes

Name	Source Column	Data Definition	Attribute	Relation Match
Is compromised	CompromisedStatus	SPSAssetClassBase	IsCompromised
Name		SPSAssetClassBase	Name
Model	deviceHardwareTypeName	SPSAssetClassBase	Model
Manufacturer	Manufacturer	SPSAssetClassBase	ManufacturerName
Serial Number	deviceSerialNumber	SPSAssetClassBase	SerialNumber

Management Type		SPSAssetClassBase	ManagementType	Value (Value)
Principal User		SPSAssetClassBase	AssignedUser	[A-SQL] Production.ID
Last Seen Time	LastCheckInTime	SPSAssetClassMobile	Last Seen Time
UUID	udid	SPSAssetClassMobile	UUID
MDM ID	deviceIdentifier	SPSAssetClassMobile	MDMDeviceID
Last Synchronization Date		SPSAssetClassMobile	LastSyncDate
IMEI	Imei	SPSAssetClassMobile	IMEI
Is enrolled		SPSAssetClassMobile	IsEnrolled
Status		SPSCommonClassBase	State	Value (Value)
System Serial Number	DeviceSerialNumber	SPSComputerClassBase	SystemSerialNumber
Name		SPSComputerClassBase	Name
Managed By		SPSComputerClassBase	ManagedBy
Version	OsVersion	SPSComputerClassOS	Version
Name	OsClass	SPSComputerClassOS	Name
Detection Type	DeviceId	SPSInventoryClassApplication	DetectionType
Installed		SPSInventoryClassApplication	Installed
Last Import Date	LastSeen	SPSInventoryClassBase	LastImportDate
Last Scan Date	LastSeen	SPSInventoryClassBase	LastScanDate

SIM Card

Mapping

Staging.SimCardId = Production.RelatedSPSAssetClassSIMCard.SimCardId OR Staging.PhoneNumber = Production.RelatedSPSAssetClassSIMCard.PhoneNumber

Attributes

Name	Source Column	Data Definition	Attribute	Relation Match
Principal User		SPSAssetClassBase	AssignedUser	[A-SQL] Production.ID
Management Type		SPSAssetClassBase		Value (Value)
Device	DeviceId_Value	SPSAssetClassSIMCard	Device	[A-SQL] Production.ID
Phone Number	PhoneNumber	SPSAssetClassSIMCard	PhoneNumber
Status		SPSCommonClassBase	State	Value (Value)
SIM Card Id	ICCID	SPSAssetClassSIMCard.SimCardId	SimCardId
Phone Number	PhoneNumber	SPSAssetClassSIMCard.PhoneNumber	PhoneNumber

Business Partner

Mapping

Staging.Name = Production.RelatedSPSSupplierClassBase.Name

Attributes

Name	Source Column	Data Definition	Attribute
Is Manufacturer		SPSSupplierClassBase
Short Name	Manufacturer	SPSSupplierClassBase	Short Name
Name	Manufacturer	SPSSupplierClassBase	Name

Stock Keeping Unit

Mapping

Staging.Name = Production.RelatedSPSStockKeepingUnitClassBase.Name

Attributes

Name	Source Column	Data Definition	Attribute	Relation Match
Type		SPSStockKeepingUnitClassBase	Type	Value (Value)
Assets	DeviceId	SPSStockKeepingUnitClassBase	Assets	[A-SQL]Production.ID
Manufacturer	Manufacturer	SPSStockKeepingUnitClassBase	Manufacturer	[A-SQL]Production.ID
Name	Model	SPSStockKeepingUnitClassBase	Name
Model	Model	SPSStockKeepingUnitClassBase	Model
Description	Model	SPSStockKeepingUnitClassBase	Description

Service

Mapping

Staging.[RelatedST-SPSArticleClassBase].Name = Production.RelatedSPSArticleClassBase.Name

Attributes

Name	Source Column	Data Definition	Attribute	Relation Match
Self Service Description		SPSArticleClassBase	SSPDescription
Self Service Image Field	LargeIconUri	SPSArticleClassBase	SSPImagePath
Service Type		SPSArticleClassBase	ServiceType
Service Form	Name	SPSArticleClassBase	ServiceForm	[ASQL] Production.T(SVCServiceProvisioningClassBaseMDMEnrollment).DeviceConfigurationGroup.GroupID
Self Service Portal Form		SPSArticleClassBase	SSPFormTypeID
Repair Mode		SPSArticleClassBase	RepairMode	Value (Value)
Uninstallation Mode		SPSArticleClassBase	UninstallationMode	Value (Value)
Self Service Name		SPSArticleClassBase	SSPName
Self Service Icon Path		SPSArticleClassBase	SSPIconPath
Provisioning Workflow		SPSArticleClassBase	ProvisioningProcess	[ASQL] Production.T(PLSLWorkflowComponentClassCommon).Id
Create multiple bookings		SPSArticleClassBase	CreateMultipleBookings
Categories		SPSArticleClassBase	Categories	ObjectID (Object ID)
Prerequisites Asql		SPSArticleClassBase	PrerequisitesAsql
Allow Multiple Allocation		SPSArticleClassBase	AllowIdenticalInstances	Value (Value)
Description		SPSArticleClassBase	Description
Provisioning Location		SPSArticleClassBase	ProvisioningLocation
Name		SPSArticleClassBase	Name
Managed by		SPSArticleClassBase	ManagedBy	Value (Value)
Target Type		SPSArticleClassBase	TargetType	Value (Value)
Notes	Comments	SPSArticleClassBase	Notes
Last Sync Date		SPSArticleClassBase	LastSyncDate

Silverback Tag Service Form

Mapping

Staging.TagId = Production.RelatedSPSSilverbackTagServiceFormClassBase.TagId

Attributes

Name	Source Column	Data Definition	Attribute	Relation Match
Name of Device Types	DeviceTypes	SPSSilverbackTagServiceFormClassBase	NameDeviceTypes
Tag Id	tagId	SPSSilverbackTagServiceFormClassBase	TagId

Activating and scheduling MWM Silverback import

MWM Silverback Data Provider can be launched automatically by engine activations that use the Generic Connector engine. For more details see Activating Data Providers page.

Empirum connector and MWM Silverback should not be run more than once overnight and separately from one another. Otherwise, Empirum and Silverback imports that are scheduled to run by the Engine Activations in intervals of an hour or close to each other may result in system errors or deadlocks.