Console
    Contact Us Start free

    Collect Tanium Reveal logs

    Supported in:

    This document explains how to ingest Tanium Reveal logs to Google Security Operations using Tanium Connect's native AWS S3 export functionality. Tanium Reveal produces sensitive data discovery alerts, compliance findings, and data classification results in JSON format, which can be directly exported to S3 using Tanium Connect without requiring custom Lambda functions. The parser processes the JSON logs, transforming them into the UDM format. It parses the JSON message, extracts fields like Computer ID, Computer Name, and Rule Name, maps them to UDM fields, and handles specific Reveal events like "Endpoints with Confirmed Sensitive Data" to populate security result details.

    Before you begin

    Make sure you have the following prerequisites:

    • A Google SecOps instance
    • Tanium Core Platform7.0 or later
    • Tanium Revealmodule installed and configured
    • Tanium Connectmodule installed with valid license
    • Tanium Trends3.6.343 or later for reporting integration
    • Privileged access to Tanium Consolewith administrative rights
    • Privileged access to AWS(S3, IAM)
    1. Sign in to the Tanium Console.
    2. Go to Modules > Reveal.
    3. Click Settingsat the top right.
    4. In the Service Accountsection, configure the following:
      • Service Account User: Select a user with appropriate Reveal permissions.
      • Verifythe account has Connect User role privilege.
      • Confirmaccess to Reveal data sources and rules.
    5. Click Saveto apply the service account configuration.

    Collect Tanium Reveal prerequisites

    1. Sign in to the Tanium Consoleas an administrator.
    2. Go to Administration > Permissions > Users.
    3. Create or identify a service account user with the following roles:
      • Reveal Administratoror Reveal Read Only Userrole.
      • Connect Userrole privilege.
      • Access to monitored computer groups (recommended: All Computersgroup).
      • Read Saved Questionpermission for Reveal content sets.

    Configure AWS S3 bucket and IAM for Google SecOps

    1. Create Amazon S3 bucketfollowing this user guide: Creating a bucket
    2. Save bucket Nameand Regionfor future reference (for example, tanium-reveal-logs ).
    3. Create a user following this user guide: Creating an IAM user .
    4. Select the created User.
    5. Select the Security credentialstab.
    6. Click Create Access Keyin the Access Keyssection.
    7. Select Third-party serviceas the Use case.
    8. Click Next.
    9. Optional: add a description tag.
    10. Click Create access key.
    11. Click Download CSV fileto save the Access Keyand Secret Access Keyfor later use.
    12. Click Done.
    13. Select the Permissionstab.
    14. Click Add permissionsin the Permissions policiessection.
    15. Select Add permissions.
    16. Select Attach policies directly
    17. Search for and select the AmazonS3FullAccesspolicy.
    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, Reveal Findings to S3 for SecOps ).
      • Description: Optional description (for example, Export sensitive data findings and compliance alerts 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 Sourcesection, provide the following configuration details:
      • Source Type: Select Saved Question.
      • Saved Question: Select one of the following Reveal-related saved questions:
        • Reveal - Endpoints with Confirmed Sensitive Datafor confirmed findings.
        • Reveal - Rule Matchesfor detailed rule match results.
        • Reveal - Data Classification Resultsfor data type classification.
        • Reveal - Compliance Findingsfor regulatory compliance status.
      • Computer Group: Select All Computersor specific computer groups to monitor.
      • Refresh Interval: Set appropriate interval for data collection (for example, 15 minutesfor sensitive data alerts).
    2. Click Next.

    Configure AWS S3 destination

    1. In the Destinationsection, provide the following configuration details:
      • Destination Type: Select AWS S3.
      • Destination Name: Enter a unique name (for example, Google SecOps Reveal 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-reveal-logs ).
      • Region: Select the AWS region where your S3 bucket is located.
      • Key Prefix: Enter a prefix for the S3 objects (for example, tanium/reveal/ ).
    2. Click Next.

    Configure filters

    1. In the Filterssection, configure data filtering options:
      • Send new items only: Select this option to send only new sensitive data findings since the last export.
      • Column filters: Add filters based on specific finding attributes if needed (for example, filter by rule severity, data type, or compliance framework).
    2. Click Next.

    Format data for AWS S3

    1. In the Formatsection, 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 Gzipto reduce storage costs and transfer time.
    2. Click Next.

    Schedule the connection

    1. In the Schedulesection, configure the export schedule:
      • Enable schedule: Select to enable automatic scheduled exports.
      • Schedule type: Select Recurring.
      • Frequency: Select Every 15 minutesfor timely sensitive data alerts.
      • 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 Saveto create the connection.
    3. Click Test Connectionto verify the configuration.
    4. If the test is successful, click Run Nowto perform an initial export.
    5. Monitor the connection status in the Connect Overviewpage.

    Configure a feed in Google SecOps to ingest Tanium Reveal logs

    1. Go to SIEM Settings > Feeds.
    2. Click + Add New Feed.
    3. In the Feed namefield, enter a name for the feed (for example, Tanium Reveal logs ).
    4. Select Amazon S3 V2as the Source type.
    5. Select Tanium Revealas the Log type.
    6. Click Next.
    7. Specify values for the following input parameters:
      • S3 URI: s3://tanium-reveal-logs/tanium/reveal/
      • 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 .
      • Ingestion labels: The label applied to the events from this feed.
    8. Click Next.
    9. Review your new feed configuration in the Finalizescreen, and then click Submit.

    Need more help? Get answers from Community members and Google SecOps professionals.

    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: