Collect Jamf Threat Events logs

This document describes how you can collect Jamf Threat Events logs by setting up a Google Security Operations feed and how log fields map to Google SecOps Unified Data Model (UDM) fields. This document also lists the supported Jamf Threat Events version.

For more information, see Data ingestion to Google SecOps.

A typical deployment consists of Jamf Threat Events and the Google SecOps feed configured to send logs to Google SecOps. Each customer deployment can differ and might be more complex.

The deployment contains the following components:

• Jamf Protect: The Jamf Protect platform, configured with Jamf Security Cloud, where you collect network threat logs.

• Google SecOps feed: The Google SecOps feed that fetches logs from Jamf Protect and writes logs to Google SecOps.

• Google SecOps: Google SecOps retains and analyzes the logs from Jamf Protect.

An ingestion label identifies the parser which normalizes raw log data to structured UDM format. The information in this document applies to the parser with the JAMF_THREAT_EVENTS ingestion label.

Before you begin

Ensure you have the following prerequisites:

• A Jamf Protect Telemetry set up
• Jamf Protect version 4.0.0 or later
• All systems in the deployment architecture are configured with the UTC time zone.

Set up feeds

There are two different entry points to set up feeds in the Google SecOps platform:

• SIEM Settings > Feeds
• Content Hub > Content Packs

Set up feeds from SIEM Settings > Feeds

You can use either Amazon S3 or a webhook to set up an ingestion feed in Google SecOps, but we recommend using Amazon S3.

Set up an ingestion feed using Amazon S3

To configure multiple feeds for different log types within this product family, see Configure feeds by product.

To configure a single feed, follow these steps:

1. Go to SIEM Settings > Feeds.
2. Click Add New Feed.
3. On the next page, click Configure a single feed.
4. In the Feed name field, enter a name for the feed; for example, Jamf Threat Events Logs.
5. Select Amazon S3 as the Source Type.
6. To create a feed for Jamf Threat Events, select Jamf Protect Threat Events as the Log Type.
7. Click Next.
8. Save the feed and then Submit.
9. Copy the Feed ID from the feed name to use in Jamf Threat Events.

Set up an ingestion feed using a webhook

For Google Security Operations unified customers only:
To configure multiple feeds for different log types within this product family, see Configure multiple feeds.

For all customers:
To configure a single feed, follow these steps:

1. Go to SIEM Settings > Feeds.
2. Click Add New Feed.
3. On the next page, click Configure a single feed. Skip this step if you're using the Google SecOps SIEM-standalone platform.
4. In the Feed name field, enter a name for the feed; for example, Jamf Threat Events Logs.
5. In the Source Type list, select Webhook.
6. To create a feed for Jamf Threat Events, select Jamf Protect Threat Events as the Log Type.
7. Click Next.
8. Optional: Specify values for the following input parameters:
   • Split delimiter: The delimiter that is used to separate log lines, such as \n.
   • Asset namespace: The asset namespace.
   • Ingestion labels: The label to be applied to the events from this feed.
9. Click Next.
10. Review your new feed configuration in the Finalize screen, and then click Submit.
11. Click Generate Secret Key to generate a secret key to authenticate this feed.
12. Copy and store the secret key as you cannot view this secret again. You can generate a new secret key again, but regeneration of the secret key makes the previous secret key obsolete.
13. From the Details tab, copy the feed endpoint URL from the Endpoint Information field. You need to specify this endpoint URL in Jamf Threat Events application.
14. Click Done.
15. Specify the endpoint URL in Jamf Threat Events.

Set up feeds from the Content Hub

Specify values for the following fields:

• Region: The region where the Amazon S3 bucket is located.
• S3 URI: The bucket URI.
  • s3://your-log-bucket-name/
    • Replace your-log-bucket-name with the actual name of your S3 bucket.
• URI is a: Select either Directory or Directory which includes subdirectories, depending on your bucket structure.
• Source deletion options: Select the deletion option according to your ingestion preferences.

• Access Key ID: The user's access key with permissions to read from the S3 bucket.

• Secret Access Key: The user's secret key with permissions to read from the S3 bucket.

Advanced options

