​

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.
• Type: the asset type. The list of available asset types can be seen from the Asset Types page (navigate to Assets section and then choose Asset Types from the navigation sidebar).
• 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, denotes the VLAN information for the asset.
• Port: optional, denotes the port where the asset listens to.
• State: optional, denotes the IPv6 address assigned to the asset.
• Notes: optional, additional notes for that asset.

​

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 two categories, Peoples 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.
• Provide a state for the asset (optional). The state can be: active, broken, don’t show, in-repair, non-active, sold, spare, stock, stolen
• 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 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 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 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. 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:

id,name,date_added,last_updated,type_name,type_id,labels,share_status,contents