Skip to main content

Configuration Items

Configuration items (CIs) are the core records in CMDB. Every tracked asset — workstations, servers, network devices, mobile devices, printers, cloud resources, and software licenses — is a CI with a full set of standard and custom fields.

CI Types

CI types define the schema for different asset categories. Each type can have custom fields beyond the standard CI fields. Manage CI types in CMDB Admin.

Default CI Types

CMDB ships with system-managed CI types. You can also create custom types with fields specific to your environment.

Custom Fields

Each CI type can define additional attributes with these field types:

Field TypeDescription
TextSingle-line text input
TextareaMulti-line text input
NumberNumeric value
BooleanYes/no toggle
DateDate picker
SelectSingle choice from predefined options
MultiselectMultiple choices from predefined options
URLClickable link
PasswordEncrypted field — stored with HSM-backed AES-256-GCM encryption
⚠️Password Fields:

Password-type custom attributes are encrypted at rest with a per-CI encryption key (DEK) wrapped by an HSM-backed master key (KEK). These fields are never exposed in list views — you must explicitly reveal them, which is audit-logged.

Standard CI Fields

Every CI has these fields regardless of type:

FieldDescription
NameDescriptive name for the asset
CI TypeCategory (Server, Workstation, etc.)
CompanyClient organization this asset belongs to
Statusactive, inactive, maintenance, decommissioned, planned
Criticalitycritical, high, medium, low — affects Defend alert severity
Environmentproduction, staging, development, test, dr
HostnameNetwork hostname
Primary IPPrimary IP address
LocationPhysical or logical location
VendorHardware manufacturer
ModelHardware model
Serial NumberManufacturer serial number
Asset TagInternal asset tag
Purchase DateWhen the asset was purchased
Warranty ExpiresWarranty expiration date
End of LifeVendor end-of-life date
Technical OwnerTeam member responsible for technical management
Business OwnerTeam member responsible from a business perspective
DescriptionFree-text description
TagsSearchable tags for categorization
RMM Device IDLink to RMM-enrolled device (set automatically by discovery)

Creating a CI

  1. Navigate to Config Items in the sidebar
  2. Click Add Configuration Item
  3. Select a CI Type — this determines which custom fields appear
  4. Fill in the required fields: name, company, status
  5. Add hardware, network, and ownership details as applicable
  6. Complete any custom attributes for the selected type
  7. Click Save

Searching and Filtering

The CI list supports:

  • Text search — searches the name field (CONTAINS match)
  • Status filter — show only CIs in a specific status
  • CI Type filter — show only CIs of a specific type
  • Criticality filter — show only CIs at a specific criticality level
  • Company filter — show only CIs for a specific client

Results are paginated (up to 500 per page) with a hasMore indicator for additional pages.

Bulk Operations

Select multiple CIs in the list view to perform bulk actions:

  • Bulk status change — move selected CIs to a new status
  • Bulk criticality assignment — set criticality level for multiple assets at once
  • Bulk tagging — add or remove tags from selected CIs
  • Bulk delete — remove selected CIs (soft delete)

CI Detail View

Click any CI to open its detail page, which shows:

  • Summary — all standard fields with inline editing
  • Hardware — vendor, model, serial, asset tag, purchase/warranty dates
  • Custom Attributes — type-specific fields (with reveal button for encrypted fields)
  • Tags — editable tag list
  • Related Documents — documents linked to this CI
  • Relationships — other CIs this asset depends on or hosts
  • Passwords — credentials associated with this CI
  • Change History — audit log of all modifications

Lifecycle States

CIs progress through lifecycle states:

StatusMeaning
PlannedAsset is approved but not yet deployed
ActiveAsset is in production use
MaintenanceAsset is temporarily offline for maintenance
InactiveAsset is powered down or not in use but retained
DecommissionedAsset has been permanently removed from service
💡

Use the Warranty Report to identify assets approaching end-of-life or warranty expiration. Plan replacements before warranties expire to avoid unbudgeted repairs.

Next Steps