Device Inventory

Complinist automatically generates hardware and software inventories from your topology. This guide explains how to manage your device inventory for compliance documentation.

Overview

The device inventory tracks:

  • Hardware - Physical and virtual devices in your system
  • Software - Applications and services running on devices
  • Properties - IP addresses, hostnames, status, and more

This inventory becomes part of your SSP documentation.

Accessing the Inventory

  1. Click Inventory in the top navigation
  2. Toggle between Hardware and Software tabs
  3. Use search and filters to find specific items

Hardware Inventory

Auto-Generated from Topology

Every device on your canvas automatically appears in the inventory:

  • Servers
  • Firewalls
  • Routers and switches
  • Load balancers
  • Cloud resources
  • Workstations
  • All other devices

Hardware Properties

For each device, you can track:

PropertyDescriptionExample
NameDevice display name"Web Server 01"
Device TypeCategory"Virtual Machine"
ManufacturerHardware vendor"Dell", "AWS"
ModelHardware model"PowerEdge R640", "t3.medium"
Serial NumberUnique identifier"SN-12345678"
IP AddressNetwork address"10.0.1.100"
MAC AddressPhysical address"00:1A:2B:3C:4D:5E"
HostnameDNS name"web01.example.com"
LocationPhysical/logical location"AWS us-east-1a"
StatusCurrent statusActive, Inactive, Maintenance
TagsCustom labels"Production", "PCI-Scope"

Editing Device Properties

  1. Click on a device in the inventory
  2. Edit properties in the detail panel
  3. Changes sync to the topology automatically

Software Inventory

Adding Software to Devices

  1. Select a device in the inventory
  2. Click Add Software
  3. Fill in software details
  4. Save

Software Properties

PropertyDescriptionExample
Software NameApplication name"Apache HTTP Server"
VersionCurrent version"2.4.52"
VendorSoftware provider"Apache Foundation"
LicenseLicense type"Apache 2.0"
PurposeWhat it's used for"Web server"
Install DateWhen installed"2024-01-15"

Common Software Categories

  • Operating Systems
  • Web Servers
  • Application Servers
  • Databases
  • Security Tools
  • Monitoring Agents
  • Middleware

Bulk Operations

Import from CSV

  1. Click Import button
  2. Download the CSV template
  3. Fill in your device data
  4. Upload the completed CSV
  5. Review and confirm import

CSV Template Format

name,device_type,ip_address,hostname,status,manufacturer,model
Web Server 01,virtual-machine,10.0.1.100,web01.example.com,Active,AWS,t3.medium
Database Server,sql-database,10.0.2.50,db01.example.com,Active,AWS,db.r5.large
Firewall,firewall,10.0.0.1,fw01.example.com,Active,Palo Alto,PA-3220

Export to CSV

  1. Click Export button
  2. Choose fields to include
  3. Download CSV file

Inventory Views

Table View

  • Sortable columns
  • Filterable by any property
  • Bulk selection for operations

Grid View

  • Visual card layout
  • Quick status overview
  • Device type icons

Filters

Filter inventory by:

  • Device type
  • Status (Active/Inactive/Maintenance)
  • Tags
  • Custom properties
  • Search by name

Status Management

Device Statuses

StatusMeaningIcon
ActiveCurrently in useGreen
InactiveNot currently in useGray
MaintenanceUnder maintenanceYellow
DecommissionedNo longer in useRed

Bulk Status Update

  1. Select multiple devices
  2. Click Set Status
  3. Choose new status
  4. Confirm change

Tags and Organization

Using Tags

Tags help organize your inventory:

  • Environment: Production, Development, Test
  • Compliance: PCI-Scope, HIPAA, CUI
  • Team: IT-Ops, Security, Development
  • Location: DC1, AWS, Azure

Adding Tags

  1. Select device(s)
  2. Click Add Tag
  3. Enter tag name or select existing
  4. Save

Inventory in SSP

Automatic Inclusion

When you generate an SSP, the inventory is automatically included:

  • Hardware inventory table
  • Software inventory table
  • Device-to-control mappings

Review Before Generation

Before generating SSP:

  1. Verify all devices are listed
  2. Check that statuses are current
  3. Ensure IP addresses are accurate
  4. Add any missing software

Linking Devices to Controls

Device-Control Associations

Link devices to specific controls:

  1. Select a device
  2. Click Link Controls
  3. Select applicable controls
  4. These associations appear in control narratives

Common Associations

Device TypeCommon Controls
FirewallsSC-7, AC-4, SI-4
ServersCM-6, SI-2, AU-2
DatabasesSC-28, AC-3, AU-2
Load BalancersSC-7, SC-5
Auth SystemsIA-2, IA-5, AC-2

Best Practices

Maintaining Accurate Inventory

  1. Update regularly - Sync with actual infrastructure
  2. Use consistent naming - Follow naming conventions
  3. Include all devices - Don't forget supporting systems
  4. Track changes - Note when devices are added/removed

For SSP Quality

  1. Complete properties - Fill in all relevant fields
  2. Accurate IPs - Verify network information
  3. Current status - Update decommissioned devices
  4. Software inventory - List key applications

Sync with Topology

Automatic Sync

Changes in topology reflect in inventory:

  • Adding a device - Appears in inventory
  • Removing a device - Removed from inventory
  • Editing properties - Updates everywhere

Manual Additions

You can add inventory items not in topology:

  1. Click Add Device in inventory
  2. Fill in properties
  3. Device is inventory-only (not on canvas)

This is useful for supporting infrastructure, shared services, and external dependencies.

Troubleshooting

Device Not in Inventory

  • Ensure device is saved in topology
  • Refresh the inventory view
  • Check if filters are hiding it

Data Not Syncing

  • Save your project
  • Refresh the application
  • Check for error messages

Import Failing

  • Verify CSV format matches template
  • Check for special characters
  • Ensure required fields are present