Attributes

Use the Attributes page to do the following tasks:

  • Manage the types of information you can record for users, devices, and apps.
  • View the standard types of information that Ivanti Neurons for MDM tracks.

Custom user attributes include information such as Department or an internal ID. Each attribute has a corresponding variable that you can use to build groups or distribute configurations.

While creating user rule group criteria, if the custom attributes have a number value, Ivanti Neurons for MDM does not support integer operations.

Creating custom attributes

Procedure

  1. Log in to the Administrative Portal.
  2. Navigate to Admin > System > Attributes.
  3. Under Custom Attributes, click +Add
  4. In the Attribute Name field, enter text that will represent the attribute.
  5. The text you enter will be used to create the corresponding variable in the Usage field.

  6. Select any the type of attribute from the following Attribute Type options.
    • User
    • Device
    • App
  7. If the Attribute type is Device, select one of the following Data Type options:
    • Numeric
    • Text
  8. Click Add.
  9. The created custom user attribute is displayed under Admin Added section in the Attributes page.

The custom attributes combination ${deviceattribute} + ${custom-attribute} + ${userattribute} + ${Static String} is supported in any order.

Renaming a custom attribute

Renaming a custom attribute will rename all references of that custom attribute that are used in the following entities:

  • Custom Policy
  • User group
  • Device group
  • App Distribution Filter
  • Spaces

References of the custom attribute in any other entities such as configurations, invitation email templates, email and push messages in policy compliance actions, and so on will not be updated.

Procedure

  1. Under Admin Added, click +Edit next to the attribute you want to rename.
  2. In the Attribute Name field, enter a new name that will represent the attribute.
  3. The text you enter will be used to create the corresponding variable in the Usage field.

  4. Click Save.

Deleting a custom attribute

Deleting a custom attribute will remove its values from all the associated users or devices. It cannot be reversed.

Custom attributes cannot be deleted if the attribute is used in any of the following entities:

  • Custom Policy
  • User group
  • Device group
  • App Distribution Filter
  • Spaces

Remove the custom attribute from the entities before attempting to delete the custom attribute.

If the attribute you want to delete does not have references to any of the above entities, clicking Delete next to the attribute will display a pop-up to confirm the action. Confirm the action and click Delete.

Viewing the system attributes

System attributes are pre-defined attributes for you to use in your configurations as variables. The complete list is provided in the System Attributes section of the Admin > System > Attributes page. System attributes include the following types of attributes:

  • User Attributes
  • Device Attributes
  • Email Template Attributes
  • System Attributes
  • Timestamp Attributes
  • AAD Custom User Attributes
  • Policy Attributes

User attributes

Use user attributes to specify information about users.

Key

Description

${department}

department attribute (requires Azure Active Directory)

${edipi}

No description

${managedAppleId}

User's Managed Apple ID

${sAMAccountName}

sAMAccountName attribute (requires Active Directory)

${userCN}

Common Name (CN) attribute extracted from the distinguished name (requires LDAP)

${userDisplayName}

Display name

${userDN}

Distinguished Name (requires LDAP)

${userEmailAddressDomain}

The domain part of the email address (part after '@')

${userEmailAddressLocalPart}>

The local part of the email address (part before '@')

${userEmailAddress}

Email address

${userFirstName}

First name

${userLastName}

Last name

${userLocale}

Locale

${userOU}

Organizational Unit (OU) attribute extracted from the distinguished name (requires LDAP)

${userREALM}

Kerberos Realm information (requires Active Directory)

${userUIDDomain}

The domain part of the login ID (the part after '@')

${userUIDLocalPart}

The local part of the login ID (the part before '@')

${userUID}

Login ID (email address format)

${userUPN}

userPrincipalName attribute (requires Active Directory)

Device attributes

Use device attributes to specify information about a mobile device.

Key

Description

${clientLastCheckin}

Date client last checked-in (most recent checkin - either MDM or Client)

${deviceAltSN}

Alternative Serial Number

${deviceClientDeviceIdentifier}

Identifier used by the client application

${deviceGUID}

Globally unique device identifier

${deviceIccIdentifier}

No Description

${deviceIMEI2}

IMEI2

${deviceIMEI}

IMEI

${deviceIMSI}

IMSI

${deviceLastCheckin}

Date device last checked-in (most recent checkin - either MDM or Client)

${deviceMdmChannelId}

Internal device identifier

${deviceMdmDeviceIdentifier}

Identifier used for MDM

${deviceMEIdentifier}

No Description

${deviceModel}

Model

${deviceName}

Device name

${devicePhoneNumber}

Device phone number

${devicePK}

Cluster unique device identifier

${deviceSN}

Serial Number

${deviceUDID}

iOS UDID

${deviceWifiMacAddress}

Wi-Fi MAC Address

When you create a custom attribute and refer this attribute in a Managed app config, If the attribute value is updated, the attribute referenced in the managed app config also gets updated and the managed app config will be re-pushed to the device.

When the Custom or Device attributes are updated and the configuration is pushed to a device, the Android Kiosk branding configuration should be updated as well.

App attributes

Use app attributes to specify information about applications and create custom application groups.

Key

Description

${appAdded}

Date application was added to the AppCatalog

${appName}

Name of the application

${appOsPlatform}

Application operating system

${appPackageId}

Application bundle or package ID

${appSource}

Describes the source from where the application was imported

${IsVpp}

Describes if an iOS or macOS application is VPP or not

Email template attributes

Key

Description

${policyMessageContent}

No Description

${policyMessageTitle}

No Description

Time stamp attributes

Variable Key

Description

${timestampMS}

Current timestamp (milliseconds since the epoch)

Policy template attributes

Key

Description

${nameOfPolicy}

Policy name violated

${nextAction}

Next Tiered Compliance Action (different than wait and retire) to be taken after send message

${nonComplianceTime}

Count of days device has been in non-compliant state

${policyViolationFirstTime}

Time stamp when policy violation was first triggered (UTC DD-MM-YYYY format)

${ruleConditions}

Rule definition (query string the way it appears now)

Related topics: