Documentation
¶
Overview ¶
Package service implements service fingerprinting functionality for discovering running services.
Index ¶
- func RunServiceFingerprint(ctx context.Context, config discoverfern.DiscoverServiceConfig) (*discoverfern.DiscoverServiceReport, error)
- func RunTCPServiceFingerprint(ctx context.Context, config discoverfern.DiscoverServiceConfig) (*discoverfern.DiscoverServiceReport, error)
- func RunUDPServiceFingerprint(ctx context.Context, config discoverfern.DiscoverServiceConfig) (*discoverfern.DiscoverServiceReport, error)
- type Fingerprinter
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func RunServiceFingerprint ¶
func RunServiceFingerprint(ctx context.Context, config discoverfern.DiscoverServiceConfig) (*discoverfern.DiscoverServiceReport, error)
RunServiceFingerprint fingerprints services using the transport selected in config. New callers should prefer RunTCPServiceFingerprint or RunUDPServiceFingerprint directly.
func RunTCPServiceFingerprint ¶ added in v0.12.0
func RunTCPServiceFingerprint(ctx context.Context, config discoverfern.DiscoverServiceConfig) (*discoverfern.DiscoverServiceReport, error)
RunTCPServiceFingerprint fingerprints the TCP service at target:port.
- If stealth mode is enabled, use targeted fingerprinting for the specified service type.
- Otherwise, for TCP (port-priority system): Phase 1: Run custom fingerprinters ONLY if port matches their default ports Phase 2: Run fingerprintx (which has its own port priority) Phase 3: If nothing found, run custom fingerprinters on all ports (comprehensive fallback)
func RunUDPServiceFingerprint ¶ added in v0.12.0
func RunUDPServiceFingerprint(ctx context.Context, config discoverfern.DiscoverServiceConfig) (*discoverfern.DiscoverServiceReport, error)
RunUDPServiceFingerprint scans common UDP ports on one or more target hosts.
Types ¶
type Fingerprinter ¶
type Fingerprinter interface {
Name() string
Detect(ctx context.Context, ip net.IP, port int, host string, timeout int) (*discoverfern.ServiceDetails, error)
// DefaultPorts returns the list of default ports for this service
// Empty list means the service can run on any port (no port restrictions)
DefaultPorts() []int
}
Fingerprinter detects **one** specific application protocol (gRPC, MQTT, …). On match: (*ServiceDetails, nil) On "not mine": (nil, nil) On fatal error: (nil, err)
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.