UPnP IGD SOAP Port Mapping Utility - Metasploit


This page contains detailed information about how to use the auxiliary/admin/upnp/soap_portmapping metasploit module. For list of all metasploit modules, visit the Metasploit Module Library.

Module Overview


Name: UPnP IGD SOAP Port Mapping Utility
Module: auxiliary/admin/upnp/soap_portmapping
Source code: modules/auxiliary/admin/upnp/soap_portmapping.rb
Disclosure date: -
Last modification time: 2017-07-24 06:26:21 +0000
Supported architecture(s): -
Supported platform(s): -
Target service / protocol: http, https
Target network port(s): 80, 443, 3000, 8000, 8008, 8080, 8443, 8880, 8888
List of CVEs: -

Manage port mappings on UPnP IGD-capable device using the AddPortMapping and DeletePortMapping SOAP requests

Module Ranking and Traits


Module Ranking:

  • normal: The exploit is otherwise reliable, but depends on a specific version and can't (or doesn't) reliably autodetect. More information about ranking can be found here.

Basic Usage


msf > use auxiliary/admin/upnp/soap_portmapping
msf auxiliary(soap_portmapping) > show targets
    ... a list of targets ...
msf auxiliary(soap_portmapping) > set TARGET target-id
msf auxiliary(soap_portmapping) > show options
    ... show and set options ...
msf auxiliary(soap_portmapping) > exploit

Required Options


  • RHOSTS: The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'

  • EXTERNAL_PORT: External port

Go back to menu.

Msfconsole Usage


Here is how the admin/upnp/soap_portmapping auxiliary module looks in the msfconsole:

msf6 > use auxiliary/admin/upnp/soap_portmapping

msf6 auxiliary(admin/upnp/soap_portmapping) > show info

       Name: UPnP IGD SOAP Port Mapping Utility
     Module: auxiliary/admin/upnp/soap_portmapping
    License: Metasploit Framework License (BSD)
       Rank: Normal

Provided by:
  St0rn <[email protected]>
  Jon Hart <[email protected]>

Available actions:
  Name    Description
  ----    -----------
  ADD     Use the AddPortMapping SOAP command to open and forward a port
  DELETE  Use the DeletePortMapping SOAP command to remove a port forwarding

Check supported:
  No

Basic options:
  Name             Current Setting  Required  Description
  ----             ---------------  --------  -----------
  EXTERNAL_CLIENT                   no        External client hostname/IP
  EXTERNAL_PORT                     yes       External port
  INTERNAL_CLIENT                   no        Internal client hostname/IP
  INTERNAL_PORT                     no        Internal port
  LEASE_DURATION   3600             no        Lease time for mapping, in seconds
  PROTOCOL         TCP              yes       Transport level protocol to map (Accepted: TCP, UDP)
  Proxies                           no        A proxy chain of format type:host:port[,type:host:port][...]
  RHOSTS                            yes       The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'
  RPORT            80               yes       The target port (TCP)
  SSL              false            no        Negotiate SSL/TLS for outgoing connections
  TARGETURI        /                yes       UPnP control URL
  VHOST                             no        HTTP server virtual host

Description:
  Manage port mappings on UPnP IGD-capable device using the 
  AddPortMapping and DeletePortMapping SOAP requests

References:
  http://www.upnp-hacks.org/igd.html

Module Options


This is a complete list of options available in the admin/upnp/soap_portmapping auxiliary module:

msf6 auxiliary(admin/upnp/soap_portmapping) > show options

Module options (auxiliary/admin/upnp/soap_portmapping):

   Name             Current Setting  Required  Description
   ----             ---------------  --------  -----------
   EXTERNAL_CLIENT                   no        External client hostname/IP
   EXTERNAL_PORT                     yes       External port
   INTERNAL_CLIENT                   no        Internal client hostname/IP
   INTERNAL_PORT                     no        Internal port
   LEASE_DURATION   3600             no        Lease time for mapping, in seconds
   PROTOCOL         TCP              yes       Transport level protocol to map (Accepted: TCP, UDP)
   Proxies                           no        A proxy chain of format type:host:port[,type:host:port][...]
   RHOSTS                            yes       The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'
   RPORT            80               yes       The target port (TCP)
   SSL              false            no        Negotiate SSL/TLS for outgoing connections
   TARGETURI        /                yes       UPnP control URL
   VHOST                             no        HTTP server virtual host

Auxiliary action:

   Name  Description
   ----  -----------
   ADD   Use the AddPortMapping SOAP command to open and forward a port

Advanced Options


Here is a complete list of advanced options supported by the admin/upnp/soap_portmapping auxiliary module:

msf6 auxiliary(admin/upnp/soap_portmapping) > show advanced

