# Collect Tanium Question logs

Supported in:

This document explains how to ingest Tanium Question logs to Google Security Operations using Tanium Connect's native AWS S3 export functionality. Tanium Question logs contain query execution metadata, audit information, and question results data in JSON format, which can be directly exported to S3 using Tanium Connect without requiring custom Lambda functions.

## Before you begin

Make sure you have the following prerequisites:

- A Google SecOps instance
- **Tanium Core Platform** 7.0 or later
- **Tanium Interact** module for question management
- **Tanium Connect** module installed with valid license
- Privileged access to **Tanium Console** with administrative rights
- Privileged access to **AWS** (S3, IAM).

## Configure Tanium question audit service account

1. Sign in to the **Tanium Console**.
2. Go to **Administration \> Global Settings**.
3. Navigate to **Question Audit** settings.
4. Configure audit logging to capture question execution metadata.
5. Ensure the service account has appropriate audit access permissions.

## Collect Tanium Question prerequisites

1. Sign in to the **Tanium Console** as an administrator.
2. Go to **Administration \> Permissions \> Users**.
3. Create or identify a service account user with the following roles:

   - **Question Author** or **Administrator** role for question access.
   - **Connect User** role privilege.
   - **Read Saved Question** permission for audit content sets.
   - Access to monitored computer groups (recommended: **All Computers** group).

   > [!NOTE]
   > **Note:** The service account credentials are used internally by Tanium Connect to authenticate and retrieve question audit data. These credentials are configured during the Tanium Connect source setup within the Tanium Console interface.

## Configure AWS S3 bucket and IAM for Google SecOps

1. Create **Amazon S3 bucket** following this user guide: [Creating a bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)
2. Save bucket **Name** and **Region** for future reference (for example, `tanium-question-logs`).
3. Create a user following this user guide: [Creating an IAM user](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console).
4. Select the created **User**.
5. Select the **Security credentials** tab.
6. Click **Create Access Key** in the **Access Keys** section.
7. Select **Third-party service** as the **Use case**.
8. Click **Next**.
9. Optional: add a description tag.
10. Click **Create access key**.
11. Click **Download CSV file** to save the **Access Key** and **Secret Access Key** for later use.
12. Click **Done**.
13. Select the **Permissions** tab.
14. Click **Add permissions** in the **Permissions policies** section.
15. Select **Add permissions**.
16. Select **Attach policies directly**
17. Search for and select the **AmazonS3FullAccess** policy.
18. Click **Next**.
19. Click **Add permissions**.

## Configure Tanium Connect AWS S3 destination

1. Sign in to the **Tanium Console**.
2. Go to **Modules \> Connect**.
3. Click **Create Connection**.
4. Provide the following configuration details:
   - **Name** : Enter a descriptive name (for example, `Question Audit to S3 for SecOps`).
   - **Description** : Optional description (for example, `Export question execution and audit data to AWS S3 for Google SecOps ingestion`).
   - **Enable**: Select to enable the connection to run on schedule.
5. Click **Next**.

### Configure the connection source

1. In the **Source** section, provide the following configuration details:
   - **Source Type** : Select **Saved Question**.
   - **Saved Question** : Select one of the following question audit-related saved questions:
     - **Question Log** for question execution history.
     - **Action History** for administrative actions and question deployment.
     - **User Activity** for user interaction with questions.
     - **System Status** for platform performance metrics.
   - **Computer Group** : Select **All Computers** or specific computer groups to monitor.
   - **Refresh Interval** : Set appropriate interval for data collection (for example, **30 minutes**).
2. Click **Next**.

### Configure AWS S3 destination

1. In the **Destination** section, provide the following configuration details:
   - **Destination Type** : Select **AWS S3**.
   - **Destination Name** : Enter a unique name (for example, `Google SecOps Question S3 Destination`).
   - **AWS Access Key**: Enter the AWS access key from the CSV file downloaded in the AWS S3 configuration step.
   - **AWS Secret Access Key**: Enter the AWS secret access key from the CSV file downloaded in the AWS S3 configuration step.
   - **Bucket Name** : Enter your S3 bucket name (for example, `tanium-question-logs`).
   - **Region**: Select the AWS region where your S3 bucket is located.
   - **Key Prefix** : Enter a prefix for the S3 objects (for example, `tanium/question/`).
2. Click **Next**.

