Mobile Device Extension Attributes

Extension attributes allow you to collect extra inventory information. Extension attribute values are populated by using an input type, which can be any of the following:

  • Text field

  • Pop-up menu

  • LDAP attribute mapping

In Jamf Pro, you can create extension attributes manually.

Examples:

  • A pop-up menu can collect the role selected by a user in the Jamf Setup app.

  • A text field input can collect the retire date of a mobile device.

Extension attributes can also be used as criteria in a smart group or as a variable in a configuration profile, which allows you to administer dynamic management workflows and tasks based on the data collected with extension attributes.

Notes:

  • Mobile device extension attributes do not apply to personally owned mobile devices.

  • Depending on the input type and data type (string, integer, date), extension attributes may add time and network traffic to the inventory collection process.

Extension Attribute Input Types

Extension attributes collect inventory data by using an input type. You can configure the following input types:

Text Fields

You can display a text field in inventory information. You can enter a value in the field anytime using Jamf Pro.

Pop-up Menus

You can display a pop-up menu in inventory information. You can choose a value from the pop-up menu anytime using Jamf Pro.

LDAP Attribute Mapping

You can use an LDAP attribute mapping to populate an extension attribute. Extension attributes can be populated by multiple-value attributes from an LDAP server, such as "memberOf". The multiple values can later be used when creating smart groups and advanced searches with the extension attribute criteria and the “has" or "does not have” operators.

Keep the following limitations in mind when using LDAP multiple-value extension attributes:

  • When creating smart groups and advanced searches, the criteria value must accurately reflect the value returned in inventory. To ensure you use the correct value, copy the extension attribute inventory value, and paste it in the criteria value field.

  • Multiple-value attribute mapping will not work with nested groups. Only the groups directly listed on the User record will be displayed in the mapped LDAP extension attribute.

  • For the extension attributes to work correctly, values returned from the LDAP server cannot contain the sequence of repeating vertical-bar characters (ASCII code 124, HTML entity = |).

Extension Attribute IDs and Variables

Creating an extension attribute generates a variable that can be used to populate configuration profile settings. The variable is $EXTENSIONATTRIBUTE_#, where # is the extension attribute ID.

For information about using payload variables for configuration profiles, see Mobile Device Configuration Profiles.

For extension attributes that use a text field, pop-up menu, or script input type, the ID number is found in the extension attribute URL. In the example URL below, "id=2" indicates the extension attribute ID number:

Example: https://instancename.jamfcloud.com/mobileDeviceExtensionAttributes.html?id=2&o=r

For extension attributes with the LDAP attribute mapping input type, the ID number is displayed in the LDAP Attribute Variable field after you save the extension attribute.

Creating a Mobile Device Extension Attribute

Requirements

If you are creating an extension attribute with the “LDAP Attribute Mapping” input type, you need the following:

Procedure

  1. Log in to Jamf Pro.

  2. In the top-right corner of the page, click Settings images/download/thumbnails/81555258/Icon_Settings_Hover.png .

  3. Click Mobile Device Management.

  4. Click Extension Attributes images/download/thumbnails/81555258/Extension_Attributes.png .

  5. Click New images/download/thumbnails/81555258/Icon_New_Button.png .

  6. Configure the following settings:

    1. Name your extension attribute.

    2. (Optional) Enter a description.

    3. Choose the type of data being collected from the Data Type pop-up menu.

    4. Choose a category in which to display the extension attribute in Jamf Pro from the Inventory Display pop-up menu.

    5. Choose an input type to populate your extension attribute from the Input Type pop-up menu.

  7. Click Save images/download/thumbnails/81531754/floppy-disk.png .

Related Information

For related information, see the following sections in this guide:

Copyright     Privacy Policy     Terms of Use     Security
© copyright 2002-2020 Jamf. All rights reserved.