new: mac.changer module

main.go

@@ -22,6 +22,7 @@ func main() {
 	fmt.Printf(core.Bold("%s v%s\n\n"), core.Name, core.Version)
 
 	sess.Register(modules.NewEventsStream(sess))
+	sess.Register(modules.NewMacChanger(sess))
 	sess.Register(modules.NewProber(sess))
 	sess.Register(modules.NewDiscovery(sess))
 	sess.Register(modules.NewArpSpoofer(sess))

modules/mac_changer.go

@@ -0,0 +1,116 @@
+package modules
+
+import (
+	"fmt"
+	"net"
+	"runtime"
+	"strings"
+
+	"github.com/evilsocket/bettercap-ng/core"
+	"github.com/evilsocket/bettercap-ng/log"
+	bnet "github.com/evilsocket/bettercap-ng/net"
+	"github.com/evilsocket/bettercap-ng/session"
+)
+
+type MacChanger struct {
+	session.SessionModule
+	originalMac net.HardwareAddr
+	fakeMac     net.HardwareAddr
+}
+
+func NewMacChanger(s *session.Session) *MacChanger {
+	mc := &MacChanger{
+		SessionModule: session.NewSessionModule("mac.changer", s),
+	}
+
+	mc.AddParam(session.NewStringParameter("mac.changer.address",
+		session.ParamRandomMAC,
+		"[a-fA-F0-9]{2}:[a-fA-F0-9]{2}:[a-fA-F0-9]{2}:[a-fA-F0-9]{2}:[a-fA-F0-9]{2}:[a-fA-F0-9]{2}",
+		"Hardware address to apply to the interface."))
+
+	mc.AddHandler(session.NewModuleHandler("mac.changer on", "",
+		"Start mac changer module.",
+		func(args []string) error {
+			return mc.Start()
+		}))
+
+	mc.AddHandler(session.NewModuleHandler("mac.changer off", "",
+		"Stop mac changer module and restore original mac address.",
+		func(args []string) error {
+			return mc.Stop()
+		}))
+
+	return mc
+}
+
+func (mc *MacChanger) Name() string {
+	return "mac.changer"
+}
+
+func (mc *MacChanger) Description() string {
+	return "Change active interface mac address."
+}
+
+func (mc *MacChanger) Author() string {
+	return "Simone Margaritelli <evilsocket@protonmail.com>"
+}
+
+func (mc *MacChanger) Configure() (err error) {
+	var changeTo string
+
+	if err, changeTo = mc.StringParam("mac.changer.address"); err != nil {
+		return err
+	}
+
+	changeTo = bnet.NormalizeMac(changeTo)
+	if mc.fakeMac, err = net.ParseMAC(changeTo); err != nil {
+		return err
+	}
+
+	mc.originalMac = mc.Session.Interface.HW
+
+	return nil
+}
+
+func (mc *MacChanger) setMac(mac net.HardwareAddr) error {
+	os := runtime.GOOS
+	args := []string{}
+
+	if strings.Contains(os, "bsd") || os == "darwin" {
+		args = []string{mc.Session.Interface.Name(), "ether", mac.String()}
+	} else if os == "linux" {
+		args = []string{mc.Session.Interface.Name(), "hw", "ether", mac.String()}
+	} else {
+		return fmt.Errorf("OS %s not supported by mac.changer module.", os)
+	}
+
+	_, err := core.Exec("ifconfig", args)
+	return err
+}
+
+func (mc *MacChanger) Start() error {
+	if mc.Running() == true {
+		return session.ErrAlreadyStarted
+	} else if err := mc.Configure(); err != nil {
+		return err
+	} else if err := mc.setMac(mc.fakeMac); err != nil {
+		return err
+	}
+
+	mc.SetRunning(true)
+	log.Info("Interface mac address set to %s", core.Bold(mc.fakeMac.String()))
+
+	return nil
+}
+
+func (mc *MacChanger) Stop() error {
+	if mc.Running() == false {
+		return session.ErrAlreadyStopped
+	} else if err := mc.setMac(mc.originalMac); err != nil {
+		return err
+	}
+
+	mc.SetRunning(false)
+	log.Info("Interface mac address restored to %s", core.Bold(mc.originalMac.String()))
+	return nil
+}

session/module_param.go

@@ -1,7 +1,9 @@
 package session
 
 import (
+	"crypto/rand"
 	"fmt"
+	"net"
 	"regexp"
 	"strconv"
 	"strings"
@@ -82,6 +84,7 @@ func (p ModuleParam) Validate(value string) (error, interface{}) {
 
 const ParamIfaceAddress = "<interface address>"
 const ParamSubnet = "<entire subnet>"
+const ParamRandomMAC = "<random mac>"
 
 func (p ModuleParam) Get(s *Session) (error, interface{}) {
 	var v string
@@ -97,6 +100,10 @@ func (p ModuleParam) Get(s *Session) (error, interface{}) {
 		v = s.Interface.IpAddress
 	} else if v == ParamSubnet {
 		v = s.Interface.CIDR()
+	} else if v == ParamRandomMAC {
+		hw := make([]byte, 6)
+		rand.Read(hw)
+		v = net.HardwareAddr(hw).String()
 	}
 
 	err, obj = p.Validate(v)