console

README

Console (Client)

Contains the entrypoint for the console client

Documentation

Index

• Constants
• func Start(rpc rpcpb.SliverRPCClient, bindCmds BindCmds, extraCmds BindCmds, ...) error
• type ActiveTarget
  • func (s *ActiveTarget) AddObserver(observer Observer) int
  • func (s *ActiveTarget) Background()
  • func (s *ActiveTarget) Get() (*clientpb.Session, *clientpb.Beacon)
  • func (s *ActiveTarget) GetBeacon() *clientpb.Beacon
  • func (s *ActiveTarget) GetBeaconInteractive() *clientpb.Beacon
  • func (s *ActiveTarget) GetInteractive() (*clientpb.Session, *clientpb.Beacon)
  • func (s *ActiveTarget) GetSession() *clientpb.Session
  • func (s *ActiveTarget) GetSessionInteractive() *clientpb.Session
  • func (s *ActiveTarget) IsSession() bool
  • func (s *ActiveTarget) RemoveObserver(observerID int)
  • func (s *ActiveTarget) Request(ctx *grumble.Context) *commonpb.Request
  • func (s *ActiveTarget) Set(session *clientpb.Session, beacon *clientpb.Beacon)
• type BeaconTaskCallback
• type BindCmds
• type Observer
• type SliverConsoleClient
  • func (con *SliverConsoleClient) AddBeaconCallback(taskID string, callback BeaconTaskCallback)
  • func (con *SliverConsoleClient) CheckLastUpdate()
  • func (con *SliverConsoleClient) CreateEventListener() (string, <-chan *clientpb.Event)
  • func (con *SliverConsoleClient) FormatDateDelta(t time.Time, includeDate bool, color bool) string
  • func (con *SliverConsoleClient) GetActiveSessionConfig() *clientpb.ImplantConfig
  • func (con *SliverConsoleClient) GetPrompt() string
  • func (con *SliverConsoleClient) GetSession(arg string) *clientpb.Session
  • func (con *SliverConsoleClient) GetSessionsByName(name string) []*clientpb.Session
  • func (con *SliverConsoleClient) PrintAsyncResponse(resp *commonpb.Response)
  • func (con *SliverConsoleClient) PrintErrorf(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) PrintEventErrorf(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) PrintEventInfof(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) PrintEventSuccessf(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) PrintInfof(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) PrintLogo()
  • func (con *SliverConsoleClient) PrintSuccessf(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) PrintWarnf(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) Printf(format string, args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) Println(args ...interface{}) (n int, err error)
  • func (con *SliverConsoleClient) RemoveEventListener(listenerID string)
  • func (con *SliverConsoleClient) SpinUntil(message string, ctrl chan bool)

Constants

const (
	// ANSI Colors
	Normal    = "\033[0m"
	Black     = "\033[30m"
	Red       = "\033[31m"
	Green     = "\033[32m"
	Orange    = "\033[33m"
	Blue      = "\033[34m"
	Purple    = "\033[35m"
	Cyan      = "\033[36m"
	Gray      = "\033[37m"
	Bold      = "\033[1m"
	Clearln   = "\r\x1b[2K"
	UpN       = "\033[%dA"
	DownN     = "\033[%dB"
	Underline = "\033[4m"

	// Info - Display colorful information
	Info = Bold + Cyan + "[*] " + Normal
	// Warn - Warn a user
	Warn = Bold + Red + "[!] " + Normal
	// Debug - Display debug information
	Debug = Bold + Purple + "[-] " + Normal
	// Woot - Display success
	Woot = Bold + Green + "[$] " + Normal
	// Success - Diplay success
	Success = Bold + Green + "[+] " + Normal
)

Functions

func Start

func Start(rpc rpcpb.SliverRPCClient, bindCmds BindCmds, extraCmds BindCmds, isServer bool) error

Start - Console entrypoint

Types

type ActiveTarget

type ActiveTarget struct {
	// contains filtered or unexported fields
}

func (*ActiveTarget) AddObserver

func (s *ActiveTarget) AddObserver(observer Observer) int

AddObserver - Observers to notify when the active session changes

func (*ActiveTarget) Background

func (s *ActiveTarget) Background()

Background - Background the active session

func (*ActiveTarget) Get

func (s *ActiveTarget) Get() (*clientpb.Session, *clientpb.Beacon)

GetSessionInteractive - Get the active target(s)

func (*ActiveTarget) GetBeacon

func (s *ActiveTarget) GetBeacon() *clientpb.Beacon

GetBeacon - Same as GetBeacon() but doesn't print a warning

func (*ActiveTarget) GetBeaconInteractive

func (s *ActiveTarget) GetBeaconInteractive() *clientpb.Beacon

