// Package telnet provides a zgrab2 module that scans for telnet daemons. // Default Port: 23 (TCP) // // The --max-read-size flag allows setting a ceiling to the number of bytes // that will be read for the banner. // // The scan negotiates the options and attempts to grab the banner, using the // same behavior as the original zgrab. // // The output contains the banner and the negotiated options, in the same // format as the original zgrab. package telnet import ( log "github.com/sirupsen/logrus" "github.com/zmap/zgrab2" ) // Flags holds the command-line configuration for the Telnet scan module. // Populated by the framework. type Flags struct { zgrab2.BaseFlags MaxReadSize int `long:"max-read-size" description:"Set the maximum number of bytes to read when grabbing the banner" default:"65536"` Verbose bool `long:"verbose" description:"More verbose logging, include debug fields in the scan results"` } // Module implements the zgrab2.Module interface. type Module struct { } // Scanner implements the zgrab2.Scanner interface. type Scanner struct { config *Flags } // RegisterModule registers the zgrab2 module. func RegisterModule() { var module Module _, err := zgrab2.AddCommand("telnet", "telnet", "Probe for telnet", 23, &module) if err != nil { log.Fatal(err) } } // NewFlags returns a default Flags object. func (module *Module) NewFlags() interface{} { return new(Flags) } // NewScanner returns a new Scanner instance. func (module *Module) NewScanner() zgrab2.Scanner { return new(Scanner) } // Validate checks that the flags are valid. // On success, returns nil. // On failure, returns an error instance describing the error. func (flags *Flags) Validate(args []string) error { return nil } // Help returns the module's help string. func (flags *Flags) Help() string { return "" } // Init initializes the Scanner. func (scanner *Scanner) Init(flags zgrab2.ScanFlags) error { f, _ := flags.(*Flags) scanner.config = f return nil } // InitPerSender initializes the scanner for a given sender. func (scanner *Scanner) InitPerSender(senderID int) error { return nil } // GetName returns the Scanner name defined in the Flags. func (scanner *Scanner) GetName() string { return scanner.config.Name } // GetTrigger returns the Trigger defined in the Flags. func (scanner *Scanner) GetTrigger() string { return scanner.config.Trigger } // Protocol returns the protocol identifier of the scan. func (scanner *Scanner) Protocol() string { return "telnet" } // Scan connects to the target (default port TCP 23) and attempts to grab the Telnet banner. func (scanner *Scanner) Scan(target zgrab2.ScanTarget) (zgrab2.ScanStatus, interface{}, error) { conn, err := target.Open(&scanner.config.BaseFlags) if err != nil { return zgrab2.TryGetScanStatus(err), nil, err } defer conn.Close() result := new(TelnetLog) if err := GetTelnetBanner(result, conn, scanner.config.MaxReadSize); err != nil { return zgrab2.TryGetScanStatus(err), result.getResult(), err } return zgrab2.SCAN_SUCCESS, result, nil }