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
- Click Inventory in the top navigation
- Toggle between Hardware and Software tabs
- 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:
| Property | Description | Example |
|---|---|---|
| Name | Device display name | "Web Server 01" |
| Device Type | Category | "Virtual Machine" |
| Manufacturer | Hardware vendor | "Dell", "AWS" |
| Model | Hardware model | "PowerEdge R640", "t3.medium" |
| Serial Number | Unique identifier | "SN-12345678" |
| IP Address | Network address | "10.0.1.100" |
| MAC Address | Physical address | "00:1A:2B:3C:4D:5E" |
| Hostname | DNS name | "web01.example.com" |
| Location | Physical/logical location | "AWS us-east-1a" |
| Status | Current status | Active, Inactive, Maintenance |
| Tags | Custom labels | "Production", "PCI-Scope" |
Editing Device Properties
- Click on a device in the inventory
- Edit properties in the detail panel
- Changes sync to the topology automatically
Software Inventory
Adding Software to Devices
- Select a device in the inventory
- Click Add Software
- Fill in software details
- Save
Software Properties
| Property | Description | Example |
|---|---|---|
| Software Name | Application name | "Apache HTTP Server" |
| Version | Current version | "2.4.52" |
| Vendor | Software provider | "Apache Foundation" |
| License | License type | "Apache 2.0" |
| Purpose | What it's used for | "Web server" |
| Install Date | When installed | "2024-01-15" |
Common Software Categories
- Operating Systems
- Web Servers
- Application Servers
- Databases
- Security Tools
- Monitoring Agents
- Middleware
Bulk Operations
Import from CSV
- Click Import button
- Download the CSV template
- Fill in your device data
- Upload the completed CSV
- 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
- Click Export button
- Choose fields to include
- 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
| Status | Meaning | Icon |
|---|---|---|
| Active | Currently in use | Green |
| Inactive | Not currently in use | Gray |
| Maintenance | Under maintenance | Yellow |
| Decommissioned | No longer in use | Red |
Bulk Status Update
- Select multiple devices
- Click Set Status
- Choose new status
- 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
- Select device(s)
- Click Add Tag
- Enter tag name or select existing
- 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:
- Verify all devices are listed
- Check that statuses are current
- Ensure IP addresses are accurate
- Add any missing software
Linking Devices to Controls
Device-Control Associations
Link devices to specific controls:
- Select a device
- Click Link Controls
- Select applicable controls
- These associations appear in control narratives
Common Associations
| Device Type | Common Controls |
|---|---|
| Firewalls | SC-7, AC-4, SI-4 |
| Servers | CM-6, SI-2, AU-2 |
| Databases | SC-28, AC-3, AU-2 |
| Load Balancers | SC-7, SC-5 |
| Auth Systems | IA-2, IA-5, AC-2 |
Best Practices
Maintaining Accurate Inventory
- Update regularly - Sync with actual infrastructure
- Use consistent naming - Follow naming conventions
- Include all devices - Don't forget supporting systems
- Track changes - Note when devices are added/removed
For SSP Quality
- Complete properties - Fill in all relevant fields
- Accurate IPs - Verify network information
- Current status - Update decommissioned devices
- 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:
- Click Add Device in inventory
- Fill in properties
- 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