package nebula import ( "context" "net" "os" "os/signal" "syscall" "github.com/sirupsen/logrus" "github.com/slackhq/nebula/cert" "github.com/slackhq/nebula/header" "github.com/slackhq/nebula/iputil" "github.com/slackhq/nebula/udp" ) // Every interaction here needs to take extra care to copy memory and not return or use arguments "as is" when touching // core. This means copying IP objects, slices, de-referencing pointers and taking the actual value, etc type Control struct { f *Interface l *logrus.Logger cancel context.CancelFunc sshStart func() statsStart func() dnsStart func() } type ControlHostInfo struct { VpnIp net.IP `json:"vpnIp"` LocalIndex uint32 `json:"localIndex"` RemoteIndex uint32 `json:"remoteIndex"` RemoteAddrs []*udp.Addr `json:"remoteAddrs"` CachedPackets int `json:"cachedPackets"` Cert *cert.NebulaCertificate `json:"cert"` MessageCounter uint64 `json:"messageCounter"` CurrentRemote *udp.Addr `json:"currentRemote"` CurrentRelaysToMe []iputil.VpnIp `json:"currentRelaysToMe"` CurrentRelaysThroughMe []iputil.VpnIp `json:"currentRelaysThroughMe"` } // Start actually runs nebula, this is a nonblocking call. To block use Control.ShutdownBlock() func (c *Control) Start() { // Activate the interface c.f.activate() // Call all the delayed funcs that waited patiently for the interface to be created. if c.sshStart != nil { go c.sshStart() } if c.statsStart != nil { go c.statsStart() } if c.dnsStart != nil { go c.dnsStart() } // Start reading packets. c.f.run() } // Stop signals nebula to shutdown, returns after the shutdown is complete func (c *Control) Stop() { // Stop the handshakeManager (and other serivces), to prevent new tunnels from // being created while we're shutting them all down. c.cancel() c.CloseAllTunnels(false) if err := c.f.Close(); err != nil { c.l.WithError(err).Error("Close interface failed") } c.l.Info("Goodbye") } // ShutdownBlock will listen for and block on term and interrupt signals, calling Control.Stop() once signalled func (c *Control) ShutdownBlock() { sigChan := make(chan os.Signal) signal.Notify(sigChan, syscall.SIGTERM) signal.Notify(sigChan, syscall.SIGINT) rawSig := <-sigChan sig := rawSig.String() c.l.WithField("signal", sig).Info("Caught signal, shutting down") c.Stop() } // RebindUDPServer asks the UDP listener to rebind it's listener. Mainly used on mobile clients when interfaces change func (c *Control) RebindUDPServer() { _ = c.f.outside.Rebind() // Trigger a lighthouse update, useful for mobile clients that should have an update interval of 0 c.f.lightHouse.SendUpdate(c.f) // Let the main interface know that we rebound so that underlying tunnels know to trigger punches from their remotes c.f.rebindCount++ } // ListHostmap returns details about the actual or pending (handshaking) hostmap func (c *Control) ListHostmap(pendingMap bool) []ControlHostInfo { if pendingMap { return listHostMap(c.f.handshakeManager.pendingHostMap) } else { return listHostMap(c.f.hostMap) } } // GetHostInfoByVpnIp returns a single tunnels hostInfo, or nil if not found func (c *Control) GetHostInfoByVpnIp(vpnIp iputil.VpnIp, pending bool) *ControlHostInfo { var hm *HostMap if pending { hm = c.f.handshakeManager.pendingHostMap } else { hm = c.f.hostMap } h, err := hm.QueryVpnIp(vpnIp) if err != nil { return nil } ch := copyHostInfo(h, c.f.hostMap.preferredRanges) return &ch } // SetRemoteForTunnel forces a tunnel to use a specific remote func (c *Control) SetRemoteForTunnel(vpnIp iputil.VpnIp, addr udp.Addr) *ControlHostInfo { hostInfo, err := c.f.hostMap.QueryVpnIp(vpnIp) if err != nil { return nil } hostInfo.SetRemote(addr.Copy()) ch := copyHostInfo(hostInfo, c.f.hostMap.preferredRanges) return &ch } // CloseTunnel closes a fully established tunnel. If localOnly is false it will notify the remote end as well. func (c *Control) CloseTunnel(vpnIp iputil.VpnIp, localOnly bool) bool { hostInfo, err := c.f.hostMap.QueryVpnIp(vpnIp) if err != nil { return false } if !localOnly { c.f.send( header.CloseTunnel, 0, hostInfo.ConnectionState, hostInfo, []byte{}, make([]byte, 12, 12), make([]byte, mtu), ) } c.f.closeTunnel(hostInfo) return true } // CloseAllTunnels is just like CloseTunnel except it goes through and shuts them all down, optionally you can avoid shutting down lighthouse tunnels // the int returned is a count of tunnels closed func (c *Control) CloseAllTunnels(excludeLighthouses bool) (closed int) { //TODO: this is probably better as a function in ConnectionManager or HostMap directly lighthouses := c.f.lightHouse.GetLighthouses() shutdown := func(h *HostInfo) { if excludeLighthouses { if _, ok := lighthouses[h.vpnIp]; ok { return } } c.f.send(header.CloseTunnel, 0, h.ConnectionState, h, []byte{}, make([]byte, 12, 12), make([]byte, mtu)) c.f.closeTunnel(h) c.l.WithField("vpnIp", h.vpnIp).WithField("udpAddr", h.remote). Debug("Sending close tunnel message") closed++ } // Learn which hosts are being used as relays, so we can shut them down last. relayingHosts := map[iputil.VpnIp]*HostInfo{} // Grab the hostMap lock to access the Relays map c.f.hostMap.Lock() for _, relayingHost := range c.f.hostMap.Relays { relayingHosts[relayingHost.vpnIp] = relayingHost } c.f.hostMap.Unlock() hostInfos := []*HostInfo{} // Grab the hostMap lock to access the Hosts map c.f.hostMap.Lock() for _, relayHost := range c.f.hostMap.Hosts { if _, ok := relayingHosts[relayHost.vpnIp]; !ok { hostInfos = append(hostInfos, relayHost) } } c.f.hostMap.Unlock() for _, h := range hostInfos { shutdown(h) } for _, h := range relayingHosts { shutdown(h) } return } func copyHostInfo(h *HostInfo, preferredRanges []*net.IPNet) ControlHostInfo { chi := ControlHostInfo{ VpnIp: h.vpnIp.ToIP(), LocalIndex: h.localIndexId, RemoteIndex: h.remoteIndexId, RemoteAddrs: h.remotes.CopyAddrs(preferredRanges), CachedPackets: len(h.packetStore), CurrentRelaysToMe: h.relayState.CopyRelayIps(), CurrentRelaysThroughMe: h.relayState.CopyRelayForIps(), } if h.ConnectionState != nil { chi.MessageCounter = h.ConnectionState.messageCounter.Load() } if c := h.GetCert(); c != nil { chi.Cert = c.Copy() } if h.remote != nil { chi.CurrentRemote = h.remote.Copy() } return chi } func listHostMap(hm *HostMap) []ControlHostInfo { hm.RLock() hosts := make([]ControlHostInfo, len(hm.Hosts)) i := 0 for _, v := range hm.Hosts { hosts[i] = copyHostInfo(v, hm.preferredRanges) i++ } hm.RUnlock() return hosts }