Managing tags for assets

This topic describes how to import and add tags for assets. When you add or import a tag, it is associated with an asset (SCAN HOST column on the Assets page), and not a target (Name column on the Assets page).

The Tags tab on the Administration page of TrueSight Vulnerability Management lets administrators perform the following actions:

• View a list of asset tag keys that have been created. If no asset tags have been imported, they can be added manually.

  Note

  The Tags tab also shows the tags that are associated with a combination of vulnerability and asset.

  The Assets page and Exception Management page shows only the tags that are associated with assets, not the tags that are associated with a combination of vulnerability and asset.

• Import lists of tags. Those lists must be in a comma-separated value (CSV) format, and they must use a predefined format.
• Manually add tags so that users can start associating them to their assets.

Formatting tag files

To be certain the CSV files you want to import are properly formatted, download a template file, as shown below.

Asset template

The asset template uses the following format:

Each tag (Tag Name & Value) is associated with an asset identified by the first three columns. Not all three columns are required. If you do want to provide value in one of the columns, leave the value cell blank and retain the column header. 

The following are valid combinations to identify an asset:

• Hostname and IP Address
• Hostname and Domain Name
• Hostname and IP Address and Domain Name

Values in the Tag Name and Tag Value columns are always needed.

If there are multiple values for a tag, separate them with semicolons.

Importing tags

When importing tags, remember the following basic concepts:

• If a tag associated with a combination of vulnerability and asset already exists in the system, you cannot import a tag with the same name and associate it with an asset.
• An import will not affect existing tags and their values if the new import does not include that tag. You can import the same tag file repeatedly without affecting the tags defined in your system.

• An import with a particular tag/value pair will overwrite the same tag/value pair if it already exists. For example, if a tag is called Owner and its current value is Betty and then you import the same tag with a value of Joe, the result is a tag called Owner and the value is Joe. 

  Note

  Starting from version 3.0.01, the result is a tag called Owner and its value is Betty, Joe.

• Tag keys are automatically converted to upper case. Tag key values can be mixed case. For example, "Oracle DB" and "oracle DB" are considered to be the same value.
• Each tag name or tag value in the import file must be a maximum of 255 characters. 
• A CSV file used to import tag data can use UTF-8 encoding.

When you import tags, you can monitor the progress of the import with the Activity Status window.

Sometimes a tag import may be only partially completed. If any lines in the CSV file are formatted improperly, those lines are skipped during the import while valid lines continue to be imported. In the Activity Status window, the More Information message for an import provides detailed error information about invalid lines. The Activity Status window is the only source of information about CSV errors encountered during an import.

To import tags

1. Format the list of tags to import according to the template file you can download from the Tags tab (described above).
2. As an endpoint administrator, at top right, click the drop-down menu by your user name. Then, select Administration. 
   The Administration page opens.
3. Click the Tags tab.  
4. Click Select .csv File to Import and then select the type of tags to import. Currently, the only choice is Assets.
5. Navigate to the file and select it.  

Manually adding tags

Typically, you add tags by importing them, but you can also manually add tags so that users can start associating them to their assets. In this procedure, you add a tag key. After you add the tag key, you can assign a value to it on the Assets page.

To manually add tags

1. As an endpoint manager, click the drop-down menu by your user name (at top right). Then, select Administration. 
   The Administration page opens.
2. Click the Tags tab. 

3. Do one of the following:

   • If this is the first time you have manually added tag keys, click Add Tags Manually.
   • If you have manually added tag keys previously, click +Add Key.
     The Add Key dialog opens.
     
     
     
4. For Key, enter the name of the tag key you are adding.
   Tag keys are automatically converted to upper case.
5. Do one of the following:
   • Click Save and Close to save the tag key.
   • Click Save and Add More to save the tag key and keep the dialog box open to add another tag.
6. Click OK.