Home

Awesome

</p> <p align="center"> <a href="https://github.com/splunk/security_content/releases"> <img src="https://img.shields.io/github/v/release/splunk/security_content" /></a> <a href="https://github.com/splunk/security_content/actions/workflows/build-and-validate.yml/badge.svg?branch=develop"> <img src="https://img.shields.io/github/workflow/status/splunk/security_content/build-and-validate/develop" /></a> <a href="https://github.com/splunk/security_content"> <img src="https://security-content.s3-us-west-2.amazonaws.com/reporting/detection_count.svg" /></a> <a href="https://github.com/splunk/security_content"> <img src="https://security-content.s3-us-west-2.amazonaws.com/reporting/detection_coverage.svg" /></a> <a href="https://github.com/splunk/security_content"> <img src="https://img.shields.io/github/downloads/splunk/security_content/total" /></a> <a href="https://github.com/splunk/security_content/graphs/contributors" alt="Contributors"> <img src="https://img.shields.io/github/contributors/splunk/security_content" /></a> <a href="https://github.com/splunk/security_content/stargazers"> <img src="https://img.shields.io/github/stars/splunk/security_content?style=social" /></a> </p>

Splunk Security Content

security_content

Welcome to the Splunk Security Content

This project gives you access to our repository of Analytic Stories, security guides that provide background on tactics, techniques and procedures (TTPs), mapped to the MITRE ATT&CK Framework, the Lockheed Martin Cyber Kill Chain, and CIS Controls. They include Splunk searches, machine learning algorithms and Splunk Phantom playbooks (where available)—all designed to work together to detect, investigate, and respond to threats.

Get Content🛡

The latest Splunk Security Content can be obtained via:

SSE App

Grab the latest release of Splunk Security Essentials App and install it on a Splunk instance. You can download it from splunkbase, it is a Splunk Supported App. SSE Splunk app today supports push updates for security content release, this is the preferred way to get content!

ESCU App

Grab the latest release of DA-ESS-ContentUpdate.spl and install it on a Splunk instance. Alternatively, you can download it from splunkbase, it is currently a Splunk Supported App.

API

curl -s https://content.splunkresearch.com | jq
{
  "hello": "welcome to Splunks Research security content api"
}

Usage 🧰

contentctl.py

The Content Control tool allows you to manipulate Splunk Security Content via the following actions:

  1. new - Creates new content (detection, story, baseline)
  2. validate - Validates written content
  3. generate - Generates a deployment package for different platforms (splunk_app)

pre-requisites

git clone git@github.com:splunk/security_content.git
cd security_content
pip install virtualenv
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

create a new detection

python contentctl.py new

for a more indepth write up on how to write content see our guide.

create a new analytic story

python contentctl.py new -t story

validate written content a new analytic story

python contentctl.py --verbose validate

generate a splunk app from current content

python contentctl.py --path . --verbose generate --output package

MITRE ATT&CK ⚔️

Detection Coverage

To view an up-to-date detection coverage map for all the content tagged with MITRE techniques visit: https://mitremap.splunkresearch.com/ under the Detection Coverage layer. Below is a snapshot in time of what technique we currently have some detection coverage for. The darker the shade of blue the more detections we have for this particular technique. This map is automatically updated on every release and generated from the generate-coverage-map.py.

Customize to your Environment 🏗

Customize your content to change how often detections run, or what the right source type for sysmon in your environment is please follow this guide.

What's in an Analytic Story? 🗺

A complete use case, specifically built to detect, investigate, and respond to a specific threat like Credential Dumping or Ransomware. A group of detections and a response make up an analytic story, they are associated with the tag analytic_story: <name>.

Content Parts 🧩

Contribution 🥰

We welcome feedback and contributions from the community! Please see our contributing to the project for more information on how to get involved.

Support 💪

Please use the GitHub Issue Tracker to submit bugs or request features.

If you have questions or need support, you can:

License

Copyright 2020 Splunk Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.