Prerequisites
-
The Open Collector is installed. If you have not already installed it, follow the instructions in the Open Collector Installation and User Guide, and then return to this topic.
-
Requires an API Key, obtained during the steps outlined in Configure the Tenable Portal.
-
System Monitor version 7.24 or higher is installed.
-
JSON Parsing is enabled. For more information, refer to Configure Beats for JSON Parsing.
-
The following port is open:
|
Direction |
Port |
Protocol |
Source |
|---|---|---|---|
|
Outbound |
443 |
HTTPS |
Tenable Beat |
Initialize the Beat via the Web Console (Recommended)
-
Ensure that the Open Collector Connection to the SIEM (WebUI) setup has been completed.
-
Ensure that the System Monitor Agent to which you intend to send these logs has been Configured for JSON Parsing.
Use either the Enable JSON Parsing on System Monitor Agents or the Enable JSON Parsing for an Existing System Monitor Agent sections at the above link to configure the System Monitor Agent for JSON Parsing.
-
Follow the steps outlined in Add a Beat in the Web Console to create the Beat via the Web UI.
Initialize the Beat via Command Line (Legacy)
-
Start the beat:
./lrctl tenablebeat start -
Use the Up and Down Arrow keys to select New tenablebeat instance from the list, and then press Enter.
-
Enter a unique identifier for the beat instance.
-
Enter the Access Key obtained during the steps outlined in Configure the Tenable Portal.
-
Enter the Secret Key obtained during the steps outlined in Configure the Tenable Portal.
-
Enter Number of BackDays data to be fetched, where the maximum value is 30 and the minimum value is 0:
-
Enter the interval in minutes “m” for the API call.
Ensure that you include “m” for minutes after the numeric value. For example, “6m”.
-
Enter the hostname or IP address of the System Monitor Agent that has been Configured for JSON Parsing, and then press Enter.
Use either the Enable JSON Parsing on System Monitor Agents or the Enable JSON Parsing for an Existing System Monitor Agent sections at the above link to configure the System Monitor Agent for JSON Parsing.
-
Enter the port on which the System Monitor Agent is configured to listen for JSON data (the default is 5044), and then press Enter.
The tenablebeat service started message appears. -
Check the status of the service to confirm that it’s running:
./lrctl tenablebeat status -
(Optional) Edit the tenablebeat configuration to update the values set above if needed. Ensure that you have all the needed information for each step available as you will need to re-enter it:
./lrctl tenablebeat config edit