Device Actions

After creating queries and investigating devices and their adherence to policies, you can perform actions on a single selected device or in bulk on selected devices:

1. On the Devices page, select one or multiple device checkboxes. When at least one device is selected, the Actions button is displayed above the query results table.
2. To perform an action, click Actions and then click the desired action.

Axonius supports the following device actions:

Tag

Use tags to assign context to your assets for granular filters and queries. Apply new or existing tags to the selected devices. The list of selected tags is applied to all selected devices. Hence, tagging may result in the removal of existing tags from one or from several of the selected devices.

• Partial tag indicator is displayed when some but not all of the selected devices are tagged.
• New, checked, partial and unchecked tags are sorted and displayed in different sections. Displayed from top to bottom are: newly created tags, checked tags, partial tags, and unchecked tags.
• "New" is displayed when you add new tags.

Adding Tags to Devices

1. Select one or more devices; the Action menu is enabled.

2. From the Actions menu choose Tag; the Tag Devices dialog opens.

3. Either select an existing tag, or add a new tag.
4. To add a new tag, enter the tag name and select Add New.

5. You can set a color for the tag. From the color drop-down select a color for the tag background. The default background color is white.
6. Choose Save.

The new tag name is displayed, with a label New next to it.
You can also add an automatic expiration date for the tags. Learn more about Setting Automatic Expiration Dates for Tags.

Setting Colors for Tags

You can set a colors for the tag, change colors, and remove a selected color.
To work with colors

1. Select a device.
2. From the Action drop-down choose Tag.

Adding a color:
From the color drop-down select a color for the tag background. The default background color is white. Choose Save

Changing the color of a tag:

From the color drop-down next to the relevant tag choose a new color and choose Save.

Removing the Color from a Tag:

From the color drop-down next to the relevant tag choose the white background and choose Save.

Setting an Automatic Expiration Date for Tags

You can set an automatic expiration date for a tag or a group of tags. In this way you can add a tag to an asset for a defined period of time; once the defined time ends, the tag is automatically removed. This can be useful for instance, if you have a system that cannot be patched for a specific period of time. You can create a saved query that will exclude this specific tag. As a result, tagged assets will not be included in reports and dashboards using that saved query for the set time, until the tag expires.

1. Select one or more devices.
2. From the actions menu choose Tag; Tag Devices opens.
3. Choose an existing tag name, or click Add New to create a new one.
4. Click Add Expiration Date, a context menu opens.

5. Select Specific Date, or Days From Now

Setting a Specific Date

1. A date picker opens
2. Choose a date.

Expires on now appears next to the Tag.

3. Choose Save.
   Setting Days From Now

4. Select Days From Now; the date calculator opens.

2. Select the number of days from now for the tag to expire. The date below changes accordingly.

3. Choose Save.

Deleting an Expiration Date

You can delete an expiration date.

1. Select one or more devices.
2. From the actions menu choose Tag.
3. Choose Delete Expiration Date.

Changing an Expiration Date

You can change an expiration date

1. Select one or more devices
2. From the actions menu choose Tag.
3. Choose Edit Expiration Date.

4. The date menu opens. Set a new date as required.

Viewing Information About Tags

Add columns to display information about Tags on the Devices page.
Tags

1. Tags Metadata - complex field with the name of the tag, the date it was created and the date the tag was last updated.
2. Tags Metadata: Name - the tag name.
3. Tags Metadate: Created On - the date the tag was created.
4. Tags Metadata: Last Updated - the date the tag was last updated.

The Devices page shows information about when tags were created and updated.

Auto-Expiring Tags

1. Auto-Expiring Tags - complex field with all auto expiring tag names and their expiration date.
2. Auto-Expiring Tags: Name - the names of the auto-expiring tags
3. Auto-Expiring Tags: Expiration Date - the expiration dates of the auto-expiring tags.

The Devices page then shows the list of tags that you have on your system, and information about expiration dates. A device may have more than one tag when each tag has a different expiration date.

