multiproto

README

multi protocol execution

Implementation

when template is unmarshalled, if it uses more than one protocol, then order of protocols is preserved and is same is passed to Executor multiproto is engine/backend for TemplateExecutor which takes care of sharing logic between protocols and executing them in order

Execution

when multi protocol template is executed , all protocol requests present in Queue are executed in order and dynamic values extracted are added to template context.

• Protocol Responses apart from extracted internal:true values response fields/values of protocol are added to template context at ExecutorOptions.TemplateCtx which takes care of sync and other issues if any. all response fields are prefixed with template type prefix ex: ssl_subject_dn

Adding New Protocol to multi protocol execution logic

while logic/implementation of multi protocol execution is abstracted. it requires 3 statements to be added in newly implemented protocol to make response fields of that protocol available to global context

• Add request.options.GetTemplateCtx(f.input.MetaInput).GetAll() to variablesMap in ExecuteWithResults Method just above request.options.Variables.Evaluate

// example
	values := generators.MergeMaps(payloadValues, hostnameVariables, request.options.GetTemplateCtx(f.input.MetaInput).GetAll())
	variablesMap := request.options.Variables.Evaluate(values)

• Add all response fields to template context just after response map is available

	outputEvent := request.responseToDSLMap(compiledRequest, response, domain, question, traceData)
	// expose response variables in proto_var format
	// this is no-op if the template is not a multi protocol template
	request.options.AddTemplateVars(request.Type(),request.ID, outputEvent)

• Append all available template context values to outputEvent

	// add variables from template context before matching/extraction
	outputEvent = generators.MergeMaps(outputEvent, request.options.GetTemplateCtx(f.input.MetaInput).GetAll())

adding these 3 statements takes care of all logic related to multi protocol execution

Exceptions

• statements 1 & 2 are intentionally skipped in file protocol to avoid redundant data
  • file/dir input paths don't contain variables or are used in path (yet)
  • since files are processed by scanning each line. adding statement 2 will unintenionally load all file(s) data

Documentation

Index

• type MultiProtocol
  • func NewMultiProtocol(requests []protocols.Request, options *protocols.ExecutorOptions, ...) *MultiProtocol
  • func (m *MultiProtocol) Compile() error
  • func (m *MultiProtocol) ExecuteWithResults(ctx *scan.ScanContext) error
  • func (m *MultiProtocol) Name() string

Types

type MultiProtocol

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

Mutliprotocol is a template executer engine that executes multiple protocols with logic in between

func NewMultiProtocol

func NewMultiProtocol(requests []protocols.Request, options *protocols.ExecutorOptions, results *atomic.Bool) *MultiProtocol

NewMultiProtocol creates a new multiprotocol template engine from a list of requests

func (*MultiProtocol) Compile

func (m *MultiProtocol) Compile() error

Compile engine specific compilation

func (*MultiProtocol) ExecuteWithResults

func (m *MultiProtocol) ExecuteWithResults(ctx *scan.ScanContext) error

ExecuteWithResults executes the template and returns results

func (*MultiProtocol) Name

func (m *MultiProtocol) Name() string

Name of the template engine