GetBeaconInteractive - Get beacon interactive the active session

func (*ActiveTarget) GetInteractive

func (s *ActiveTarget) GetInteractive() (*clientpb.Session, *clientpb.Beacon)

GetSessionInteractive - Get the active target(s)

func (*ActiveTarget) GetSession

func (s *ActiveTarget) GetSession() *clientpb.Session

GetSession - Same as GetSession() but doesn't print a warning

func (*ActiveTarget) GetSessionInteractive

func (s *ActiveTarget) GetSessionInteractive() *clientpb.Session

GetSessionInteractive - GetSessionInteractive the active session

func (*ActiveTarget) IsSession

func (s *ActiveTarget) IsSession() bool

IsSession - Is the current target a session?

func (*ActiveTarget) RemoveObserver

func (s *ActiveTarget) RemoveObserver(observerID int)

func (*ActiveTarget) Request

func (s *ActiveTarget) Request(ctx *grumble.Context) *commonpb.Request

func (*ActiveTarget) Set

func (s *ActiveTarget) Set(session *clientpb.Session, beacon *clientpb.Beacon)

Set - Change the active session

type BeaconTaskCallback

type BeaconTaskCallback func(*clientpb.BeaconTask)

type BindCmds

type BindCmds func(console *SliverConsoleClient)

BindCmds - Bind extra commands to the app object

type Observer

type Observer func(*clientpb.Session, *clientpb.Beacon)

Observer - A function to call when the sessions changes

type SliverConsoleClient

type SliverConsoleClient struct {
	App                      *grumble.App
	Rpc                      rpcpb.SliverRPCClient
	ActiveTarget             *ActiveTarget
	EventListeners           *sync.Map
	BeaconTaskCallbacks      map[string]BeaconTaskCallback
	BeaconTaskCallbacksMutex *sync.Mutex
	IsServer                 bool
	Settings                 *assets.ClientSettings
}

func (*SliverConsoleClient) AddBeaconCallback

func (con *SliverConsoleClient) AddBeaconCallback(taskID string, callback BeaconTaskCallback)

func (*SliverConsoleClient) CheckLastUpdate

func (con *SliverConsoleClient) CheckLastUpdate()

func (*SliverConsoleClient) CreateEventListener

func (con *SliverConsoleClient) CreateEventListener() (string, <-chan *clientpb.Event)

func (*SliverConsoleClient) FormatDateDelta

func (con *SliverConsoleClient) FormatDateDelta(t time.Time, includeDate bool, color bool) string

FormatDateDelta - Generate formatted date string of the time delta between then and now

func (*SliverConsoleClient) GetActiveSessionConfig

func (con *SliverConsoleClient) GetActiveSessionConfig() *clientpb.ImplantConfig

GetActiveSessionConfig - Get the active sessions's config TODO: Switch to query config based on ConfigID

func (*SliverConsoleClient) GetPrompt

func (con *SliverConsoleClient) GetPrompt() string

func (*SliverConsoleClient) GetSession

func (con *SliverConsoleClient) GetSession(arg string) *clientpb.Session

GetSession - Get session by session ID or name

func (*SliverConsoleClient) GetSessionsByName

func (con *SliverConsoleClient) GetSessionsByName(name string) []*clientpb.Session

GetSessionsByName - Return all sessions for an Implant by name

func (*SliverConsoleClient) PrintAsyncResponse

func (con *SliverConsoleClient) PrintAsyncResponse(resp *commonpb.Response)

PrintAsyncResponse - Print the generic async response information

func (*SliverConsoleClient) PrintErrorf

func (con *SliverConsoleClient) PrintErrorf(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) PrintEventErrorf

func (con *SliverConsoleClient) PrintEventErrorf(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) PrintEventInfof

func (con *SliverConsoleClient) PrintEventInfof(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) PrintEventSuccessf

func (con *SliverConsoleClient) PrintEventSuccessf(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) PrintInfof

func (con *SliverConsoleClient) PrintInfof(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) PrintLogo

func (con *SliverConsoleClient) PrintLogo()

func (*SliverConsoleClient) PrintSuccessf

func (con *SliverConsoleClient) PrintSuccessf(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) PrintWarnf

func (con *SliverConsoleClient) PrintWarnf(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) Printf

func (con *SliverConsoleClient) Printf(format string, args ...interface{}) (n int, err error)

func (*SliverConsoleClient) Println

func (con *SliverConsoleClient) Println(args ...interface{}) (n int, err error)

func (*SliverConsoleClient) RemoveEventListener

func (con *SliverConsoleClient) RemoveEventListener(listenerID string)

func (*SliverConsoleClient) SpinUntil

func (con *SliverConsoleClient) SpinUntil(message string, ctrl chan bool)