​

How to import assets from files

1. Go to the Assets page
   • Click on Assets from the navigation menu, then select Assets.

2. Import assets from a file
   • Click on the Import Assets button at the top right corner

3. From the dialog that appears, you can download the templates and fill them in with your assets. The template is provided into three formats: XLSX, XLS and CSV

4. Upload the file containing the assets and proceed with validation
   • Click the Validate option

5. There might be a case that there will be name conflicts during imports. In that case, you will need to provide the course of actions for handling the conflicts. Two possible options exists:
   • Create copies: in that case, the assets will be created with the suffix “_copy” appended to their name.
   • Replace assets: the conflicted assets will be replaced by the ones contained in the uploaded file

6. You can see more details about the conflicts by expanding the top section of the conflict dialog box

7. The next step is to review and import the assets. If there are any issues with the data, you will be able to see the errors. In that case, the import cannot continue; all the errors will need to be fixed. You can expand the relevant sections to see more details about the errors.

8. If no errors exists, you will be able to import assets.

​

How to populate the assets file from the template

The template file contains the following fields:

• Name: this field is mandatory. Asset names are unique per asset type.
• Description: provides a description of your asset.
• Type: the asset type. The spreadsheet templates list the built-in asset types as suggested values. You can select one of these values or enter the display name or type name of any available asset type, including custom asset types. To define a new asset type, see How to create a custom asset type.
• Labels: this field is optional. It is a comma-separated list of labels that will be assigned to the asset.
• Domain name: optional, denotes the domain name assigned to the asset.
• IPv4: optional, a comma-separated list of the IPv4 address(es) assigned to the asset.
• IPv6: optional, a comma-separated list of the IPv6 address(es) assigned to the asset.
• URL: optional, a comma-separated list of the URL(s) assigned to the asset.
• Mac Address: optional, a comma-separated list of the MAC address(es) assigned to the asset.
• Vlan: optional, a comma-separated list of the VLAN tag(s) assigned to the asset.
• Port: optional, denotes the port where the asset listens to.
• State: optional, denotes the current state of the asset and can be: “Active”, “Broken”, “Don’t show”, “In repair”, “Non-active”, “Sold”, “Spare”, “Stock”, “Stolen”.
• Notes: optional, additional notes for that asset.

​

Importing Assets from Wazuh

Connect your Wazuh deployment to Cymph and bring its monitored endpoints straight into your asset inventory — no manual data entry required.

​

What gets imported

Cymph reads your Wazuh agents and turns each one into a host asset in your workspace. For every agent you import, Cymph automatically captures:

• Its hostname
• The host’s operating system and architecture
• Its IPv4 and IPv6 addresses
• When the agent last reported

Each imported asset is tagged as coming from Wazuh, so you can always tell where it originated and re-run the import later without creating duplicates.

​

How it works

1. Connect your Wazuh integration to the workspace (one-time setup). See Wazuh.
2. Pick the agents you want to bring in.
3. Cymph pulls them from Wazuh and adds them to your asset inventory.

If an asset with the same name already exists, Cymph keeps both by importing the new one under a clearly marked name rather than overwriting your existing data.

​

Importing Assets from Nessus

Upload a Nessus scan report and let Cymph turn the discovered hosts and services into assets in your inventory.

​

What gets imported

From a Nessus report (.nessus file), Cymph creates:

• One asset per scanned host, with its operating system, IP and MAC addresses, and hostname.
• An asset for each service Nessus detected on that host — for example web servers, databases, DNS servers, mail servers, file servers, remote-access services, printers, and identity services. Where the report is specific enough, Cymph also records the product (such as MySQL, PostgreSQL, or Tomcat).

This means a single host can produce several assets: the host itself plus one for each service running on it.

​

How it works

1. Upload your Nessus scan report.
2. Cymph reads it and shows you what it found, sorted into assets that are ready to import, ones that need attention, and any that already exist in your inventory.
3. Review the results and confirm the import.

In case of name conflicts, you will be asked how to resolve them: either by replacing the existing assets or make the newly imported assets have a unique name.

​

Importing Assets from Azure

Connect your Azure environment to Cymph and import your cloud resources directly into your asset inventory, keeping Cymph in sync with what you run in Azure.

​

What gets imported

Cymph pulls resources from your Azure subscriptions and maps each one to the matching Cymph asset type — virtual machines and scale sets, containers and app platforms, databases and caches, storage accounts and key vaults, and Entra ID identities. For the full list, see Assets.

​

How it works

1. Connect your Azure integration to the workspace (one-time setup).
2. Choose the resources you want to bring in.
3. Cymph imports them and maps each one to the matching Cymph asset type.

​

Importing Assets from AWS

Connect your AWS environment to Cymph and import your cloud resources directly into your asset inventory, keeping Cymph in sync with what you run in AWS.

​

What gets imported

Cymph pulls resources from your AWS account and maps each one to the matching Cymph asset type — EC2 and Auto Scaling, serverless and container services, databases, S3 buckets, load balancers, secrets and KMS keys, and IAM identities. For the full list, see Assets.

​

How it works

1. Connect your AWS integration to the workspace (one-time setup).
2. Choose the resources you want to bring in.
3. Cymph imports them and maps each one to the matching Cymph asset type.

​

How to create an asset manually

1. Go to the Assets page.
   • Click on Assets from the navigation menu, then select Assets.
2. Add a New Asset.
   • Click on the Add New Asset Manually button at the top-right corner.

3. Choose an asset type.

