Custom Attributes: Overview

Summary: An introduction to custom attributes, a feature that allows your organization to add its own properties to groups, assets, and findings

The new custom attributes feature allows users to easily add additional properties to assets, findings, and groups. The feature will allow you to create up to 20 custom attributes to the Hosts, Host Findings, Applications, Application Findings, and Groups list views. You can define a custom attribute to be one of the following data types:

You can create custom attributes from the Client Settings page.

The platform deeply integrates custom attributes into the list views. You can filter and group your data by custom attributes and add them as columns to list views. As you can turn filters, columns, and Group By into views, exports, and custom widgets, you can also bring custom attributes into dashboards and reporting. You can also use filters based on custom attributes when defining automation rules.

You can choose to propagate (cascade) custom attributes down to lower-level models. By propagating custom attributes, you will make those custom attributes available within additional list views.

To propagate data for custom attributes, you configure this behavior when creating a custom attribute. You can propagate host attributes down to host findings and application attributes down to application findings. You can also propagate custom attributes on the Groups page down to assets and findings within the group.

Each data type has specific requirements and limitations. For more information, see Custom Attribute Data Types.

You must go to the Client Settings page to create new custom attributes. For more information, visit Creating a Custom Attribute.

To assign custom attributes to groups, assets, or findings, you will need additional privileges specific to that list view. For more information on assigning or modifying values, visit Editing Custom Attributes.

For attributes other than those of the Long Text type, you can add the custom attributes as columns to the list view. To do this, search for columns by the user-defined name.

All custom attributes columns are optional within the System Defaults view. You must add the custom attribute columns to your default view if you want to see them when you first log into the platform.

You can also make custom attribute columns part of the standard view for new users by configuring the Client Defaults for a page.

List type columns behave like other list columns within the platform such as Tags and Groups. You can click on +More to see additional items.

You can view custom attributes from the detail pane. The detail pane organizes custom attributes by list view. Custom attributes specific to the current list view come first. After these custom attributes, you will see propagated attributes.

By clicking on the icon highlighted in red, you can jump to the Custom Attributes section in the detail pane.

You can filter on custom attributes of any data type. Note that if you filter on another data type besides URL, String, List of URL, or List of String, the platform will not provide suggestions after you enter a value into the search box.

The platform automatically enables Group By for all custom attribute types except Long Text.

The platform breaks down elements of lists into individual Group By terms.

The first two columns of the Group By for States would look like this:

When you export a custom attribute, the name of the exportable field contains both the user-defined name and the attribute ID.

If you propagate an asset custom attribute to findings, you can add the custom attribute as a column at the finding level. In addition, you can also filter on that custom attribute, perform a Group By, export it, or view assigned values in the Finding Details.

Some limitations exist on propagated group custom attributes. Within list views other than Groups, you lack the ability to add a group custom attribute as a column. Additionally, you can only view group custom attributes in the Host Details or Application Details. Since assets can have membership in more than one group, the detail pane shows the custom attribute values for each individual group that the asset is a member of.

To make a group custom attribute show up within the Host or Application Details, you must explicitly propagate the group custom attribute to assets.

When merging assets with custom attributes, the destination asset always takes precedence. The destination asset only inherits values for unset custom attributes from the source asset. If you choose to merge multiple source assets into the destination asset, the system will pick which source asset sets the value for the custom attribute at random.