Module: Rex::UserAgent

Defined in:
lib/rex/user_agent.rb

Overview

A helper module for using and referencing coming user agent strings.

Constant Summary collapse

COMMON_AGENTS =

Taken from www.whatismybrowser.com/guides/the-latest-user-agent/

[
  'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36', # Chrome Windows
  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36', # Chrome MacOS

  'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.2792.79', # Edge Windows

  'Mozilla/5.0 (iPad; CPU OS 17_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/604.1', # Safari iPad
  'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15', # Safari MacOS

  'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:131.0) Gecko/20100101 Firefox/131.0', # Firefox Windows
  'Mozilla/5.0 (Macintosh; Intel Mac OS X 14.7; rv:131.0) Gecko/20100101 Firefox/131.0' # Firefox MacOS
]
@@session_agent = 
nil

Class Method Summary collapse

Class Method Details

.most_common ⇒ Object

Choose the most frequent user agent



54
55
56
 
# File 'lib/rex/user_agent.rb', line 54

def self.most_common
  COMMON_AGENTS[0]
end

.random ⇒ Object

Pick a random agent from the common agent list.



40
41
42
 
# File 'lib/rex/user_agent.rb', line 40

def self.random
  COMMON_AGENTS.sample
end

.session_agent ⇒ Object

A randomly-selected agent that will be consistent for the duration of metasploit running



27
28
29
30
31
32
33
 
# File 'lib/rex/user_agent.rb', line 27

def self.session_agent
  if @@session_agent
    @@session_agent
  else
    @@session_agent = self.random
  end
end

.shortest ⇒ Object

Choose the agent with the shortest string (for use in payloads)



47
48
49
 
# File 'lib/rex/user_agent.rb', line 47

def self.shortest
  @@shortest_agent ||= COMMON_AGENTS.min { |a, b| a.size <=> b.size }
end