Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
id1198615612
Section
id1198615633
Section
background-color$lightGrayColor
id1198615611


In this Article:

Table of Contents
maxLevel3
minLevel3

Armor Security Services

The tables within the sections below provide context to the Product and Operation fields used in the Schedule Task form.

Table of Contents
maxLevel4
minLevel4


Section
id1198615623

Overview

The Toolbox is a self service tool accessing a combination of services that allows customers to remotely manage services on one or multiple Virtual Machines on an account. Below are how to steps for using the toolbox as well as descriptions of the services you can manage with the toolbox.

Users looking to deploy services at scale can use the Toolbox to schedule tasks for a fleet of assets in their environment.


Multimedia
nametoolbox final.mp4
width600
height300


How to Schedule a Task

Users can access the Toolbox in the Armor Management Portal (AMP) on the Toolbox screen. The Toolbox screen is in the Infrastructure section of AMP. For more information on the Toolbox screen, click here. Once a task has been scheduled, the page will list all pending and completed tasks. The Schedule Task button will be available at the top of the screen.

Image AddedImage Added


  1. Navigate to theToolboxscreen in AMP.
  2. ClickSchedule Task.
  3. Click theProductdrop-down and select the desired Armor Security Service.
  4. Click theOperationdrop-down and select the desired operation.
  5. If necessary, enter additional configuration parameters in theAdditional Configurationtext box.
  6. Enter a Task Name in theTask Namefield.
  7. ClickSchedule Future Dateto select the task date.
    1. Unless configured otherwise, all tasks will run at the next Agent Heartbeat (every 15 minutes).
  8. ClickSelect VMsbutton.
  9. Select the appropriate Virtual Machines using the check boxes.
  10. ClickSelect VMs.
  11. ClickSchedule Task.


Anchor
Asynchronous Security API Calls
Asynchronous Security API Calls
Asynchronous Security API Calls


Users may want to configure security services asynchronously so that security services can be activated without immediately triggering feedback. For some commands, users can use the flag async=true to queue these features as needed. The command async=true works for both Windows and Linux and should be placed at the end of the command line as shows in the example below:

Code Block
themeMidnight
Windows: C:\.armor\opt\armor.exe av on async=true
Linux: /opt/armor/armor av on async=true

The async flag can also be configured in the Armor Toolbox.


Review Task Results


Users can review the results of tasks run through the Armor Toolbox using the CLI Results tab of the Virtual Machines screen.


Security Services

Below are the Armor Security Services you can manage from the Armor Toolbox. Several operations can be run asynchronously to prevent immediate API feedback. For more information on the Async Flag, please see the documentation above.


Trend


Trend is the parent sub-agent for all Trend modules, including Malware Protection, File Integrity Monitoring, and Intrusion Prevention.

One of the features available in Agent 3.0 is Recommendation scans. Recommendation scans provide a good starting point for establishing a list of rules that you should implement. During a recommendation scan, the Armor Agent scans the operating system for installed applications, the Windows registry, open ports, and more.

In order to use Malware Protection, File Integrity Monitoring, and Intrusion Prevention, please install the Trend Sub-Agent. To take advantage of Recommendation scans, turn on Ongoing Recommendation scans in the Toolbox.

OperationDescriptionAsync Flag
trend installInstall Trend
trend uninstallUninstall Trend
trend statusAgent Status
trend ongoing-recommendation-scan onTurn On Ongoing Recommendation scanYes
trend ongoing-recommendation-scan offTurn Off Ongoing Recommendation scanYes
trend recommendation-scanSchedule a Recommendation ScanYes
trend set-recommendation-scan-intervalSet the Recommendation Scan IntervalYes

.

Malware Protection


The Armor Malware Protection service protects your Virtual Machines against file-based threats such as malware, viruses, and more.

To use this feature, select the Malware Protection product in the Toolbox and choose the "on" operation.

OperationDescriptionAsync Flag
av onTurn anti-malware protection onYes
av offTurn anti-malware protection offYes.
av statusReports status of module from subagent


File Integrity Monitoring


The Armor File Integrity Monitoring service detects changes to files and critical system areas (e.g. Windows registry) that could indicate suspicious activity. If you have enabled Recommendation scans (Trend sub-agent), you can run Recommendation scans with FIM to identify a list of rules that should be applied based on the configuration of your Virtual Machine. You can also choose to have the recommended rules automatically applied to your machine.

To use this feature, select the FIM product in the Toolbox and choose the "on" operation. To use this feature with Recommendation scans, select the FIM product in the Toolbox and choose the "auto-apply-recommendations-on" operation.

OperationDescriptionAsync Flag

fim on


Optional Parameter:

fim on auto-apply-recommendations=on

