github.com/SmartMeshFoundation/Spectrum@v0.0.0-20220621030607-452a266fee1e/p2p/nat/natupnp.go (about)

     1  // Copyright 2015 The Spectrum Authors
     2  // This file is part of the Spectrum library.
     3  //
     4  // The Spectrum library is free software: you can redistribute it and/or modify
     5  // it under the terms of the GNU Lesser General Public License as published by
     6  // the Free Software Foundation, either version 3 of the License, or
     7  // (at your option) any later version.
     8  //
     9  // The Spectrum library is distributed in the hope that it will be useful,
    10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    12  // GNU Lesser General Public License for more details.
    13  //
    14  // You should have received a copy of the GNU Lesser General Public License
    15  // along with the Spectrum library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  package nat
    18  
    19  import (
    20  	"errors"
    21  	"fmt"
    22  	"net"
    23  	"strings"
    24  	"time"
    25  
    26  	"github.com/huin/goupnp"
    27  	"github.com/huin/goupnp/dcps/internetgateway1"
    28  	"github.com/huin/goupnp/dcps/internetgateway2"
    29  )
    30  
    31  const soapRequestTimeout = 3 * time.Second
    32  
    33  type upnp struct {
    34  	dev     *goupnp.RootDevice
    35  	service string
    36  	client  upnpClient
    37  }
    38  
    39  type upnpClient interface {
    40  	GetExternalIPAddress() (string, error)
    41  	AddPortMapping(string, uint16, string, uint16, string, bool, string, uint32) error
    42  	DeletePortMapping(string, uint16, string) error
    43  	GetNATRSIPStatus() (sip bool, nat bool, err error)
    44  }
    45  
    46  func (n *upnp) ExternalIP() (addr net.IP, err error) {
    47  	ipString, err := n.client.GetExternalIPAddress()
    48  	if err != nil {
    49  		return nil, err
    50  	}
    51  	ip := net.ParseIP(ipString)
    52  	if ip == nil {
    53  		return nil, errors.New("bad IP in response")
    54  	}
    55  	return ip, nil
    56  }
    57  
    58  func (n *upnp) AddMapping(protocol string, extport, intport int, desc string, lifetime time.Duration) error {
    59  	ip, err := n.internalAddress()
    60  	if err != nil {
    61  		return nil
    62  	}
    63  	protocol = strings.ToUpper(protocol)
    64  	lifetimeS := uint32(lifetime / time.Second)
    65  	n.DeleteMapping(protocol, extport, intport)
    66  	return n.client.AddPortMapping("", uint16(extport), protocol, uint16(intport), ip.String(), true, desc, lifetimeS)
    67  }
    68  
    69  func (n *upnp) internalAddress() (net.IP, error) {
    70  	devaddr, err := net.ResolveUDPAddr("udp4", n.dev.URLBase.Host)
    71  	if err != nil {
    72  		return nil, err
    73  	}
    74  	ifaces, err := net.Interfaces()
    75  	if err != nil {
    76  		return nil, err
    77  	}
    78  	for _, iface := range ifaces {
    79  		addrs, err := iface.Addrs()
    80  		if err != nil {
    81  			return nil, err
    82  		}
    83  		for _, addr := range addrs {
    84  			switch x := addr.(type) {
    85  			case *net.IPNet:
    86  				if x.Contains(devaddr.IP) {
    87  					return x.IP, nil
    88  				}
    89  			}
    90  		}
    91  	}
    92  	return nil, fmt.Errorf("could not find local address in same net as %v", devaddr)
    93  }
    94  
    95  func (n *upnp) DeleteMapping(protocol string, extport, intport int) error {
    96  	return n.client.DeletePortMapping("", uint16(extport), strings.ToUpper(protocol))
    97  }
    98  
    99  func (n *upnp) String() string {
   100  	return "UPNP " + n.service
   101  }
   102  
   103  // discoverUPnP searches for Internet Gateway Devices
   104  // and returns the first one it can find on the local network.
   105  func discoverUPnP() Interface {
   106  	found := make(chan *upnp, 2)
   107  	// IGDv1
   108  	go discover(found, internetgateway1.URN_WANConnectionDevice_1, func(dev *goupnp.RootDevice, sc goupnp.ServiceClient) *upnp {
   109  		switch sc.Service.ServiceType {
   110  		case internetgateway1.URN_WANIPConnection_1:
   111  			return &upnp{dev, "IGDv1-IP1", &internetgateway1.WANIPConnection1{ServiceClient: sc}}
   112  		case internetgateway1.URN_WANPPPConnection_1:
   113  			return &upnp{dev, "IGDv1-PPP1", &internetgateway1.WANPPPConnection1{ServiceClient: sc}}
   114  		}
   115  		return nil
   116  	})
   117  	// IGDv2
   118  	go discover(found, internetgateway2.URN_WANConnectionDevice_2, func(dev *goupnp.RootDevice, sc goupnp.ServiceClient) *upnp {
   119  		switch sc.Service.ServiceType {
   120  		case internetgateway2.URN_WANIPConnection_1:
   121  			return &upnp{dev, "IGDv2-IP1", &internetgateway2.WANIPConnection1{ServiceClient: sc}}
   122  		case internetgateway2.URN_WANIPConnection_2:
   123  			return &upnp{dev, "IGDv2-IP2", &internetgateway2.WANIPConnection2{ServiceClient: sc}}
   124  		case internetgateway2.URN_WANPPPConnection_1:
   125  			return &upnp{dev, "IGDv2-PPP1", &internetgateway2.WANPPPConnection1{ServiceClient: sc}}
   126  		}
   127  		return nil
   128  	})
   129  	for i := 0; i < cap(found); i++ {
   130  		if c := <-found; c != nil {
   131  			return c
   132  		}
   133  	}
   134  	return nil
   135  }
   136  
   137  // finds devices matching the given target and calls matcher for all
   138  // advertised services of each device. The first non-nil service found
   139  // is sent into out. If no service matched, nil is sent.
   140  func discover(out chan<- *upnp, target string, matcher func(*goupnp.RootDevice, goupnp.ServiceClient) *upnp) {
   141  	devs, err := goupnp.DiscoverDevices(target)
   142  	if err != nil {
   143  		out <- nil
   144  		return
   145  	}
   146  	found := false
   147  	for i := 0; i < len(devs) && !found; i++ {
   148  		if devs[i].Root == nil {
   149  			continue
   150  		}
   151  		devs[i].Root.Device.VisitServices(func(service *goupnp.Service) {
   152  			if found {
   153  				return
   154  			}
   155  			// check for a matching IGD service
   156  			sc := goupnp.ServiceClient{
   157  				SOAPClient: service.NewSOAPClient(),
   158  				RootDevice: devs[i].Root,
   159  				Location:   devs[i].Location,
   160  				Service:    service,
   161  			}
   162  			sc.SOAPClient.HTTPClient.Timeout = soapRequestTimeout
   163  			upnp := matcher(devs[i].Root, sc)
   164  			if upnp == nil {
   165  				return
   166  			}
   167  			// check whether port mapping is enabled
   168  			if _, nat, err := upnp.client.GetNATRSIPStatus(); err != nil || !nat {
   169  				return
   170  			}
   171  			out <- upnp
   172  			found = true
   173  		})
   174  	}
   175  	if !found {
   176  		out <- nil
   177  	}
   178  }