class WpVersion

Attributes

discovery_method[R]

number[R]

Public Class Methods

find(target_uri, wp_content_dir) click to toggle source

Will use all method self.find_from_* to try to detect the version Once the version is found, it will return a WpVersion object The method_name will be without ‘find_from_’ and ‘_’ will be replace by ‘ ’ (IE ‘meta generator’, ‘rss generator’ etc) If the version is not found, nil is returned

The order in which the find_from_* methods are is important, they will be called in the same order (::find_from_meta_generator, ::find_from_rss_generator etc)

# File lib/wpscan/wp_version.rb, line 39
def self.find(target_uri, wp_content_dir)
  options = {
      :base_url       => target_uri,
      :wp_content_dir => wp_content_dir
  }
  self.methods.grep(%rfind_from_/).each do |method_to_call|
    version = self.send(method_to_call, options)

    if version
      return new(version, :discovery_method => method_to_call[%r{find_from_(.*)}, 1].gsub('_', ' '))
    end
  end
  nil
end

new(number, options = {}) click to toggle source

# File lib/wpscan/wp_version.rb, line 25
def initialize(number, options = {})
  @number           = number
  @discovery_method = options[:discovery_method]
  @vulns_file       = options[:vulns_file] || DATA_DIR + '/wp_vulns.xml'
  @vulns_xpath      = "//wordpress[@version='#{@number}']/vulnerability"
end

Protected Class Methods

find_from_advanced_fingerprinting(options) click to toggle source

Uses data/wp_versions.xml to try to identify a wordpress version.

It does this by using client side file hashing

/!\ Warning : this method might return false positive if the file used for fingerprinting is part of a theme (they can be updated)

# File lib/wpscan/wp_version.rb, line 124
def self.find_from_advanced_fingerprinting(options)
  target_uri = options[:base_url]
  # needed for rpsec tests
  version_xml = options[:version_xml] || DATA_DIR + "/wp_versions.xml"
  xml = Nokogiri::XML(File.open(version_xml)) do |config|
    config.noblanks
  end

  xml.xpath("//file").each do |node|
    wp_content = options[:wp_content_dir]
    wp_plugins = "#{wp_content}/plugins"
    file_url = target_uri.merge(node.attribute('src').text).to_s
    file_url = file_url.gsub(%r\$wp-plugins\$/, wp_plugins).gsub(%r\$wp-content\$/, wp_content)
    response = Browser.instance.get(file_url)
    md5sum = Digest::MD5.hexdigest(response.body)

    node.search('hash').each do |hash|
      if hash.attribute('md5').text == md5sum
        return hash.search('version').text
      end
    end
  end
  nil # Otherwise the data['file'] is returned (issue #107)
end

find_from_atom_generator(options) click to toggle source

Attempts to find the WordPress version from, the generator tag in the Atom source.

# File lib/wpscan/wp_version.rb, line 99
def self.find_from_atom_generator(options)
  target_uri = options[:base_url]
  response = Browser.instance.get(target_uri.merge("feed/atom/").to_s, {:follow_location => true, :max_redirects => 2})

  response.body[%r{<generator uri="http://wordpress.org/" version="#{WpVersion.version_pattern}">WordPress</generator>}, 1]
end

find_from_links_opml(options) click to toggle source

Attempts to find the WordPress version from the p-links-opml.php file.

# File lib/wpscan/wp_version.rb, line 164
def self.find_from_links_opml(options)
  target_uri = options[:base_url]
  Browser.instance.get(target_uri.merge("wp-links-opml.php").to_s).body[%r{generator="wordpress/#{WpVersion.version_pattern}"}, 1]
end

find_from_meta_generator(options) click to toggle source

Attempts to find the wordpress version from, the generator meta tag in the html source.

The meta tag can be removed however it seems, that it is reinstated on upgrade.

# File lib/wpscan/wp_version.rb, line 61
def self.find_from_meta_generator(options)
  target_uri = options[:base_url]
  response = Browser.instance.get(target_uri.to_s, {:follow_location => true, :max_redirects => 2})

  response.body[%r{name="generator" content="wordpress #{WpVersion.version_pattern}"}, 1]
end

find_from_rdf_generator(options) click to toggle source

Attempts to find WordPress version from, the generator tag in the RDF feed source.

# File lib/wpscan/wp_version.rb, line 79
def self.find_from_rdf_generator(options)
  target_uri = options[:base_url]
  response = Browser.instance.get(target_uri.merge("feed/rdf/").to_s, {:follow_location => true, :max_redirects => 2})

  response.body[%r{<admin:generatorAgent rdf:resource="http://wordpress.org/\?v=#{WpVersion.version_pattern}" />}, 1]
end

find_from_readme(options) click to toggle source

Attempts to find the WordPress version from the readme.html file.

# File lib/wpscan/wp_version.rb, line 150
def self.find_from_readme(options)
  target_uri = options[:base_url]
  Browser.instance.get(target_uri.merge("readme.html").to_s).body[%r{<br />\sversion #{WpVersion.version_pattern}}, 1]
end

find_from_rss_generator(options) click to toggle source

Attempts to find the WordPress version from, the generator tag in the RSS feed source.

# File lib/wpscan/wp_version.rb, line 70
def self.find_from_rss_generator(options)
  target_uri = options[:base_url]
  response = Browser.instance.get(target_uri.merge("feed/").to_s, {:follow_location => true, :max_redirects => 2})

  response.body[%r{<generator>http://wordpress.org/\?v=#{WpVersion.version_pattern}</generator>}, 1]
end

find_from_sitemap_generator(options) click to toggle source

Attempts to find the WordPress version from the sitemap.xml file.

See: code.google.com/p/wpscan/issues/detail?id=109

# File lib/wpscan/wp_version.rb, line 158
def self.find_from_sitemap_generator(options)
  target_uri = options[:base_url]
  Browser.instance.get(target_uri.merge("sitemap.xml").to_s).body[%r{generator="wordpress/#{WpVersion.version_pattern}"}, 1]
end

version_pattern() click to toggle source

Used to check if the version is correct: must contain at least one dot.

# File lib/wpscan/wp_version.rb, line 170
def self.version_pattern
  '([^\r\n]+[\.][^\r\n]+)'
end