oob

package
v0.4.14 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 28, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Overview

Package oob provides an out-of-band application security testing (OAST) listener: a small HTTP server that Scout points a payload's callback URL at, so a *blind* vulnerability — blind SSRF, blind command injection, XXE — is confirmed by observing the target call back, correlated by a unique token.

This is detection, not exploitation: Scout only observes the inbound request. The listener is Scout's own (no third-party interaction service like interactsh), so nothing ever leaves the operator's environment.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func NewToken

func NewToken() string

NewToken returns a random, URL-safe correlation token.

Types

type Interaction

type Interaction struct {
	At         time.Time
	RemoteAddr string
	Method     string
	Path       string
	UserAgent  string
}

Interaction is one inbound request the listener recorded.

type Listener

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

Listener is a running OAST HTTP server that records callbacks by token.

func Start

func Start(_ context.Context, publicBase string) (*Listener, error)

Start begins an OAST listener. publicBase, when set, is the base URL the target can reach back on (e.g. "http://10.0.0.5:9999" or "http://host.docker.internal:9999"); the server binds that port on all interfaces. When empty, the listener binds an ephemeral 127.0.0.1 port and uses it as the callback base — which works when the target runs on the same host.

func (*Listener) Close

func (l *Listener) Close()

Close shuts the listener down.

func (*Listener) Hits

func (l *Listener) Hits(token string) []Interaction

Hits returns a copy of the interactions recorded for a token.

func (*Listener) ServeHTTP

func (l *Listener) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP records every inbound request, keyed by the first path segment (the correlation token), and answers with a tiny body.

func (*Listener) URL

func (l *Listener) URL(token string) string

URL returns the callback URL that carries a token.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL