Managing tags

You can enrich the data associated with assets using tags. A tag is a key/value pair. For example, an asset tag could be called Owner and its values could be defined as various asset owners. Or, a tag could be called Application and its potential values could be a list of applications. Certain values could be applied to an asset that supports the related applications.  

The Tags tab on the Administration page of SecOps Response 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.
  • 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.

This topic contains the following sections:

 If you are logged in to SecOps Response, you can take an interactive self-guided tour of importing tag files .  

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

hostname1

xxx.xxx.xxx.xxx

xyz.com

KEY1

value1

hostname1

xxx.xxx.xxx.xxx

xyz.com

KEY1

value2; value3

hostname2

xxx.xxx.xxx.xxx

abc.com

KEY2

value4

Each tag (Tag Name & Value) is associated with an asset identified by the first three columns. Not all three columns are required. The following are valid combinations to identify an asset:

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

The Tag Name and Tag Value columns are always needed.

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

  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 New Key.
    • 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 open to add another tag.
  6. Click OK.





Was this page helpful? Yes No Submitting... Thank you

Comments