Custom Configuration

This section contains the following topics:

License: Silver

Applicable to: iOS, macOS, tvOS, Android, and Windows

Description

Allows you to import and distribute a predefined configuration file.

The valid configuration file formats are as follows:

OS Valid Configuration File Formats
iOS and tvOS
  • .plist
  • .mobileconfig
  • .xml
macOS
  • .plist
  • .mobileconfig
Android .xml. Currently, this feature only supports .xml configuration files for Zebra devices.
Windows SyncML.

XML Payload Defaults

To improve security and meet STIG requirements, Ivanti Neurons for MDM enforces limits on XML payloads and blocks XXE attacks. By default, parsers restrict payload size, nesting depth, element name length, and entity expansions.

Use the following payload defaults:

Setting

Property Key Suffix

Default

Max payload size (bytes)

maxPayloadSize

5 MB (5,242,880 bytes)

Max payload size (chars)

maxPayloadChars

5 MB (5,242,880 bytes)

Max element nesting depth

maxDepth

50

Max element or attribute name length

maxElementNameLength

256

Max attributes per element

maxAttributeCount

100

Entity expansion limit

entityExpansionLimit

2,000

Total entity size limit

totalEntitySizeLimit

1,000,000

Max general entity size

maxGeneralEntitySizeLimit

100,000

Max parameter entity size

maxParameterEntitySizeLimit

100,000

Enforcement enabled

enabled

True

Defining a Custom configuration

Procedure

  1. Select Configurations.

  2. Click + Add.

  3. Type "custom" in the search field, and then click the Custom configuration.

    The Custom Configuration details page appears.

  4. Configure the settings on this page. Refer to the table in the section Custom Configuration settings for guidance on the values.

  5. Click Next to configure the distribution settings.

  6. (macOS devices) Select an additional option for the Who does this configuration apply to setting depending on your desired behavior for this configuration:

    • Device Wide (commonly used).

    • User Specific (current registered user).

  7. Click Done.

Custom Configuration settings

Setting

What To Do

Name

Enter a name that identifies this configuration.

Description

Enter a description that clarifies the purpose of this configuration.

Choose OS

Click an OS icon to upload a configuration file that corresponds to the selected icon.

Choose File

This option appears after you have selected an OS. Drag a configuration  file into the Drag and Drop box, or click the Choose File button to select a configuration file.

Custom CSP Configuration (Windows only)

You can create Custom CSP configuration on Windows devices only. When you select the Windows OS from Choose OS section, you will get two options: 

Option 1 - CSP XML file - Select this option and follow the same process mentioned for the Choose File setting.

Option 2 - Custom CSP OMA-URI Schema Node

Procedure

  1. Select the Custom CSP OMA-URI Schema Node option from the list. The Custom CSP Configuration section appears on the screen.

  2. Under ACTIONS, click the + button to start creating the configuration with different OMA-URI fields.

  3. The Add Row pop up window appears on the screen which has the following fields:

    • Description - Enter any general information about the setting

    • OMA-URI - Enter the OMA-URI that you want to use as a setting

    • Data type - Select a data type that you will use for this setting - DATE, FLOAT, BASE64, NODE, XML, BINARY, CHARACTER, TIME, BOOLEAN, INTEGER

    • Value - Enter a value that is associated with the selected data type

    • Access Type - Add, Delete, Exec, Replace, Get

  4. Click Save & Close to close the window with the provided details. Click Save & Add another to create a new row.

  5. Click Next.

  6. Select the mode of distribution and click Done.

Related Topics