Configuring a file destination
You can configure flat text or JSON files as your connection destination. By default, files are written to the \Program Files\Tanium\Tanium Module Server\services\connect-files\output directory.
Specify general connection information
- On the Connect home page, click Create Connection.
- Enter a name and description for your connection.
- Enable the connection to run on a schedule.
Select Enable. You can set up the schedule when you configure the rest of the connection. If the schedule is not enabled, the connection only runs when you manually run it. - (Optional) Set the logging level.
By default, the logging is set to Information. Set the log level to Trace or Debug if you are debugging the connection. To reduce the amount of logging, you can set the log level to Warning, Error, or Fatal.
Configure the connection source
The connection source determines what data you are sending to the destination. This data is usually information from Tanium™, such as a saved question, question log, system status, or event. The settings vary depending on which source you choose.
Connection sources
Action History
The action history is a record of all actions issued by console operators. To view this record in Tanium, click Actions > Action History. For more information, see Tanium Platform User Guide: Managing Action History.
Asset Report
Tanium™ Asset comes with a set of predefined reports to help you prepare for audit and inventory activities. For each of the predefined reports, you can create a connection that specifies a report as a data source. Currently supported destinations include Email, File, HTTP, Socket Receiver, Splunk, and SQL Server. For more information, see Tanium Asset User Guide: Asset overview.
Audit Log
Tanium Server keeps detailed audit logs for server configuration and settings changes. However, accessing these logs requires direct access to the Tanium database. To access the audit logs, you can set them up as a data source in Tanium Connect.
Event
Tanium solutions, like Tanium™ Detect and Tanium™ Discover, can forward events to Connect as a data source. These events can then be used as a connection source in a connection and sent to any of the available connection destinations.
Palo Alto WildFire
Integration between Tanium and WildFire takes a list of confirmed malware from a Palo Alto firewall and requests a full report from the WildFire system. The full malware report is then converted into a standard indicator of compromise (IOC) and passed to the Detect system for multiple endpoint compromise detection. For more information, see Configuring Palo Alto Networks WildFire and Tanium Detect.
Question Log
The question history log is a history of every question that has been asked. When you are using the question log as a data source in Connect, you can filter the log in several ways to reduce the total volume of data being sent. For more information, see Tanium Platform User Guide: Question History.
Reputation Service
The reputation service is an aggregated repository of reputation data from various sources, including as Palo Alto WildFire and VirusTotal. You can choose which type of status to include, such as only malicious or suspicious content. You can choose to include the full report, which includes the detailed information from the reputation source, not just the status of the reputation item. You must have one or more reputation sources configured to get information from this connection source. For more information, see Configuring reputation data.
Saved Question
A saved question is a Tanium question that you want to ask on a repeated basis. For more information about saved questions, see Tanium Platform User Guide: Working with Saved Questions. You can use the following settings for saved questions:
| Setting | Description |
|---|---|
| Use Cached Data |
To reduce the impact on endpoints, consider using the Use Cached Data setting. When enabled, the Use Cached Data setting pulls saved question results from the cache on the Tanium Server. If the saved question has not been asked before the connection is created, the connection asks the saved question the first time it runs. |
| Flatten |
You might want to enable the Flatten setting to process results as individual records. For example, you might want to get notified when you see a new MD5 hash on a machine. Without the Flatten setting enabled, the entire data set that is retrieved by the saved question from a machine, such as all MD5 hashes, is considered to be a single record. Any change that is made to this data set shows up in the destination. By enabling the Flatten setting, Connect processes the new hashes on an individual basis (one MD5 hash from one machine) instead of all hashes from a machine as a single record. |
| Hide Errors | If the saved question returns an error, you can use the Hide Errors setting to prevent the error results from getting sent to the destination. |
| Hide No Results | If the saved question returns [No results], you can use the Hide No Results setting to prevent this result from being sent to the destination. |
| Recent | If you want to include results from machines that are offline, select Recent, which returns the most recent answer to the saved question for the offline endpoint. |
| Answer Complete Percent |
Results are returned when the saved question returns the configured complete percent value. Any results that come in after the configured percent value has passed are not sent to the destination. If you are finding that the data returned from the saved question is incomplete in your destination, you can disable this setting by setting it to 0. If disabled, all data is returned after the timeout passes. |
| Timeout | Minutes to wait for clients to reply before returning processed results. |
| Batch Size | Number of rows that are returned for the saved question results at one time. This setting might vary depending on your destination. |
Server Information
Use the server information in the following location as a connection source: https://<tanium_server>/info.json.
System Status
System status includes the state of all the endpoints, including some useful information about the endpoint like IP Address, position in the network, and the last time it registered with the Tanium Server. For more information about the system status data, see Tanium Platform User Guide: Monitoring System Status.
VirusTotal Process
VirusTotal is an online catalog of known malware. The connection source for a connection is a combination of Tanium and VirusTotal data. For more information, see Configuring VirusTotal.
Configure the file destination
Specify details about the file that you want Connect to create, including the file name and how you want to save the file.
- Name the destination.
You can either indicate a unique name to save the configuration information as a new destination, or you can select an existing file destination from the list. - Indicate the file name. Files are written to the \Program Files\Tanium\Tanium Module Server\services\connect-files\output directory.
- The file name can include a subdirectory to create in the \Program Files\Tanium\Tanium Module Server\services\connect-files\output directory, or just the file name. For example, if you specify high_cpu_results\cpu_results.txt, the file is written to: \Program Files\Tanium\Tanium Module Server\services\connect-files\output\high_cpu_results\cpu_results.txt.
- If you want to point to the file directory on the Module Server from another location, create a symbolic link with the mklink command. For example, if you wanted a symbolic link from the c:\logs\mylogs directory to the connect logs directory, you might run:
mklink /d "c:\logs\mylogs" "c:\Program Files\Tanium\Tanium Module Server\services\connect-files\output\logs\mylogs"
- You can choose to compress the resulting file as a gzip or zip file. The file extension is automatically added to the end of the file name.
- (Optional) Add a time stamp to the file name.
You can choose from the formats that are available, or enter your own time stamp format in ISO 8601 format. - (Optional) Compress or replace files.
Choose whether you want to replace the contents of the file when the connection runs, or if you want to append to the file contents. If you choose to replace the file contents, you can also compress the resulting file in zip or gzip format. - (Optional) Choose whether to create a blank file when no results are generated. If your source generates no results when the connection runs, you can either create a blank file or have the connection run without writing to a file.
Configure filters
(Optional) You can use filters to modify the data that you are getting from your connection source before it is sent to the destination.
For more information about the types of filters you can configure, see Reference: Filtering options.
Format data for file
You can choose to save your file in all of the available formats, as listed in Reference: Format types. Each format has slightly different configuration options, but all allow you to choose which column data to save.
You can change the Destination name of each column and Value Type to force the column to be a String, Numeric, or DateTime value. If you choose Numeric for the value, you can specify a default value that is used if the data cannot be coerced into a numeric value. You can specify any negative or positive number. If you choose DateTime for the value, specify the Date/Time format that you want to use for the column.
Schedule the connection
Connections can run at a highly configurable time interval, such as multiple times per hour, day, week, or month.
Update the schedule: Use the Generate Cron tab to build a schedule based on some common time intervals. This tab generates a Cron expression.
To view or edit the Cron expression directly, click the Edit Cron Expression tab.
Cron syntax
A quick reference to Cron syntax follows. You can use Crontab to build a Cron expression.
┌────────────── second (optional) │ ┌──────────── minute │ │ ┌────────── hour │ │ │ ┌──────── day of month │ │ │ │ ┌────── month │ │ │ │ │ ┌──── day of week │ │ │ │ │ │ │ │ │ │ │ │ * * * * * *
Each asterisk is a field that must be included in the Cron expression. The field value can either be an asterisk (any value) or one of the following values:
| Field | Value |
|---|---|
| second | 0-59 |
| minute | 0-59 |
| hour | 0-23 |
| day of month | 1-31 |
| month | 1-12 |
| day of week (Sunday is 0 and 7) | 0-7 |
Save and verify connection
- Click Create Connection. When the connection gets created, your new connection displays in the list on the Connections page.
- To view details about when the connection is running, click the name of the connection. On the resulting connection details page, click the Runs tab.
- To view individual run logs, click the link in the Status column in the Runs table.
Last updated: 6/19/2018 3:25 PM | Feedback