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.
  • 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.
  • 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:

Hostname

IP Address 

Domain Name

Tag Name

Tag Value

vl-pun-01

xxx.xxx.xxx.xxx

calbro.com

Application

Banking

vl-hou-01

xxx.xxx.xxx.xxx

calbro.com

Owner

Joe; Betty

vw-aus-01

xxx.xxx.xxx.xxx

calbro.com

Services

Facilities

Each tag (Tag Name & Tag Value) is associated with an asset identified by the first three columns. Not all three columns are mandatory. 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, IP Address, and Domain Name

Values in the Tag Name and Tag Value columns are mandatory.

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

Note

If a tag value contains double quotes, escape the double quote with another double quote and enclose the entire tag values string within double quotes. For example, the following tag values:

Server "DELETED" 1; Server 2

Should be added as:

"Server ""DELETED"" 1; Server 2"

Importing tags

When importing tags, remember the following basic concepts:

  • 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.
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Gerad Cruz

    This does not seem to be true: Each tag (Tag Name & Tag Value) is associated with an asset identified by the first three columns. Not all three columns are mandatory. The following are valid combinations to identify an asset:

    Hostname and IP Address Hostname and Domain Name Hostname, IP Address, and Domain Name

    When importing tags I get this error:

    Description: Failed to import records from testEnvWindowsFailed.csv file - Error parsing the file - Missing column headers DOMAINNAME

    Mar 12, 2019 01:01
    1. Sulekha Gulati

      Thank you Cruz for bringing it to our attention. If we do not want to provide value in any column, we need to leave the cell blank and retain the column header. I think, you have deleted the column header.

      To clarify this guideline, I have inserted the following statement:

      If you do want to provide value in one of the columns, leave the value cell blank and retain the column header. 

      Please let me know if the changes are sufficient and clear.

      Looking forward to more suggestions.




      Mar 13, 2019 02:31