TXSP Guide 1.1
TXSP Guide 1.1
Chapter 1: Introduction
About the TXOne™ Stellar™ Series and StellarProtect™ .......... 1-2
What's New .................................................................. 1-2
Agent Features and Benefits .......................................... 1-3
Chapter 2: Installation
System Requirements ......................................................... 2-2
System Requirements ................................................... 2-2
Operating Systems ........................................................ 2-3
Local Installation ................................................................ 2-4
Getting the StellarProtect Agent Package ........................ 2-4
Installing the StellarProtect Agent .................................. 2-7
Silent Installation .............................................................. 2-18
Configuring Silent Installation ..................................... 2-18
Silent Installation of the StellarProtect Agent ................ 2-22
Preparing the Agent for Upgrade to a Later Version ............. 2-26
i
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Chapter 6: Events
Overview of StellarProtect Events ........................................ 6-2
Agent Event List ................................................................. 6-2
ii
Table of Contents
Index
Index ............................................................................... IN-1
iii
Preface
This Administrator's Guide introduces TXOne Networks StellarProtect and
covers all aspects of product management.
• Audience on page vi
Documentation Description
Installation Guide A PDF document that discusses requirements and procedures for
installing StellarProtect.
Administrator's Guide A PDF document that discusses getting started information and
StellarProtect usage and management.
Readme File Contains a list of known issues. It may also contain late-breaking
product information not found in the printed documentation.
Download the latest version of the PDF documents and Readme at:
http://docs.trendmicro.com
v
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Audience
TXOne Networks StellarProtect documentation is intended for
administrators responsible for StellarProtect management, including agent
installation.
Document Conventions
The following table provides the official terminology used throughout the
TXOne Networks StellarProtect documentation:
Table 2. Document Conventions
Convention Description
Monospace Sample command lines, program code, web URLs, file names,
and program output
Configuration notes
Note
Recommendations or suggestions
Tip
vi
Convention Description
vii
Chapter 1
Introduction
This chapter introduces TXOne StellarProtect 1.1, which provides industrial-
grade next-generation antivirus protection for your assets, and gives an
overview of its functions.
• About the TXOne™ Stellar™ Series and StellarProtect™ on page 1-2
• Agent Features and Benefits on page 1-3
1-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
What's New
TXOne StellarProtect 1.1 includes the following new features and
enhancements.
Table 1-1. What's New in TXOne StellarProtect 1.1
Feature Description
Compatibility with Trend Micro Portable StellarProtect 1.1 is now compatible with
Security 2 and 3 Trend Micro Portable Security products.
Remote patching from StellarOne is now Starting from version 1.1, StellarProtect can
supported be patched from the StellarOne console.
Scan components can now update from For air-gapped environments, StellarProtect
StellarOne now can perform scan component updates
from StellarOne.
Scan components now update before prescan StellarProtect will now update scan
components before beginning the prescan.
1-2
Introduction
Feature Description
Silent install has been enhanced A new silent install method is now available.
Support added to the command line for Users can now restore quarantined files on
restoring quarantined files the standalone agent using the CLI.
New Windows platform support added StellarProtect 1.1 now officially support
Windows Server 2008 and Windows 10 21H1.
Various bug fixes and enhancements Bugs were fixed and many enhancements
were added, including new kinds of event
blocking based on user-defined rules.
Feature Benefit
Industrial-Grade Next-Generation Antivirus ICS root of trust and advanced threat scan
secure OT assets with no interruption to
operations
1-3
Chapter 2
Installation
This chapter shows how to install the TXOne StellarProtect agent. The
StellarProtect agent provides several installation types including local
installation and silent installation.
Topics in this chapter include:
• System Requirements on page 2-2
• Local Installation on page 2-4
• Silent Installation on page 2-18
2-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
System Requirements
This section introduces the system requirements for StellarProtect, including
hardware and OS requirements.
System Requirements
TXOne StellarProtect does not have specific hardware requirements beyond
those specified by the operating system, with the following exceptions:
Table 2-1. Required Software for StellarProtect
Software Description
Hardware Description
Important
StellarProtect cannot be installed on a system that already runs one of the
following:
2-2
Installation
Important
Ensure that the following root certification authority (CA) certificates are
installed with intermediate CAs, which are found in StellarProtectSetup.exe and
StellarProtect.exe. These root CAs should be installed on the StellarProtect
agent environment to communicate with StellarOne.
https://technet.microsoft.com/en-us/library/cc754841.aspx
Operating Systems
Client OS:
Server OS:
2-3
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Local Installation
This section mainly explains the steps for installing StellarProtect, including
downloading the installation file from StellarOne, running the installer,
doing setup, and uninstalling StellarProtect.
Procedure
1. First log into StellarOne (default ID and password are admin/txone), the
system will guide the user to change their ID and password to ensure
account security.
2-4
Installation
4. The system will ask the user to input an activation code (AC) for
StellarOne service activation.
Note
The AC can be provided by the TXOne product center or another
authorized agency.
2-5
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
5. Download the install package from the StellarOne web console. The user
can visit Administration > Updates to download the StellarProtect
installation package. The downloaded package is packed by StellarOne
and can be installed by all agents.
2-6
Installation
Procedure
2-7
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
3. The End-User License Agreement (EULA) will be shown. Please read the
content, then click I accept the terms of the license agreement and
Next.
2-8
Installation
5. Please input the asset information of the installed device with correct
ICS-relative information such as vendor name, model, location and a
description.
2-9
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Note
Users can choose to whether or not to add an icon to the start menu,
create a desktop icon, or create a system tray icon.
Important
We suggest that users should also check Enable Trusted ICS Certificates.
This feature ensures that StellarProtect can sync up trusted ICS certificates
and enhance ICS applications, and that installers can always be recognized
by StellarProtect.
7. Please click the Scan button to start the pre-scan task. Please note, this
step is extremely important – please agree to allow StellarProtect to scan
the ICS device to learn which ICS applications are installed.
2-10
Installation
Important
If you skip the pre-scan, StellarProtect will not be able to recognize the ICS
application before it resumes production, and will need to learn them
when as they are executed for the first time. In addition, this may cause
delays in ICS applications, so we strongly recommend that you click Scan
to allow StellarProtect learn about installed ICS applications in advance.
8. During the installation, the installer will show the status with a progress
bar.
2-11
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Note
Before the prescan starts, the installer will perform a component update
based on the chosen configuration. For the standalone agent installer
package, connecting to the Trend Micro Active Update server will be
necessary to perform the update, so internet access is required.
The update process will display a message as shown below. Please note
that there is no need for concern when you see this window.
2-12
Installation
2-13
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
2-14
Installation
11. If a threat is detected, the user can choose from two options:
12. After the prescan phase is complete, the StellarProtect application will
be installed.
2-15
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
13. When the installation is complete, you will see the window below.
2-16
Installation
15. Upon logging into StellarProtect successfully, this window will display.
2-17
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Silent Installation
StellarProtect provides silent installation based on a pre-defined
configuration file. User can use the Configuration session to enable silent
installation based on the Setup.yaml, then execute
StellarProtectSetup.exe in silent mode.
• install:
• • activation_code: <ACTIVATION_CODE>
password: <PASSWORD>
asset_vendor: <ASSERT_VENDOR>
asset_model: <ASSET_MODEL>
asset_location: <ASSET_LOCATION>
2-18
Installation
asset_description: <ASSET_DESCRIPTION>
install_location: <INSTALL_LOCATION>
enable_start_menu: <ENABLE_START_MENU>
enable_desktop_icon: <ENABLE_DESKTOP_ICON>
enable_systray_icon: <ENABLE_SYSTRAY_ICON>
enable_trusted_ics_cert: <ENABLE_TRUSTED_ICS_CERT>
enable_prescan: <ENABLE_PRESCAN>
enable_silent_install: <ENABLE_SILENT_INSTALL>
• prescan:
• • action: <PRESCAN_ACTION>
• server:
• • host: <SERVER_HOST>
• port: <SERVER_PORT>
• cert: <SERVER_CERT>
• listen: <LISTEN_PORT>
• client:
• • import_source: <IMPORT_SOURCE>
• proxy:
• • default:
• • intranet:
• • host: <INTRANET_PROXY_SERVER_HOST>
• port: <INTRANET_PROXY_SERVER_PORT>
• username: <INTRANET_PROXY_SERVER_USERNAME>
2-19
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
• password: <INTRANET_PROXY_SERVER_PASSWORD>
The following table lists parameters for Setup.yaml along with the details of
their use:
2-20
Installation
2-21
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Procedure
1. Please input the activation code and password, then enable silent
installation by changing the enable_silent_install value to true in
the configuration file. If you would like to manage the agent using
StellarOne, please configure the server session host value with the
server IP address.
2-22
Installation
• password: 11111111
• asset_vendor: ABB
• asset_model: ABB-1X2Y
• asset_location: Factory1 North Area
• asset_description: This is a machine
• install_location: C:\test
• enable_start_menu: true
• enable_desktop_icon: true
• enable_systray_icon: true
• enable_trusted_ics_cert: true
• enable_prescan: true
• enable_silent_install: true
• prescan:
• action: 1
• server:
• • host: 10.1.195.100
• port: 9443
• cert: server.crt
• listen: 14336
2-23
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Note
Please note that there are two methods for beginning the silent
installation.
• For a silent installation with a GUI, double-click the installer
StellarProtectSetup.exe.
2-24
Installation
2-25
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Important
Before upgrading, take the appropriate actions below as noted for your chosen
installation method and the version of your installed StellarEnforce agent.
2-26
Installation
2-27
Chapter 3
Uninstalling StellarProtect
Note
StellarProtect's administrator password is required to uninstall StellarProtect
from an endpoint.
Important
Please make sure the StellarProtect UI is not open.
Procedure
1. On an endpoint with the StellarProtect agent installed, launch
StellarProtect Setup.
2. Follow the steps listed here according to your operating system:
3-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
3-2
Uninstalling StellarProtect
3-3
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
3-4
Chapter 4
4-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Overview
Overview is a description of the current status of the StellarProtect system.
The shield shape indicates if the endpoint is currently protected by
StellarProtect's Next-Generation Antivirus. The column on the right is the
endpoint's ICS asset information including Model, Location, Vendor and
Description.
The following current information about endpoint protection will be shown:
• Number of ICS apps: How many ICS applications are in the endpoint
• Last ICS inventory update on: The date and time the ICS Inventory was
last updated on this endpoint
• Last blocked event: Clicking the link shows the most recent blocked
events
• License expires on: When StellarProtect’s current license will expire
4-2
Using the Agent Console
ICS Applications
This function lists all ICS application systems recognized by StellarProtect on
this endpoint, and lists the software name, vendor name, product version
and installation path of each application system.
The number of ICS application systems that StellarProtect can recognize will
continue to increase with updates to the ICS Application Inventory, which is
maintained by the TXOne research laboratory based on ICS product analysis.
4-3
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
ICS Certificates
Digital signature is currently the most secure software product identification
technology, which can ensure that the signed software component is not
illegally modified, and can identify that the software was released by the
original manufacturer.
The number of ICS certificates that StellarProtect can recognize will increase
with updates from the ICS Application Inventory. This inventory is produced
by the TXOne research laboratory and based on ICS product analysis.
4-4
Using the Agent Console
4-5
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Scan Components
List all critical scan engines and patterns with versions used by
StellarProtect.
Password
This is the StellarProtect administrator password change function. The user
must enter the correct old password, then enter the same new password
4-6
Using the Agent Console
twice, confirm that the length of the new password meets the requirements,
and press Save to complete the change.
4-7
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
2. The USB will be blocked if USB Vector Control is enabled and the device
is untrusted
4-8
Using the Agent Console
Note
DLL injection can only be enabled in 32-bit Windows OSes.
4-9
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Settings
This section mainly describes the StellarProtect settings, including the
aforementioned four main protection functions and DLL Injection
Protection. Each function has a switch that can be turned on or off.
4-10
Using the Agent Console
4-11
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
• Learning Mode
• Detection Mode
• Prevention Mode
4-12
Using the Agent Console
• Disabled Mode
4-13
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Note
DLL injection can only be enabled in 32-bit Windows OSes.
About
Proxy
StellarProtect use a proxy for both communication with StellarOne and scan
component updates.
4-14
Using the Agent Console
4-15
Chapter 5
5-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Procedure
1. Open a command prompt window with Windows administrator
privileges.
2. Navigate to the TXOne StellarProtect installation folder using the cd
command.
For example, type the following command to reach the default location:
cd /d "c:\Program Files\TXOne\StellarProtect\"
3. Type OPCmd.exe.
Overview
The CLI provides a POSIX-style command line interface. The general usage is
as follows:
C:> opcmd.exe [global-options] [command [options]]
The global-options are options that affect all commands, and must come
before the command. A command consists of one or more words, followed
by any options that are specific to that command. If an option requires an
argument, you may specify the argument in one of the following syntaxes:
Options
--option=<argument>
5-2
Using the Agent Command Line Interface (CLI)
-o <argument>
If the argument is not optional, you may also separate the option and
argument with a space.
Important
All options are optional, including global options and command-specific
options. In the commands below, if it says an argument is required, it means
the argument is required when that option is used.
For the short forms of options, multiple option characters can be combined
in one word as long as the option with argument comes last. For example,
the following commands are equivalent:
• opcmd.exe foo -a -b 15 -c
Global Options
• Global Option: -h, --help
Description: When used alone, shows a brief summary of how to use the
CLI. When used with a command, shows help text for that command.
Argument: No
• Global Option: -p, --password [<password>]
Description: Specifies the administrator password for executing
protected commands. The -p option is mandatory for protected
commands. If you don't provide an administrator password with this
option on protected commands, the CLI asks for a password before
executing the command and may not execute command if the password
is incorrect. If you need to run protected commands from a batch file,
provide your password with -p and make the batch file readable only to
authorized users.
5-3
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Note
To prevent your administrator password from leaking accidently, use -p
without argument to avoid the shell (cmd.exe) from recording your
password in the command history.
Argument: No
5-4
Using the Agent Command Line Interface (CLI)
5-5
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
5-6
Using the Agent Command Line Interface (CLI)
opcmd.exe -p oad enable Enables Operations Behavior -m, --mode MODE: Required
-m MODE [-l LEVEL] Anomaly Detection. argument. Enables
Operations Behavior Anomaly
Detection into a specific
mode (learning,
detection, prevention).
5-7
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
opcmd.exe -p proxy set Sets proxy server settings. -h, --host HOST Required
[-h HOST -p PORT [-u argument. Specifies the
USERNAME] [-P
To disable proxy use, use this FQDN, hostname, or IP
PASSWORD]] command without any address of the proxy server.
options.
-p, --port PORT: Required
argument. Specifies the port
number of the proxy server.
-u, --username
USERNAME: Required
argument. Specifies the
username for proxy server
authentication.
-P, --password PASSWORD
Required argument. Specifies
the password for proxy server
authentication.
5-8
Using the Agent Command Line Interface (CLI)
opcmd.exe -p usb add [- Adds a trusted USB device. -v, --vid VID: Required
v VID -p PID -s SN] [- argument. Specifies Vendor
o] ID by hexadecimal string.
-p, --pid PID: Required
argument. Specifies Product
ID by hexadecimal string.
-s --sn SN: Required
argument. Specifies serial
number.
-o, --onetime: Grants one
time access to a USB device.
5-9
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
opcmd.exe -p usb info - Show USB information of the -d, --drive DRIVE:
d DRIVE specified drive. Required argument. Specifies
the drive path (ex. E:).
opcmd.exe -p usb remove Removes a trusted USB -v, --vid VID: Required
[-v VID -p PID -s SN] device. argument. Specifies Vendor
ID by hexadecimal string.
-p, --pid PID: Required
argument. Specifies Product
ID by hexadecimal string.
-s --sn SN: Required
argument. Specifies serial
number.
5-10
Chapter 6
Events
This chapter describes events as they will be recorded within the TXOne
StellarProtect Agent.
Topics in this chapter include:
• Overview of StellarProtect Events on page 6-2
• Agent Event List on page 6-2
6-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Event
Event ID Level Category Event Details
Content
6-2
Events
Event
Event ID Level Category Event Details
Content
6-3
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Event
Event ID Level Category Event Details
Content
6-4
Events
Event
Event ID Level Category Event Details
Content
6-5
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Event
Event ID Level Category Event Details
Content
0x1203 Warning (1) intelli_av (2) Local Files Local files were
Scanned, Action scanned by
Taken by antivirus.
Antivirus: Actions were
%PATH% taken according
to settings.
File Path: %PATH
%
File Hash:
%STRING%
Threat Type:
%STRING%
Threat Name:
%STRING%
Action Result:
%INTEGER%
Quarantine Path:
%PATH%
6-6
Events
Event
Event ID Level Category Event Details
Content
0x1204 Warning (1) intelli_av (2) Local Files Local files were
Scanned, Action scanned by next-
Taken by Next- generation
Generation antivirus.
Antivirus: Actions were
%PATH% taken according
to settings.
File Path: %PATH
%
File Hash:
%STRING%
Threat Type:
%STRING%
Threat Name:
%STRING%
Action Result:
%INTEGER%
Quarantine Path:
%PATH%
6-7
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Event
Event ID Level Category Event Details
Content
6-8
Events
Event
Event ID Level Category Event Details
Content
6-9
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Event
Event ID Level Category Event Details
Content
0x1400 Warning (1) change_control ICS File Change ICS File change
(4) Blocked by to executable
SafeGuard: file were blocked
%PATH% by SafeGuard.
Blocked Process:
%PATH%
Target File:
%PATH%
6-10
Events
Event
Event ID Level Category Event Details
Content
6-11
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Event
Event ID Level Category Event Details
Content
6-12
Chapter 7
Technical Support
TXOne Networks is a joint venture of Trend Micro and Moxa, and support for
TXOne Networks products is provided by Trend Micro. All technical support
goes through Trend Micro engineers.
Learn about the following topics:
• Troubleshooting Resources on page 7-2
• Contacting Trend Micro on page 7-3
• Sending Suspicious Content to Trend Micro on page 7-4
• Other Resources on page 7-5
7-1
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
Troubleshooting Resources
Before contacting technical support, consider visiting the following Trend
Micro online resources.
Procedure
1. Go to https://success.trendmicro.com.
2. Select from the available products or click the appropriate button to
search for solutions.
3. Use the Search Support box to search for available solutions.
4. If no solution is found, click Contact Support and select the type of
support needed.
Tip
To submit a support case online, visit the following URL:
https://success.trendmicro.com/sign-in
Threat Encyclopedia
Most malware today consists of blended threats, which combine two or more
technologies, to bypass computer security protocols. Trend Micro combats
this complex malware with products that create a custom defense strategy.
7-2
Technical Support
Go to https://www.trendmicro.com/vinfo/us/threat-encyclopedia/#malware
to learn more about:
• Malware and malicious mobile code currently active or "in the wild"
Website https://www.trendmicro.com
https://www.trendmicro.com/us/about-us/contact/index.html
7-3
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
https://docs.trendmicro.com
7-4
Technical Support
https://success.trendmicro.com/solution/1112106
Other Resources
In addition to solutions and support, there are many other helpful resources
available online to stay up to date, learn about innovations, and be aware of
the latest security trends.
Download Center
From time to time, Trend Micro may release a patch for a reported known
issue or an upgrade that applies to a specific product or service. To find out
whether any patches are available, go to:
https://www.trendmicro.com/download/
7-5
TXOne Networks StellarProtect™ 1.1 Installation and Administrator's Guide
If a patch has not been applied (patches are dated), open the Readme file to
determine whether it is relevant to your environment. The Readme file also
contains installation instructions.
Documentation Feedback
Trend Micro always seeks to improve its documentation. If you have
questions, comments, or suggestions about this or any Trend Micro
document, please go to the following site:
https://docs.trendmicro.com/en-us/survey.aspx
7-6
Index
A
agents
features and benefits, 1-3
system requirements, 2-2
D
documentation, v
documentation feedback, 7-6
E
events, 6-2
L
local installation, 2-1, 2-4
O
OPCmd Program
using, 5-2
R
requirements, 2-2
S
silent installation, 2-1, 2-18
StellarEnforce, 1-2
StellarOne, 1-2
StellarProtect, 1-2
Stellar series, 1-2
support
resolve issues faster, 7-4
system requirements, 2-2
U
uninstallation, 3-1
upgrade, 2-26
IN-1