If you haven’t installed Tracecat yet, please check out our self-hosting docs for step-by-step deployment instructions.

Introduction

By the end of this quickstart, you will:

  • Create a new workflow
  • Add a secret credential that allows Tracecat to access the VirusTotal API
  • Use integrations to automate a simple threat enrichment playbook, learn to work with Tracecat’s built-in case management system, and run the workflow live.

Let’s get started!

Prerequisites

Tutorial

1

Log into Tracecat

If you are working with a brand new Tracecat deployment, you can find the default admin user’s email and password in the authentication docs.

2

Create a new workflow

3

Rename workflow

Rename the workflow and save the changes by clicking on the save button.

4

Add enrichment step

From the trigger action, search and select the VirusTotal Search URL with VirusTotal integration.

5

Pass URL from webhook into Search URL action inputs

Tracecat comes with a powerful templating language called “expressions” to manipulate data directly in action inputs. You can find out more here in our docs.

Use expressions and JSONPath match syntax to select data from the webhook trigger.

Fill in inputs with the following:

url: ${{ FN.to_base64(TRIGGER.url_input) }}

You’ll need to Base64 encode the URL input using a the to_base64 function.

Make sure to save the action inputs by clicking on the Save button at the top right of the action panel.

6

Add secret

Add your VirusTotal API key to workspace secrets. For the integration to work, you’ll need to name the secret virustotal and assign your API token to a VIRUSTOTAL_API_KEY secret key.

7

Commit (AKA save) workflow

This publishes a live version of your workflow.

8

Trigger workflow

You can now trigger the workflow with a JSON payload directly from the UI. For this demo, we use the following sample payload:

{"url_input": "https://crowdstrikebluescreen.com"}

9

View workflow context

Every workflow run comes with context about every step executed in the workflow. You can view this information by switching to the Runs tab.

10

Congratulations!

🎉 Congratulations on running your first security workflow in Tracecat! Come join us on Discord to discuss new playbook and integration ideas.