Module: Ronin::Support::Network::HTTP::UserAgents

Defined in:
lib/ronin/support/network/http/user_agents.rb

Overview

Contains built-in User-Agent strings for Ronin::Support::Network::HTTP.

Since:

  • 1.0.0

Constant Summary collapse

ALIASES =

Built-in User-Agent strings for impersonating various browsers.

Since:

  • 1.0.0

{
  chrome_linux: 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.63 Safari/537.36',
  chrome_macos: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.63 Safari/537.36',
  chrome_windows: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.63 Safari/537.36',
  chrome_iphone: 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/102.0.5005.87 Mobile/15E148 Safari/604.1',
  chrome_ipad: 'Mozilla/5.0 (iPad; CPU OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/102.0.5005.87 Mobile/15E148 Safari/604.1',
  chrome_android: 'Mozilla/5.0 (Linux; Android 10) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.99 Mobile Safari/537.36',

  firefox_linux: 'Mozilla/5.0 (Linux x86_64; rv:101.0) Gecko/20100101 Firefox/101.0',
  firefox_macos: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 12.4; rv:101.0) Gecko/20100101 Firefox/101.0',
  firefox_windows: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:101.0) Gecko/20100101 Firefox/101.0',
  firefox_iphone: 'Mozilla/5.0 (iPhone; CPU iPhone OS 12_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/101.0 Mobile/15E148 Safari/605.1.15',
  firefox_ipad: 'Mozilla/5.0 (iPad; CPU OS 12_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/101.0 Mobile/15E148 Safari/605.1.15',

  firefox_android: 'Mozilla/5.0 (Android 12; Mobile; rv:68.0) Gecko/68.0 Firefox/101.0',

  safari_macos: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15',
  safari_iphone: 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Mobile/15E148 Safari/604.1',
  safari_ipad: 'Mozilla/5.0 (iPad; CPU OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Mobile/15E148 Safari/604.1',

  edge: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.63 Safari/537.36 Edg/102.0.1245.33'
}

Class Method Summary collapse

Class Method Details

.[](id) ⇒ String

Returns a User-Agent string for the given ID.

The new User-Agent string to use. The acceptable values are:

  • :random - a random value from ALIASES will be returned.
  • :chrome - a random Chrome User-Agent from ALIASES will be returned.
  • :firefox - a random Firefox User-Agent from ALIASES will be returned.
  • :safari - a random Safari User-Agent from ALIASES will be returned.
  • :linux - a random Linux User-Agent from ALIASES will be returned.
  • :macos - a random macOS User-Agent from ALIASES will be returned.
  • :windows - a random Windows User-Agent from ALIASES will be returned.
  • :iphone - a random iPhone User-Agent from ALIASES will be returned.
  • :ipad - a random iPad User-Agent from ALIASES will be returned.
  • :android - a random Android User-Agent from ALIASES will be returned.
  • Otherwise, the User-Agent String in ALIASES with the matching ID will be returned.

Parameters:

  • id (:random, :chrome, :chrome_linux, :chrome_macos, :chrome_windows, :chrome_iphone, :chrome_ipad, :chrome_android, :firefox, :firefox_linux, :firefox_macos, :firefox_windows, :firefox_iphone, :firefox_ipad, :firefox_android, :safari, :safari_macos, :safari_iphone, :safari_ipad, :edge, :linux, :macos, :windows, :iphone, :ipad, :android)

Returns:

  • (String) —

    The User-Agent string for the given id.

Raises:

  • (ArgumentError) —

    The given User-Agent ID was not a known ID or wasn't a Symbol.

Since:

  • 1.0.0



94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
 
# File 'lib/ronin/support/network/http/user_agents.rb', line 94

def self.[](id)
  case id
  when :random
    ALIASES.values.sample
  when :chrome, :firefox, :safari # prefix
    ALIASES.select { |k,v| k =~ /^#{id}_/ }.values.sample
  when :linux, :macos, :windows,
       :iphone, :ipad, :android # suffix
    ALIASES.select { |k,v| k =~ /_#{id}$/ }.values.sample
  when Symbol
    ALIASES.fetch(id) do
      raise(ArgumentError,"unknown user agent alias: #{id.inspect}")
    end
  else
    raise(ArgumentError,"User-Agent ID must be a Symbol")
  end
end