catalyst

README

Catalyst

Speed up your reactions

Website - The Catalyst Handbook (Documentation) - Try online

Twitter - Discord

Catalyst is an incident response platform or SOAR (Security Orchestration, Automation and Response) system. It can help you to automate your alert handling and incident response procedures.

Features

Ticket (Alert & Incident) Management

Tickets are the core of Catalyst. They represent alerts, incidents, forensics investigations, threat hunts or any other event you want to handle in your organisation.

Ticket Templates

Templates define the custom information for tickets. The core information for tickets like title, creation date or closing status is kept quite minimal and other information like criticality, description or MITRE ATT&CK information can be added individually.

Conditional Custom Fields

Custom Fields can be dependent on each other. So if you, for example choose "malware" as an incident type a custom field ask you to define it further as ransomware, worm, etc. which a "phishing" incident would ask for the number of received mails in that campaign.

Playbooks

Playbooks represent processes that can be attached to tickets. Playbooks can contain manual and automated tasks. Complex workflows with different workflow branches, parallel tasks and task dependencies can be modeled.

Automations

Automations are scripts that automate tasks or enrich artifacts. Automations are run in their own Docker containers. This enables them to be created in different scripting languages and run securely in their own environment.

Dashboards

Catalyst comes with a dashboard editor that allows you to create custom dashboards for your organisation. Dashboards can be created with line, bar, and pie charts.

Users

Catalyst has two different types of users, normal users accessing the platform via OIDC authentication and API keys for external script. A fine-grained access model is available for both types and allows to define possible actions for each user.

License

Copyright (c) 2021-present Jonas Plum

Portions of this software are licensed as follows:

• All third party components incorporated into Catalyst are licensed under the original license provided by the owner of the applicable component. Those files contain a license notice on top of the file and are listed in the NOTICE file.
• Content outside the above-mentioned files above is available under the GNU Affero General Public License v3.0.

Documentation

Index

• Variables
• func Backup(catalystStorage *storage.Storage, c *database.Config, writer io.Writer) error
• func GetVersion() string
• func Restore(ctx context.Context, catalystStorage *storage.Storage, db *database.Database, ...) error
• type Config
• type Server
  • func New(hooks *hooks.Hooks, config *Config) (*Server, error)
• type WriterAtBuffer
  • func (fw WriterAtBuffer) WriteAt(p []byte, offset int64) (n int, err error)

Variables

var Admin = &maut.Role{
	Name: "admin",
	Permissions: append(engineer.Permissions,
		"backup:create",
		"backup:restore",
		"dashboard:write",
		"job:read",
		"job:write",
		"log:read",
		"settings:write",
		"ticket:delete",
		"user:write",
		"userdata:write",
	),
}

var VERSION string

Functions

func Backup

func Backup(catalystStorage *storage.Storage, c *database.Config, writer io.Writer) error

func GetVersion

func GetVersion() string

func Restore

func Restore(ctx context.Context, catalystStorage *storage.Storage, db *database.Database, c *database.Config, r io.Reader, size int64) error

Types

type Config

type Config struct {
	IndexPath string
	DB        *database.Config
	Storage   *storage.Config

	Auth            *maut.Config
	ExternalAddress string
	InternalAddress string
	Network         string
	Port            int
}

type Server

type Server struct {
	Bus     *bus.Bus
	DB      *database.Database
	Index   *index.Index
	Storage *storage.Storage
	Server  chi.Router
}

func New

func New(hooks *hooks.Hooks, config *Config) (*Server, error)

type WriterAtBuffer

type WriterAtBuffer struct {
	bytes.Buffer
}

func (WriterAtBuffer) WriteAt

func (fw WriterAtBuffer) WriteAt(p []byte, offset int64) (n int, err error)