• Feed Name: A prepopulated value that identifies the feed.
• Source Type: Method used to collect logs into Google SecOps.
• Asset Namespace: Namespace associated with the feed.
• Ingestion Labels: Labels applied to all events from this feed.

Create an API key for a webhook feed

1. Go to Google Cloud console > Credentials.

   Go to Credentials

2. Click Create credentials, and then select API key.

3. Restrict the API key access to the Google Security Operations API.

Set up Jamf Security Cloud for a webhook feed

1. In the Jamf Security Cloud application, go to Integrations > Data Streams.
2. Click New Configuration.
3. Select Threat Events > Generic HTTP > Continue.
4. In the HTTP Connection Configuration section, select https as the default protocol.
5. Enter your server hostname in the Server Hostname/IP field, such as us-chronicle.googleapis.com.
6. Enter your server port in the Port field, such as 443.
7. Enter your web endpoint in the Endpoint field. (This is the Endpoint Information field that you copied from the webhook feed setup. It's already in the required format.)

8. In the Additional headers section, enter the following settings, where each header is a custom, case-sensitive header that you manually enter:

   • Header name: X-goog-api-key and click Create option X-goog-api-key
   • Header value insert: API_KEY (The API key to authenticate to Google SecOps.)
   • Header name: X-Webhook-Access-Key and click Create option X-Webhook-Access-Key
   • Header value insert: SECRET (The secret key that you generated to authenticate the feed.)

9. Click Test Configuration.

10. If successful, click Create Configuration.

For more information about Google SecOps feeds, see Create and manage feeds using the feed management UI. For information about requirements for each feed type, see Feed configuration API.

Supported Jamf Threat Events log formats

The Jamf Threat Events parser supports logs in JSON format.

Supported Jamf Threat Events sample logs

• JSON

  {
    "event": {
      "metadata": {
        "schemaVersion": "1.0",
        "vendor": "Jamf",
        "product": "Threat Events Stream"
      },
      "timestamp": "2023-01-11T13:10:40.410Z",
      "alertId": "debd2e4b-9da1-454e-952d-18a00b42ffce",
      "account": {
        "customerId": "dummycustomerid",
        "parentId": "dummyparentid",
        "name": "Jamf Internal Test Accounts (root) - Jamf - CE Security Team"
      },
      "device": {
        "deviceId": "e9671102-5ccf-4e66-a6b3-b117ba257d5f",
        "os": "UNKNOWN 13.2.1",
        "deviceName": "Mac (13.2.1)",
        "userDeviceName": "darrow",
        "externalId": "0c221ae4-50af-5e39-8275-4424cc87ab8e"
      },
      "eventType": {
        "id": "303",
        "description": "Risky Host/Domain - Malware",
        "name": "ACCESS_BAD_HOST"
      },
      "app": {
        "id": "ru.freeapps.calc",
        "name": "MyFreeCalculator",
        "version": "10.4",
        "sha1": "c3499c2729730a7f807efb8676a92dcb6f8a3f8f",
        "sha256": "50d858e0985ecc7f60418aaf0cc5ab587f42c2570a884095a9e8ccacd0f6545"
      },
      "destination": {
        "name": "dummy.domain.org",
        "ip": "0000:1111:2222:3333:4444:5",
        "port": "80"
      },
      "source": {
        "ip": "198.51.100.1",
        "port": "243"
      },
      "location": "GB",
      "accessPoint": null,
      "accessPointBssid": "23:8f:cf:00:9d:23",
      "severity": 8,
      "user": {
        "email": "test.user@domain.io",
        "name": "Test User"
      },
      "eventUrl": "dummy.domain.com",
      "action": "Blocked"
    }
  }
  

Field mapping reference

The following table explains how the Google SecOps parser maps Jamf Threat Events logs fields to Google SecOps Unified Data Model (UDM) fields.

Field mapping reference: Event Identifier to Event Type

The following table lists the JAMF_THREAT_EVENTS log types and their corresponding UDM event types.

Field mapping reference: JAMF_THREAT_EVENTS

The following table lists the log fields of the JAMF_THREAT_EVENTS log type and their corresponding UDM fields.

What's next

• Data ingestion to Google SecOps

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