• Asset types are grouped into categories such as People and Places, Software Assets, Hardware Assets and Cloud Services.
• Select the desired category
• Click on the radio button next to the desired type to select it.
• Click Next once the desired type is selected.

4. Create the asset.

• Enter the asset details. Fields marked with an asterisk (*) are mandatory.
• Provide the Access Type. By default, the access status of the asset is Private.
  • Private access means the asset is only visible to you.
  • Shared access means the asset is visible to you and your organisation members.
  • Public access means the asset is visible to all Cymph users.
• Provide a set of labels for the asset (optional)
• Location information includes details about the asset, like name, description, network information and geolocation information. You can add multiple location information fields.
• Contact information includes details about the people that need to be contacted for this assets
• Account information lists information about username and roles that are related to this asset.
• Provide a state for the asset (optional). The state can be: active, broken, don’t show, in-repair, non-active, sold, spare, stock, stolen
• Criticality: define the criticality level of the asset. Possible values are: Low, Standard, High and Critical
• Recovery time objective defines the RTO time in minutes
• Recovery point objective defines the RPO time in minutes
• Environment includes a references to the environment type the asset is used in: Test, Dev, Staging or Production
• Owned by: one or multiple asset owners. Owners are accountable for the asset
• Managed by: one or multiple asset managers.
• Depends on: a list of assets that this asset depends one
• Used by: a list of assets or team that this asset is used by
• Runs on / Hosted by: a list of assets that are used to run or host this specific asset
• Part of / Parent: the parent asset
• Provide optional notes
• Click Create.

​

How to update an asset

1. Go to the Agents page.
   • Click on Assets from the navigation menu, then select Assets.
2. Click the Edit icon next to the asset that needs update.

3. Update asset details.
   • Click the Update button once all information is updated.
4. The list of assets is automatically updated.

​

How to delete an asset

1. Go to the Agents page.
   • Click on Assets from the navigation menu, then select Assets.
2. Delete the asset.
   • Click the Delete icon next to the asset you want to delete.

3. Confirm deletion.

• Click the Delete button on the confirmation dialog.

4. The list of assets is automatically updated.

​

How to duplicate an asset

1. Go to the Agents page.
   • Click on Assets from the navigation menu, then select Assets.
2. Click the triple dot icon ⫶ to open the actions menu for the playbook you want to duplicate.

3. Select the Duplicate action
4. Duplicate the asset.
   • Provide a name for the asset. By default the name of the source asset will be used followed up by the “(copy)” suffix.
   • Click on the Duplicate button.

5. The list of assets will be automatically updated and show the new asset.

​

How to share an asset

1. Go to the Assets page.
   • Click on Assets from the navigation menu, then select Assets.
2. Click the triple dot icon ⫶ to open the actions menu for the playbook you want to duplicate.
3. Select the Share option.
4. Choose the access type.
   • From the dialog box that appears, select the share mode for your asset.
   • By selecting an option, the access type is changed automatically.

​

How to export an asset

1. Go to the Assets page.
   • Click on Assets from the navigation menu, then select Assets.
2. Click the triple dot icon ⫶ to open the actions menu for the playbook you want to duplicate.
3. Export the asset.
   • Click the Export option.
4. The asset will exported as a comma-separated CSV file, named after the asset name and a .csv suffix, with the following schema:

Name,Type,Description,Labels,Domain Name,IPv4,IPv6,URL,Mac Address,Vlan,Port,State,Notes

​

How to view supported asset types

1. Go to the Asset Types page
   • Click on Assets from the navigation menu, then select Asset Types

2. Browse and search the available asset types, which are organised in two tabs:
   • Built-in types: the asset types provided by Cymph and available in every workspace. They are grouped into categories such as People and Places, Software Assets, Hardware Assets and Cloud Services, and cannot be modified or deleted.
   • Custom types: the asset types defined for your workspace, as described below.

​

How to create a custom asset type

Custom asset types allow you to represent assets that are specific to your environment, for example a Threat Intelligence Feed.

1. Go to Assets → Asset Types
2. Select the Custom types tab and click New asset type
3. Enter a Name. This is the display name used throughout Cymph.
4. Review the Type name. It is generated automatically from the name and can be modified if required. The type name is the permanent identifier of the asset type and is used when importing assets. It may contain only lowercase letters, numbers and hyphens. If the type name is already in use, a message is displayed below the field.
5. Optionally, enter a Description
6. Click Create

The name and the type name are limited to 60 characters each, and the description to 240 characters. Each type name must be unique and cannot match the type name of a built-in asset type. The availability of a custom asset type depends on who owns the workspace in which it is created:

• Individual workspace: the asset type is available only in that individual workspace.
• Organisation workspace: the asset type belongs to the organisation and is available in all of its workspaces.
• External organisation workspace: members from other organisations can use that organisation’s custom asset types within the workspace, in addition to the built-in asset types.

​

How to edit a custom asset type

1. Go to Assets → Asset Types and select the Custom types tab
2. Click Edit on the asset type
3. Update the Name or the Description
4. Click Save

The type name cannot be modified after the asset type has been created. This ensures that existing imports and references remain valid.

​

How to delete a custom asset type

1. Go to Assets → Asset Types and select the Custom types tab
2. Click Delete on the asset type
3. Click Delete to confirm

An asset type cannot be deleted while it is assigned to one or more assets. Reassign or delete those assets before deleting the asset type.

​

Ownership model

An asset imported from a live system is owned by that system: its name, type and other fields are refreshed from the source, while the labels, description and notes you add in Cymph are yours and are never overwritten. The same rule governs scheduled syncs — see the Sync Center.