c2

Documentation

Index

• Constants
• Variables
• func CreateFlags(implementation Impl)
• type Impl
  • func AddC2(name string) Impl
  • func StringToImpl(c2Name string) (Impl, bool)
• type Interface
  • func GetInstance(implementation Impl) (Interface, bool)

Constants

const (
	InvalidCategory           category = -1
	SimpleShellServerCategory category = 0
	SimpleShellClientCategory category = 1
	SSLShellServerCategory    category = 2
	HTTPServeFileCategory     category = 3
	HTTPServeShellCategory    category = 4
	ExternalCategory          category = 5
	ShellTunnelCategory       category = 6
)

Variables

var (
	SimpleShellServer = internalSupported["SimpleShellServer"]
	SimpleShellClient = internalSupported["SimpleShellClient"]
	SSLShellServer    = internalSupported["SSLShellServer"]
	HTTPServeFile     = internalSupported["HTTPServeFile"]
	HTTPServeShell    = internalSupported["HTTPServeShell"]
	ShellTunnel       = internalSupported["ShellTunnel"]
)

Simplified names in order to keep the old calling convention and allow for quick references in supported C2 functions.

Functions

func CreateFlags

func CreateFlags(implementation Impl)

Call into the c2 impl so that it can create command line flags.

Types

type Impl

type Impl struct {
	Name     string
	Category category
}

Internal representation of a C2 implementation. Each C2 is managed by the framework by the Impl struct type and should be unique.

func AddC2

func AddC2(name string) Impl

Add an external C2 to the supported list. Use this to integrate a new C2 into the framework. This is expected to be called early in the configuration process in order to expose the name of the C2 to the rest of the framework.

func StringToImpl

func StringToImpl(c2Name string) (Impl, bool)

Return the internal representation of a C2 from a string.

type Interface

type Interface interface {
	CreateFlags()
	Init(channel channel.Channel) bool
	Run(timeout int)
}

An interface used by both reverse shells, bind shells, and stagers.

func GetInstance

func GetInstance(implementation Impl) (Interface, bool)

Factory pattern for creating c2 interfaces. Note that this is returning an interface, which is a bit anti-Go but it's more or less exactly what we want so.