Module: PWN::WWW::Twitter

Defined in:
lib/pwn/www/twitter.rb

Overview

This plugin supports twitter.com actions.

Class Method Summary collapse

Class Method Details

.authorsObject

Author(s)

0day Inc. <[email protected]>



103
104
105
106
107
# File 'lib/pwn/www/twitter.rb', line 103

public_class_method def self.authors
  "AUTHOR(S):
    0day Inc. <[email protected]>
  "
end

.close(opts = {}) ⇒ Object

Supported Method Parameters

browser_obj = PWN::WWW::Twitter.close(

browser_obj: 'required - browser_obj returned from #open method'

)



92
93
94
95
96
97
98
99
# File 'lib/pwn/www/twitter.rb', line 92

public_class_method def self.close(opts = {})
  browser_obj = opts[:browser_obj]
  PWN::Plugins::TransparentBrowser.close(
    browser_obj: browser_obj
  )
rescue StandardError => e
  raise e
end

.helpObject

Display Usage for this Module



111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
# File 'lib/pwn/www/twitter.rb', line 111

public_class_method def self.help
  puts "USAGE:
    browser_obj = #{self}.open(
      browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
      proxy: 'optional - scheme://proxy_host:port || tor'
    )

    browser_obj = #{self}.login(
      browser_obj: 'required - browser_obj returned from #open method',
      username: 'required - username',
      password: 'optional - passwd (will prompt if blank),
      mfa: 'optional - if true prompt for mfa token (defaults to false)'
    )

    browser_obj = #{self}.logout(
      browser_obj: 'required - browser_obj returned from #open method'
    )

    #{self}.close(
      browser_obj: 'required - browser_obj returned from #open method'
    )

    #{self}.authors
  "
end

.login(opts = {}) ⇒ Object

Supported Method Parameters

browser_obj = PWN::WWW::Twitter.login(

browser_obj: 'required - browser_obj returned from #open method',
username: 'required - username',
password: 'optional - passwd (will prompt if blank)',
mfa: 'optional - if true prompt for mfa token (defaults to false)'

)



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
# File 'lib/pwn/www/twitter.rb', line 34

public_class_method def self.(opts = {})
  browser_obj = opts[:browser_obj]
  username = opts[:username].to_s.scrub.strip.chomp
  password = opts[:password]

  browser = browser_obj[:browser]

  if password.nil?
    password = PWN::Plugins::AuthenticationHelper.mask_password
  else
    password = opts[:password].to_s.scrub.strip.chomp
  end
  mfa = opts[:mfa]

  browser_obj.goto('https://twitter.com/login')

  browser.text_field(index: 2).wait_until(&:present?).set(username)
  browser.text_field(index: 3).wait_until(&:present?).set(password)
  browser.button(index: 1).click!

  if mfa
    until browser.url == 'https://twitter.com/' ||
          browser.url == 'https://twitter.com/home'

      browser.text_field(id: 'challenge_response').wait_until(&:present?).set(PWN::Plugins::AuthenticationHelper.mfa(prompt: 'enter mfa token'))
      browser.button(id: 'email_challenge_submit').click!
      sleep 3
    end
    print "\n"
  end

  browser_obj
rescue StandardError => e
  raise e
end

.logout(opts = {}) ⇒ Object

Supported Method Parameters

browser_obj = PWN::WWW::Twitter.logout(

browser_obj: 'required - browser_obj returned from #open method'

)



75
76
77
78
79
80
81
82
83
84
85
# File 'lib/pwn/www/twitter.rb', line 75

public_class_method def self.logout(opts = {})
  browser_obj = opts[:browser_obj]

  browser = browser_obj[:browser]
  browser.li(id: 'user-dropdown').wait_until(&:present?).click!
  browser.button(text: 'Log out').wait_until(&:present?).click!

  browser_obj
rescue StandardError => e
  raise e
end

.open(opts = {}) ⇒ Object

Supported Method Parameters

browser_obj = PWN::WWW::Twitter.open(

browser_type: 'optional - :firefox|:chrome|:ie|:headless (Defaults to :firefox)',
proxy: 'optional - scheme://proxy_host:port || tor'

)



15
16
17
18
19
20
21
22
23
24
# File 'lib/pwn/www/twitter.rb', line 15

public_class_method def self.open(opts = {})
  browser_obj = PWN::Plugins::TransparentBrowser.open(opts)

  browser = browser_obj[:browser]
  browser.goto('https://twitter.com')

  browser_obj
rescue StandardError => e
  raise e
end