### Configure filters

1. In the **Filters** section, configure data filtering options:
   - **Send new items only**: Select this option to send only new question data since the last export.
   - **Column filters**: Add filters based on specific question attributes if needed (for example, filter by question type, user, or execution status).
2. Click **Next**.

### Format data for AWS S3

1. In the **Format** section, configure the data format:
   - **Format** : Select **JSON**.
   - **Options** :
     - **Include headers**: Deselect to avoid headers in JSON output.
     - **Include empty cells**: Select based on your preference.
   - **Advanced Options** :
     - **File naming**: Use default timestamp-based naming.
     - **Compression** : Select **Gzip** to reduce storage costs and transfer time.
2. Click **Next**.

### Schedule the connection

1. In the **Schedule** section, configure the export schedule:
   - **Enable schedule**: Select to enable automatic scheduled exports.
   - **Schedule type** : Select **Recurring**.
   - **Frequency** : Select **Every 30 minutes** for regular question audit data export.
   - **Start time**: Set appropriate start time for the first export.
2. Click **Next**.

### Save and verify connection

1. Review the connection configuration in the summary screen.
2. Click **Save** to create the connection.
3. Click **Test Connection** to verify the configuration.
4. If the test is successful, click **Run Now** to perform an initial export.
5. Monitor the connection status in the **Connect Overview** page.

## Configure a feed in Google SecOps to ingest Tanium Question logs

1. Go to **Settings \> Data Management \> Feeds** . If you are on a SIEM-only platform, go to **Settings \> Feeds**.
2. Click **+ Add New Feed**.
3. In the **Feed name** field, enter a name for the feed (for example, `Tanium Question logs`).
4. Select **Amazon S3 V2** as the **Source type**.
5. Select **Tanium Question** as the **Log type**.
6. Click **Next**.
7. Specify values for the following input parameters:
   - **S3 URI** : `s3://tanium-question-logs/tanium/question/`
   - **Source deletion options**: Select deletion option according to your preference.
   - **Maximum File Age**: Include files modified in the last number of days. Default is 180 days.
   - **Access Key ID**: User access key with access to the S3 bucket.
   - **Secret Access Key**: User secret key with access to the S3 bucket.
   - **Asset namespace** : The [asset namespace](https://docs.cloud.google.com/chronicle/docs/investigation/asset-namespaces).
   - **Ingestion labels**: The label applied to the events from this feed.
8. Click **Next**.
9. Review your new feed configuration in the **Finalize** screen, and then click **Submit**.

## UDM mapping table

| Log field | UDM mapping | Logic |
|---|---|---|
| `os_label` | `additional.fields` | Merged |
| `has_principal` | `extensions.auth.type` | Mapped: `true` → `AUTHTYPE_UNSPECIFIED` |
| `date` | `metadata.event_timestamp` | Parsed as `MMM dd HH:mm:ss` |
| `has_principal` | `metadata.event_type` | Mapped: `true` → `USER_LOGIN`, `true` → `STATUS_UPDATE` |
| `has_user` | `metadata.event_type` | Mapped: `true` → `USER_UNCATEGORIZED` |
| `eventtype` | `metadata.product_event_type` | Directly mapped |
| `src_app` | `principal.application` | Directly mapped |
| `comp_name` | `principal.asset.hostname` | Directly mapped |
| `src_hostname` | `principal.asset.hostname` | Directly mapped |
| `tanium_client_ip` | `principal.asset.ip` | Merged |
| `mac_address` | `principal.asset.mac` | Merged |
| `comp_name` | `principal.hostname` | Directly mapped |
| `src_hostname` | `principal.hostname` | Directly mapped |
| `tanium_client_ip` | `principal.ip` | Merged |
| `mac_address` | `principal.mac` | Merged |
| `user` | `principal.user.userid` | Directly mapped |
| `Ip` | `target.asset.ip` | Merged |
| `Ip` | `target.ip` | Merged |
| N/A | `extensions.auth.type` | Constant: `AUTHTYPE_UNSPECIFIED` |
| N/A | `metadata.event_type` | Constant: `USER_LOGIN` |
| N/A | `metadata.product_name` | Constant: `TANIUM_QUESTION` |

## Change Log

[View the Change Log for this parser](https://docs.cloud.google.com/chronicle/docs/ingestion/parser-list/tanium-question-changelog)

**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/)