Mouse over the Auto-Expiring Tags column to see when each tag on a device expires.

View more information about tags on your system on the Device Profile Page.

Clearing Tags from Devices

You can clear or delete tags from devices.
To delete tags from devices

1. Select one or more devices.

2. From the Actions menu choose Tag; Tag Devices opens.

3. The tags on the device are shown as selected.
   

4. Clear the checkbox and choose Save. The tags are now removed from the selected devices

Delete

Delete selected devices from Axonius. Deleted devices may be added again to Axonius if they are discovered in any future discovery cycle.

Link Devices

Manually correlate at least two device records and consolidate their details into a single device.

Unlink Devices

Unlink and break the different device adapter sources into several separate devices, with each individual entry referring to data received from a single adapter. For example, if a device has been correlated from three different adapters, unlinking that device will result in three different unlinked devices.

Enforce - Create New Enforcement

Create a new enforcement set from the Devices page with a Main Action that will run on the entities you selected ('custom selection').
When you select this option, a drawer is opened that lets you configure the following:

1. Enforcement set name.
2. Main Action - Select an action from the Action Library, to be performed when the enforcement set is executed.

Once configured, click Save and Run to save the enforcement set and to generate an enforcement task that will run on the entities you have selected ('custom selection').

For more details, see Creating New Enforcement Sets.

Enforce - Use Existing Enforcement

Select and run one of the enforcement sets that is already configured in the system.
For more details, see Enforcement Center Page

Filter out from Query Results

Filter out the selected devices from the query results. Once filtered out, the Query Wizard will add a new Filtered out from query result line. Click Clear to restore the filtered out devices.

Add Custom Field

You can add custom fields to one or more devices.

1. Click Add custom fields, the Add Custom Fields dialog opens.
   

2. Click in the field drop down box. You can either define a new custom field or set a custom value for a predefined field for the selected devices.

To Add a Custom Field to the System

1. Start typing in the Field box, if a field of that name already exists it will be displayed, otherwise set a name for the field, and then click Add Field.

   

2. Select a Type for the field, you can choose Boolean, Float, Integer, Date, String List String, List Float, List Integer or List Date.

3. Set a value in the Value field. The value is determined by the Type.

4. When you choose one of the list types, you can enter a list in the value field. Each item in the list is separated by a comma, a semi-colon or by clicking enter. You can also paste a comma separated list into the field.

5. Once you add a list of values, you can click on the x to remove it, or click on a value to edit it.

6. Click Add Field to add your new field to the device or devices that are selected.

Custom fields are marked with a user icon in the list of fields.

7. Continue adding fields as required.

Use the delete icon to remove custom fields.

Adding Dates

You can add one or more Dates as custom fields. This is useful for instance, to identify the first time an asset was non-compliant.
To add a date:

1. Start typing in the Field box, if a field of that name already exists it will be displayed, otherwise set a name for the field, and then click Add Field.

2. Select Date as the Type for the field

3. Click the Date Picker, and set a date. The date you set can be in the past or in the future.

4. Click Add Field to add your new field to the device or devices that are selected.

To Add a List of Dates

1. Select List Date as the Field type
2. Follow the steps in Adding Dates.
3. Click Add Date in the field, to add another date.
4. Click Add Field to add your new field to the device or devices that are selected.

Assigning a Custom Value to a Field

To assign a custom value to a predefined field in the system:

1. From the Field drop down box, choose a field. The type is pre-set (determined by the field itself).
2. From the Value drop-down box, assign a value, and click Add Field. You can also add lists of values, make sure the values are separated by commas.

Editing Fields

To edit a value in the Add Custom Fields:

1. Click in the Value field, and type the new value.
2. When you have finished adding or editing custom fields, click Save.

Managing and Viewing Custom Fields

1. The custom fields that you added now appear in the list of fields in the Query Wizard and on the Custom Data tab in the Adapter Connections tab on the Device Profile page.

2. You can manage custom fields that you added to the system from the Device Profile page.