passive

package
v2.16.0 Latest Latest
Warning

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

Go to latest
Published: Aug 22, 2026 License: MIT Imports: 66 Imported by: 16

Documentation

Overview

Package passive provides capability for doing passive subdomain enumeration on targets.

Index

Constants

This section is empty.

Variables

View Source
var NameSourceMap = make(map[string]subscraping.Source, len(AllSources))

Functions

This section is empty.

Types

type Agent

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

Agent is a struct for running passive subdomain enumeration against a given host. It wraps subscraping package and provides a layer to build upon.

func New

func New(sourceNames, excludedSourceNames []string, useAllSources, useSourcesSupportingRecurse bool) *Agent

New creates a new agent for passive subdomain discovery

func (*Agent) EnumerateSubdomains

func (a *Agent) EnumerateSubdomains(domain string, proxy string, rateLimit int, timeout int, maxEnumTime time.Duration, options ...EnumerateOption) chan subscraping.Result

EnumerateSubdomains wraps EnumerateSubdomainsWithCtx with an empty context

func (*Agent) EnumerateSubdomainsWithCtx

func (a *Agent) EnumerateSubdomainsWithCtx(ctx context.Context, domain string, proxy string, rateLimit int, timeout int, maxEnumTime time.Duration, options ...EnumerateOption) chan subscraping.Result

EnumerateSubdomainsWithCtx enumerates all the subdomains for a given domain

func (*Agent) GetStatistics

func (a *Agent) GetStatistics() map[string]subscraping.Statistics

type EnumerateOption

type EnumerateOption func(opts *EnumerationOptions)

func WithCustomRateLimit

func WithCustomRateLimit(crl *subscraping.CustomRateLimit) EnumerateOption

func WithMaxResponseBodySize added in v2.16.0

func WithMaxResponseBodySize(maxResponseBodySize int64) EnumerateOption

WithMaxResponseBodySize sets a cap on bytes read from passive-source HTTP response bodies. A value of 0 (the default) means no limit.

func WithMaxResults added in v2.15.0

func WithMaxResults(maxResults int) EnumerateOption

WithMaxResults sets a per-source limit on the number of results emitted. A value of 0 (the default) means no limit. Sources that paginate can honor this to avoid unnecessary requests (e.g. to stay within API quotas).

type EnumerationOptions

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

Jump to

Keyboard shortcuts

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