Module advanced options (auxiliary/admin/upnp/soap_portmapping):

   Name                  Current Setting                                     Required  Description
   ----                  ---------------                                     --------  -----------
   DOMAIN                WORKSTATION                                         yes       The domain to use for Windows authentication
   DigestAuthIIS         true                                                no        Conform to IIS, should work for most servers. Only set to false for non-IIS servers
   FingerprintCheck      true                                                no        Conduct a pre-exploit fingerprint verification
   HttpClientTimeout                                                         no        HTTP connection and receive timeout
   HttpPassword                                                              no        The HTTP password to specify for authentication
   HttpRawHeaders                                                            no        Path to ERB-templatized raw headers to append to existing headers
   HttpTrace             false                                               no        Show the raw HTTP requests and responses
   HttpTraceColors       red/blu                                             no        HTTP request and response colors for HttpTrace (unset to disable)
   HttpTraceHeadersOnly  false                                               no        Show HTTP headers only in HttpTrace
   HttpUsername                                                              no        The HTTP username to specify for authentication
   SSLVersion            Auto                                                yes       Specify the version of SSL/TLS to be used (Auto, TLS and SSL23 are auto-negotiate) (Accepted: Auto, TLS, SSL23, SSL3, TLS1, TLS1.1, TLS1.2)
   UserAgent             Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)  no        The User-Agent header to use for all requests
   VERBOSE               false                                               no        Enable detailed status messages
   WORKSPACE                                                                 no        Specify the workspace for this module

Auxiliary Actions


This is a list of all auxiliary actions that the admin/upnp/soap_portmapping module can do:

msf6 auxiliary(admin/upnp/soap_portmapping) > show actions

Auxiliary actions:

   Name    Description
   ----    -----------
   ADD     Use the AddPortMapping SOAP command to open and forward a port
   DELETE  Use the DeletePortMapping SOAP command to remove a port forwarding

Evasion Options


Here is the full list of possible evasion options supported by the admin/upnp/soap_portmapping auxiliary module in order to evade defenses (e.g. Antivirus, EDR, Firewall, NIDS etc.):

msf6 auxiliary(admin/upnp/soap_portmapping) > show evasion

Module evasion options:

   Name                          Current Setting  Required  Description
   ----                          ---------------  --------  -----------
   HTTP::header_folding          false            no        Enable folding of HTTP headers
   HTTP::method_random_case      false            no        Use random casing for the HTTP method
   HTTP::method_random_invalid   false            no        Use a random invalid, HTTP method for request
   HTTP::method_random_valid     false            no        Use a random, but valid, HTTP method for request
   HTTP::pad_fake_headers        false            no        Insert random, fake headers into the HTTP request
   HTTP::pad_fake_headers_count  0                no        How many fake headers to insert into the HTTP request
   HTTP::pad_get_params          false            no        Insert random, fake query string variables into the request
   HTTP::pad_get_params_count    16               no        How many fake query string variables to insert into the request
   HTTP::pad_method_uri_count    1                no        How many whitespace characters to use between the method and uri
   HTTP::pad_method_uri_type     space            no        What type of whitespace to use between the method and uri (Accepted: space, tab, apache)
   HTTP::pad_post_params         false            no        Insert random, fake post variables into the request
   HTTP::pad_post_params_count   16               no        How many fake post variables to insert into the request
   HTTP::pad_uri_version_count   1                no        How many whitespace characters to use between the uri and version
   HTTP::pad_uri_version_type    space            no        What type of whitespace to use between the uri and version (Accepted: space, tab, apache)
   HTTP::uri_dir_fake_relative   false            no        Insert fake relative directories into the uri
   HTTP::uri_dir_self_reference  false            no        Insert self-referential directories into the uri
   HTTP::uri_encode_mode         hex-normal       no        Enable URI encoding (Accepted: none, hex-normal, hex-noslashes, hex-random, hex-all, u-normal, u-all, u-random)
   HTTP::uri_fake_end            false            no        Add a fake end of URI (eg: /%20HTTP/1.0/../../)
   HTTP::uri_fake_params_start   false            no        Add a fake start of params to the URI (eg: /%3fa=b/../)
   HTTP::uri_full_url            false            no        Use the full URL for all HTTP requests
   HTTP::uri_use_backslashes     false            no        Use back slashes instead of forward slashes in the uri
   HTTP::version_random_invalid  false            no        Use a random invalid, HTTP version for request
   HTTP::version_random_valid    false            no        Use a random, but valid, HTTP version for request

Go back to menu.

Error Messages


This module may fail with the following error messages:

Check for the possible causes from the code snippets below found in the module source code. This can often times help in identifying the root cause of the problem.

<PEER> <MAP> <ACTION.NAME> failed with response code <RES.CODE>


Here is a relevant code snippet related to the "<PEER> <MAP> <ACTION.NAME> failed with response code <RES.CODE>" error message:

126:	
127:	    if res
128:	      if res.code == 200
129:	        print_good("#{peer} #{map} #{action.name} succeeded")
130:	      else
131:	        print_error("#{peer} #{map} #{action.name} failed with response code #{res.code}")
132:	        vprint_status("#{res.body}")
133:	      end
134:	    else
135:	      print_error("#{peer} no response for #{map} #{action.name}")
136:	    end

<PEER> no response for <MAP> <ACTION.NAME>


Here is a relevant code snippet related to the "<PEER> no response for <MAP> <ACTION.NAME>" error message:

128:	      if res.code == 200
129:	        print_good("#{peer} #{map} #{action.name} succeeded")
130:	      else
131:	        print_error("#{peer} #{map} #{action.name} failed with response code #{res.code}")
132:	        vprint_status("#{res.body}")
133:	      end
134:	    else
135:	      print_error("#{peer} no response for #{map} #{action.name}")
136:	    end
137:	  end
138:	end

Go back to menu.


References


See Also


Check also the following modules related to this module:

Authors


  • St0rn <fabien[at]anbu-pentest.com>
  • Jon Hart <jon_hart[at]rapid7.com>

Version


This page has been produced using Metasploit Framework version 6.2.29-dev. For more modules, visit the Metasploit Module Library.

Go back to menu.