Skip to content
Features

Managed Attributes

Define which Cisco ISE Endpoint Custom Attributes the platform manages, at group level or endpoint level. The definition grammar, the input types, and what end users get to see.

Managed Attributes are how Endpoint Manager for Cisco ISE handles Cisco ISE’s Endpoint Custom Attributes — the arbitrary fields your ISE deployment can expose for authorization, audit, or reporting.

This page covers the definitions: what an attribute is and how you create one. Setting values is a separate job on the group, see Attribute values on a group. Attributes that hold a Wi-Fi key have their own page, Identity PSK.

Every attribute is defined at one of two levels, and the level decides where its value lives.

LevelValue setSuits
Group LevelOnce on the group, applied to every endpoint in itData that is uniform across the group: vendor ownership, site code, a policy tag, a maintenance window
Endpoint LevelOn each device, when it is added or editedData that differs per device: asset ID, end date, owner, a device key

The level is decided by which sub-tab you create the attribute from, and it is locked afterwards. The edit dialog shows it as a read-only Attribute Level field with the note “The level cannot be changed — remove the attribute and add it again.”

So an attribute is group managed or endpoint managed, never both. There is no override relationship between the levels and no case where a group value and an endpoint value compete for the same field. A group can manage any number of attributes at each level at the same time; the only either-or rule concerns Identity PSK.

Prerequisite — the attribute must exist in Cisco ISE first

Section titled “Prerequisite — the attribute must exist in Cisco ISE first”

Every attribute you define must already exist as an Endpoint Custom Attribute on your Cisco ISE deployment, under Administration → Identity Management → Endpoint Custom Attributes. The platform never creates it there.

Warning

Cisco ISE discards values for names it does not recognise, and returns no error while doing it. An attribute whose name does not match one on the ISE side will save on the platform, look correct in every view, and never reach the endpoint. Check the spelling against Cisco ISE before you rely on a value.

Managed Attributes tab with sub-tabs for Group Managed Custom Attributes and Endpoint Custom Attributes
Managed Attributes tab — one sub-tab per level, each with its own Add Attribute button.

Open the Context’s Configuration → Managed Attributes tab and pick the sub-tab for the level you want: Group Managed Custom Attributes or Endpoint Custom Attributes. Press Add Attribute there. The form has three sections.

  1. Attribute Name

    Exactly as it is spelled on the Cisco ISE side. Must start with a letter, may contain letters, digits, underscores and hyphens, and may be up to 64 characters. Unique within the Context, and immutable once created.

    Names beginning with ng are reserved for platform attributes and are rejected.

  2. ISE Type

    Must match the type defined in ISE, and is immutable once created:

    • String — any text value.
    • Integer — whole number.
    • Booleantrue / false.
    • Float — decimal number.
    • Long — big whole number.
    • IP Address — IPv4. IPv6 addresses are rejected.
    • Date — a date, with no time of day.
  3. Display Name

    Optional. Shown to readers instead of the raw attribute name, so asset-id can appear as Asset ID.

    This is the only label field. There is no free-text description on an attribute; descriptions live on the individual options of a dropdown.

Input decides the control a person gets, which is not the same thing as the ISE type. A field can be stored as a String in Cisco ISE and still be presented as a dropdown of four approved values.

InputWhat the user gets
TextFree text
IntegerWhole number
DecimalDecimal number
ToggleAn on/off switch, stored as true / false
IP AddressAn IPv4 field
DateA date picker, date only
DropdownA list of values you define
iPSK PSKA Wi-Fi key the platform generates and rotates

Not every pairing is valid. The ISE type constrains the inputs:

ISE TypeInputs allowed
StringAll eight
Integer, LongText, Integer, Dropdown
FloatText, Decimal, Dropdown
BooleanText, Toggle
IP AddressText, IP Address, Dropdown
DateText, Date, Dropdown

An iPSK PSK attribute must be typed String in Cisco ISE.

Required makes a value mandatory when a device is added. It is available on endpoint level attributes only, and never on a Toggle, which always carries a value, nor on a key, which the platform generates.

Note

Batch upload cannot carry attribute values. If a group uses batch adding, don’t mark its endpoint attributes Required.

Exposure decides what a Self-Service User sees. The attribute is always visible to you in the admin console regardless of this setting.

SettingIn the Self-Service portal
NoneNot shown. Admin-only
DisplayThe value is visible on the user’s devices, read-only
EditableThe user can also set the value when adding or editing their own devices

Editable requires an endpoint level attribute. On a group level attribute the option is disabled, with the note “Requires an endpoint level attribute — group level values are managed by admins.”

Two things must both be true before a Self-Service User sees an endpoint attribute: exposure is not None, and the group has opted in to the attribute.

Press Edit Options on a dropdown attribute. Each option carries a Value, a Description and an optional Icon. The dialog states the split plainly: “The stored value is exactly what is written to Cisco ISE — the description is what the user sees.”

That lets the stored value stay machine-friendly while the reader gets something meaningful. Values must be unique, non-empty and valid for the ISE type, and they are matched exactly, including case.

The platform seeds a single system attribute into every Context: Device Type, an endpoint level dropdown with a curated list of options and icons, Editable in Self-Service, and pre-selected on every group.

Device type used to be a fixed field in both portals. It is now an ordinary endpoint attribute driven by this definition, which is also why the icons in device lists come from the attribute’s options.

Its name, ISE type, level and input are fixed and it cannot be removed. Its options, its Required flag, its Display Name and its Self Service setting are yours to change. The ng prefix reservation exists so your own attributes can never collide with a platform one.

Remove an attribute with the action on its row. A definition still in use by a group is refused until you remove it from the groups first, and the system attribute cannot be removed at all.

Removing a definition stops the platform managing that attribute going forward. It does not clear the values previously written into ISE — the confirmation dialog says so.

AttributeLevelInputPurpose
vendor-ownerGroupTextName of the vendor managing the fleet; read by reports and SIEM
maintenance-windowGroupTextWhen it’s OK to reboot or re-configure
security-group-tagGroupDropdownSGT name ISE applies; drives microsegmentation
asset-idEndpointTextThe asset register’s identifier for this specific device
end-dateEndpointDateWhen the device should stop being allowed on
ownerEndpointTextWho is responsible for this device
vlan-idEitherInteger or DropdownVLAN assignment for MAB authorisation

Note

The platform never acts on a value. An end-date attribute expires nothing by itself. It becomes meaningful only through an authorization rule you write in Cisco ISE, for example one that admits a device only while its end date is in the future. The platform’s job is to keep the value accurate and in the right place.

Next