fim on auto-apply-recommendations=off

Turn file integrity monitoring on



Auto-apply recommendations on

Auto-apply recommendations off

Yes



Yes

Yes

fim off

Turn file integrity monitoring off

Yes
fim list-available-rulesList available rules
fim list-assigned-rulesList assigned rules
fim assign-rulesAssign rulesYes
fim unassign-ruleUnassign ruleYes

fim add-custom-filepath-rule

Add custom filepath
fim update-custom-filepath-ruleUpdate custom filepath

fim delete-custom-filepath-rule

Delete custom filepath

fim get-custom-filepath-rule

Get custom filepath
fim statusReports status of module from subagent

.

Intrusion Prevention System


The Armor Intrusion Prevention System service detects or prevents known and zero-day vulnerabilities (e.g. SQL injections attacks, cross-site scripting attacks, etc). Customers can use IPS in prevent or detect mode, depending on whether you want traffic to be blocked or not. If you have enabled Recommendation scans (Trend sub-agent), you can run Recommendation scans with IPS to identify a list of rules that should be applied based on the configuration of your Virtual Machine. You can also choose to have the recommended rules automatically applied to your machine.

To use this feature, select the IPS product in the Toolbox and choose the "prevent" or "detect" operation. To use this feature with Recommendation scans, select the IPS product (prevent or detect mode) in the Toolbox and choose the "auto-apply-recommendations-on" operation.


OperationDescriptionAsync Flag

ips detect


Optional Parameter:

ips detect auto-apply-recommendations=on

ips detect auto-apply-recommendations=off

Turn intrusion prevention on in detect mode



Auto-apply recommendations on

Auto-apply recommendations off

Yes



Yes

Yes

ips prevent


Optional Parameter:

ips prevent auto-apply-recommendations=on

ips prevent auto-apply-recommendations=off

Turn intrusion prevention on in prevent mode



Auto-apply recommendations on

Auto-apply recommendations off

Yes



Yes

Yes

ips offTurn intrusion prevention offYes
ips list-assigned-rulesList assigned rulesYes
ips assign-rulesAssign rulesYes
ips unassign-ruleUnassign rule
ips statusReports status of module from subagent

.

Vulnerability Management


Armor's Vulnerability Scanning service detects OS and application vulnerabilities present in your environment.

To use this feature, select the Vulnerability Management product in the Toolbox and choose the "on" operation.

OperationDescription
vuln installInstall Qualys vulnerability management
vuln uninstallUninstall Qualys vulnerability management

.

Logging


The Armor Logging service ships OS logs to Armor for correlation and analysis.

To use this feature, select the Logging product in the Toolbox and choose the "on" operation.

OperationDescription
logging installInstall logging service
logging uninstallUninstall logging service

By default, the Armor Agent collects the following logs for 30 days:

CentOS/RHELUbuntu/DebianWindows

/var/log/secure

/var/log/messages

/var/log/audit.log

/var/log/yum.log

/var/log/auth.log

/var/log/syslog

System Event Log

Security Event Log


Log Relay


To use this feature, select the Log Relay product in the Toolbox and choose the "install" operation.

OperationDescription
relay installInstall Log Relay Software
relay uninstallUninstall Log Relay Software


Additional Services

Tags


Armor's Tagging feature allows users to add metadata tags to their logs. Users can search for these tags via API or in the Armor Management Portal (AMP) on the Virtual Machines screen. To use this feature, select the Tags product in the Toolbox and choose the "create tags" operation. In the Additional Configuration text box, enter a key value pair (e.g. key=pair). You can enter more than one tag using a comma as separator.

OperationDescription
create-tagsCreate Tags
delete-tagsDelete Tags
describe-tagsDescribe tags


SSL Check


This command will check servers used by the agent for connectivity. SSL-check command will check all services regardless of if a particular service is installed on them or not. This feature is primarily for debugging and informational purposes. Command is valid for both Windows and Linux operating systems.

OperationDescription

armor agent ssl-check

checks servers for connectivity


Sysmon


Configuring Apache services uses the Command Line Interface (CLI) feature. For more information, see Security Service CLI Commands.

The following arguments to install and uninstall Sysmon services.

COMMAND

ARGUMENTS

RESULT

sysmon

install

Installs the Sysmon service.

sysmon

uninstall

Removes the Sysmon service.

The following arguments are possible parameters for the Logging CLI feature.

COMMAND

ARGUMENTS

RESULT

add-event-logs

"Microsoft-Windows-Sysmon/Operational"

Add the event log to the logging service.

sync-event-logs


Syncs the logging config.

remove-event-logs

"Microsoft-Windows-Sysmon/Operational"

Remove the event log from the logging service