Asterisk Manager Login Utility - Metasploit


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

Module Overview


Name: Asterisk Manager Login Utility
Module: auxiliary/voip/asterisk_login
Source code: modules/auxiliary/voip/asterisk_login.rb
Disclosure date: -
Last modification time: 2017-07-24 06:26:21 +0000
Supported architecture(s): -
Supported platform(s): -
Target service / protocol: -
Target network port(s): 5038
List of CVEs: -

This module attempts to authenticate to an Asterisk Manager service. Please note that by default, Asterisk Call Management (port 5038) only listens locally, but this can be manually configured in file /etc/asterisk/manager.conf by the admin on the victim machine.

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


This module is a scanner module, and is capable of testing against multiple hosts.

msf > use auxiliary/voip/asterisk_login
msf auxiliary(asterisk_login) > show options
    ... show and set options ...
msf auxiliary(asterisk_login) > set RHOSTS ip-range
msf auxiliary(asterisk_login) > exploit

Other examples of setting the RHOSTS option:

Example 1:

msf auxiliary(asterisk_login) > set RHOSTS 192.168.1.3-192.168.1.200 

Example 2:

msf auxiliary(asterisk_login) > set RHOSTS 192.168.1.1/24

Example 3:

msf auxiliary(asterisk_login) > set RHOSTS file:/tmp/ip_list.txt

Required Options


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

Go back to menu.

Msfconsole Usage


Here is how the voip/asterisk_login auxiliary module looks in the msfconsole:

msf6 > use auxiliary/voip/asterisk_login

msf6 auxiliary(voip/asterisk_login) > show info

       Name: Asterisk Manager Login Utility
     Module: auxiliary/voip/asterisk_login
    License: Metasploit Framework License (BSD)
       Rank: Normal

Provided by:
  dflah_ <[email protected]>

Check supported:
  No

Basic options:
  Name              Current Setting                                                                 Required  Description
  ----              ---------------                                                                 --------  -----------
  BLANK_PASSWORDS   false                                                                           no        Try blank passwords for all users
  BRUTEFORCE_SPEED  5                                                                               yes       How fast to bruteforce, from 0 to 5
  DB_ALL_CREDS      false                                                                           no        Try each user/password couple stored in the current database
  DB_ALL_PASS       false                                                                           no        Add all passwords in the current database to the list
  DB_ALL_USERS      false                                                                           no        Add all users in the current database to the list
  PASSWORD                                                                                          no        A specific password to authenticate with
  PASS_FILE         /opt/metasploit-framework/embedded/framework/data/wordlists/unix_passwords.txt  no        The file that contains a list of probable passwords.
  RHOSTS                                                                                            yes       The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'
  RPORT             5038                                                                            yes       The target port (TCP)
  STOP_ON_SUCCESS   false                                                                           yes       Stop guessing when a credential works for a host
  THREADS           1                                                                               yes       The number of concurrent threads (max one per host)
  USERNAME                                                                                          no        A specific username to authenticate as
  USERPASS_FILE                                                                                     no        File containing users and passwords separated by space, one pair per line
  USER_AS_PASS      false                                                                           no        Try the username as the password for all users
  USER_FILE         /opt/metasploit-framework/embedded/framework/data/wordlists/unix_users.txt      no        The file that contains a list of probable users accounts.
  VERBOSE           true                                                                            yes       Whether to print output for all attempts

Description:
  This module attempts to authenticate to an Asterisk Manager service. 
  Please note that by default, Asterisk Call Management (port 5038) 
  only listens locally, but this can be manually configured in file 
  /etc/asterisk/manager.conf by the admin on the victim machine.

References:
  http://www.asterisk.org/astdocs/node201.html

Module Options


This is a complete list of options available in the voip/asterisk_login auxiliary module:

msf6 auxiliary(voip/asterisk_login) > show options

Module options (auxiliary/voip/asterisk_login):

   Name              Current Setting                                                                 Required  Description
   ----              ---------------                                                                 --------  -----------
   BLANK_PASSWORDS   false                                                                           no        Try blank passwords for all users
   BRUTEFORCE_SPEED  5                                                                               yes       How fast to bruteforce, from 0 to 5
   DB_ALL_CREDS      false                                                                           no        Try each user/password couple stored in the current database
   DB_ALL_PASS       false                                                                           no        Add all passwords in the current database to the list
   DB_ALL_USERS      false                                                                           no        Add all users in the current database to the list
   PASSWORD                                                                                          no        A specific password to authenticate with
   PASS_FILE         /opt/metasploit-framework/embedded/framework/data/wordlists/unix_passwords.txt  no        The file that contains a list of probable passwords.
   RHOSTS                                                                                            yes       The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'
   RPORT             5038                                                                            yes       The target port (TCP)
   STOP_ON_SUCCESS   false                                                                           yes       Stop guessing when a credential works for a host
   THREADS           1                                                                               yes       The number of concurrent threads (max one per host)
   USERNAME                                                                                          no        A specific username to authenticate as
   USERPASS_FILE                                                                                     no        File containing users and passwords separated by space, one pair per line
   USER_AS_PASS      false                                                                           no        Try the username as the password for all users
   USER_FILE         /opt/metasploit-framework/embedded/framework/data/wordlists/unix_users.txt      no        The file that contains a list of probable users accounts.
   VERBOSE           true                                                                            yes       Whether to print output for all attempts

Advanced Options


Here is a complete list of advanced options supported by the voip/asterisk_login auxiliary module:

msf6 auxiliary(voip/asterisk_login) > show advanced

Module advanced options (auxiliary/voip/asterisk_login):

   Name                  Current Setting  Required  Description
   ----                  ---------------  --------  -----------
   CHOST                                  no        The local client address
   CPORT                                  no        The local client port
   ConnectTimeout        10               yes       Maximum number of seconds to establish a TCP connection
   MaxGuessesPerService  0                no        Maximum number of credentials to try per service instance. If set to zero or a non-number, this option will not be used.
   MaxGuessesPerUser     0                no        Maximum guesses for a particular username for the service instance. Note that users are considered unique among different services, so a user at 10.1.1.1:22 is different from one at 10.2.2.2:
                                                    22, and both will be tried up to the MaxGuessesPerUser limit. If set to zero or a non-number, this option will not be used.
   MaxMinutesPerService  0                no        Maximum time in minutes to bruteforce the service instance. If set to zero or a non-number, this option will not be used.
   PASSWORD_SPRAY        false            yes       Reverse the credential pairing order. For each password, attempt every possible user.
   Proxies                                no        A proxy chain of format type:host:port[,type:host:port][...]
   REMOVE_PASS_FILE      false            yes       Automatically delete the PASS_FILE on module completion
   REMOVE_USERPASS_FILE  false            yes       Automatically delete the USERPASS_FILE on module completion
   REMOVE_USER_FILE      false            yes       Automatically delete the USER_FILE on module completion
   SSL                   false            no        Negotiate SSL/TLS for outgoing connections
   SSLCipher                              no        String for SSL cipher - "DHE-RSA-AES256-SHA" or "ADH"
   SSLVerifyMode         PEER             no        SSL verification method (Accepted: CLIENT_ONCE, FAIL_IF_NO_PEER_CERT, NONE, PEER)
   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)
   ShowProgress          true             yes       Display progress messages during a scan
   ShowProgressPercent   10               yes       The interval in percent that progress should be shown
   TRANSITION_DELAY      0                no        Amount of time (in minutes) to delay before transitioning to the next user in the array (or password when PASSWORD_SPRAY=true)
   WORKSPACE                              no        Specify the workspace for this module

Auxiliary Actions


This is a list of all auxiliary actions that the voip/asterisk_login module can do:

msf6 auxiliary(voip/asterisk_login) > show actions

Auxiliary actions:

   Name  Description
   ----  -----------

Evasion Options


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

msf6 auxiliary(voip/asterisk_login) > show evasion

Module evasion options:

   Name                Current Setting  Required  Description
   ----                ---------------  --------  -----------
   TCP::max_send_size  0                no        Maxiumum tcp segment size.  (0 = disable)
   TCP::send_delay     0                no        Delays inserted before every send.  (0 = disable)

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.

Error: <ERR.TO_S>


Here is a relevant code snippet related to the "Error: <ERR.TO_S>" error message:

96:	        select(nil,nil,nil,0.4)
97:	      end
98:	      sock.put(command)
99:	      @result = sock.get_once || ''
100:	    rescue ::Exception => err
101:	      print_error("Error: #{err.to_s}")
102:	    end
103:	  end
104:	
105:	  def do_login(user='',pass='')
106:	    @connected = false

Asterisk Manager does not appear to be running


Here is a relevant code snippet related to the "Asterisk Manager does not appear to be running" error message:

105:	  def do_login(user='',pass='')
106:	    @connected = false
107:	    begin
108:	      send_manager(nil) # connect Only
109:	      if @result !~ /^Asterisk Call Manager(.*)/
110:	        print_error("Asterisk Manager does not appear to be running")
111:	        return :abort
112:	      else
113:	        vprint_status("#{rhost}:#{rport} - Trying user:'#{user}' with password:'#{pass}'")
114:	        cmd = "Action: Login\r\nUsername: #{user}\r\nSecret: #{pass}\r\n\r\n"
115:	        send_manager(cmd)

Go back to menu.


References


See Also


Check also the following modules related to this module:

Authors


  • dflah_ <dflah[at]alligatorteam.org>

Version


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

Go back to menu.