threat_agent 1.0.0.beta.1

Sign up to get free protection for your applications and to get access to all the features.
data/.gitignore ADDED
@@ -0,0 +1,17 @@
1
+ *.gem
2
+ *.rbc
3
+ .bundle
4
+ .config
5
+ .yardoc
6
+ Gemfile.lock
7
+ InstalledFiles
8
+ _yardoc
9
+ coverage
10
+ doc/
11
+ lib/bundler/man
12
+ pkg
13
+ rdoc
14
+ spec/reports
15
+ test/tmp
16
+ test/version_tmp
17
+ tmp
data/.travis.yml ADDED
@@ -0,0 +1,6 @@
1
+ language: ruby
2
+ rvm:
3
+ - 1.9.3
4
+ - 2.0.0
5
+ script:
6
+ - bundle exec rspec
data/Gemfile ADDED
@@ -0,0 +1,4 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in threatagent.gemspec
4
+ gemspec
data/LICENSE ADDED
@@ -0,0 +1,23 @@
1
+ Copyright (c) 2013 Erran Carey <e@threatagent.com>, Marcus Carey
2
+ <marcus@threatagent.com>
3
+
4
+ MIT License
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining
7
+ a copy of this software and associated documentation files (the
8
+ "Software"), to deal in the Software without restriction, including
9
+ without limitation the rights to use, copy, modify, merge, publish,
10
+ distribute, sublicense, and/or sell copies of the Software, and to
11
+ permit persons to whom the Software is furnished to do so, subject to
12
+ the following conditions:
13
+
14
+ The above copyright notice and this permission notice shall be
15
+ included in all copies or substantial portions of the Software.
16
+
17
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
20
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
21
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
22
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
23
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,23 @@
1
+ # ThreatAgent [![Build Status](https://secure.travis-ci.org/threatagent/threatagent.png)](http://travis-ci.org/threatagent/threatagent) [![Dependency Status](https://gemnasium.com/threatagent/threatagent.png)](https://gemnasium.com/threatagent/threatagent)
2
+ A gem to interface with the Threat Agent API.
3
+
4
+ ## Installation
5
+ Add this line to your application's Gemfile: `gem 'threatagent'` And then
6
+ execute: `bundle` Or install it yourself with: `gem install threatagent`
7
+
8
+ ## Usage
9
+ After installing the gem you can run `threatagent`
10
+ from the commandline to list available subcommands:
11
+
12
+ ```
13
+ [ecarey @ ~]$ threatagent
14
+ Commands:
15
+ # TODO: Update me
16
+ ```
17
+
18
+ ## Contributing
19
+ 1. Fork it
20
+ 2. Create your feature branch (`git checkout -b feature/my-new-feature`)
21
+ 3. Commit your changes (`git commit -am 'Add some feature'`)
22
+ 4. Push to the branch (`git push origin feature/my-new-feature`)
23
+ 5. Create new Pull Request
data/Thorfile ADDED
@@ -0,0 +1,33 @@
1
+ # encoding: utf-8
2
+ $:.unshift File.expand_path("../lib", __FILE__)
3
+
4
+ require 'bundler'
5
+ require 'bundler/setup'
6
+ require 'thor/rake_compat'
7
+ require 'yard'
8
+
9
+ class Default < Thor
10
+ include Thor::RakeCompat
11
+ require 'bundler/gem_tasks'
12
+
13
+ desc 'build', "Build threat_agent-#{ThreatAgent::VERSION}.gem"
14
+ def build
15
+ Rake::Task['build'].execute
16
+ end
17
+
18
+ desc 'install', "Build and install threat_agent-#{ThreatAgent::VERSION}.gem into system gems"
19
+ def install
20
+ Rake::Task['install'].execute
21
+ end
22
+
23
+ desc 'release', "Create tag v#{ThreatAgent::VERSION} and build and push threat_agent-#{ThreatAgent::VERSION}.gem to Rubygems"
24
+ def release
25
+ Rake::Task['release'].execute
26
+ end
27
+
28
+ YARD::Rake::YardocTask.new
29
+ desc 'yard', 'Generate YARD Documentation'
30
+ def yard
31
+ Rake::Task['yard'].execute
32
+ end
33
+ end
data/bin/threatagent ADDED
@@ -0,0 +1,36 @@
1
+ #!/usr/bin/env ruby
2
+ # -*- mode: ruby -*-
3
+ # vi: set ft=ruby :
4
+
5
+ require 'threat_agent'
6
+ require 'threat_agent/tasks'
7
+ require 'thor'
8
+
9
+ class ThreatAgentCLI < Thor
10
+ desc 'breachbot [SUBCOMMAND]', 'Monitor website changes'
11
+ subcommand :breachbot, ThreatAgent::Tasks::Breachbot
12
+
13
+ desc 'drone [SUBCOMMAND]', 'Launch or review Drone security assessments'
14
+ subcommand :drone, ThreatAgent::Tasks::Drone
15
+
16
+ desc 'exfiltrate [SUBCOMMAND]', 'Determine if security devices detect sensitive data'
17
+ subcommand :exfiltrate, ThreatAgent::Tasks::Exfiltrate
18
+
19
+ desc 'passision [SUBCOMMAND]', 'Create a locale/organization aware wordlists'
20
+ subcommand :passision, ThreatAgent::Tasks::Passision
21
+
22
+ desc 'phishable [SUBCOMMAND]', 'Launch phishing campaigns'
23
+ subcommand :phishable, ThreatAgent::Tasks::Phishable
24
+
25
+ desc 'pwnxy [SUBCOMMAND]', 'Create a Pwnxy instance'
26
+ subcommand :pwnxy, ThreatAgent::Tasks::Pwnxy
27
+ end
28
+
29
+ # TODO: Is there a better way to globally define an API client?
30
+ # TODO: Support a threat_agent.yml configuration file
31
+ $threat_agent_client = ThreatAgent::APIClient.new(
32
+ ENV['THREAT_AGENT_KEY'],
33
+ ENV['THREAT_AGENT_SUP']
34
+ )
35
+
36
+ ThreatAgentCLI.start(ARGV)
@@ -0,0 +1,53 @@
1
+ require 'json'
2
+ require 'net/http'
3
+
4
+ module ThreatAgent
5
+ # The API Client object handles most of the interactions with the ThreatAgent
6
+ # API
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class APIClient
10
+ # Intializes the ThreatAgent::APIClient object
11
+ #
12
+ # @param [String] key the user's API key
13
+ # @param [String] sup the user's supplemental key
14
+ # @return [APIClient] the initialized ThreatAgent::APIClient object
15
+ def initialize(key, sup)
16
+ @key = key
17
+ @sup = sup
18
+ end
19
+
20
+ # Authenticates against threatagent.com
21
+ #
22
+ # @param [Hash] credentials credentials to attempt authentication with
23
+ # @option [String] key the user's API key
24
+ # @return [Boolean] whether the specified credentials where able to
25
+ # authenticate with the ThreatAgent API
26
+ def authenticate(credentials = {})
27
+ raise NotImplementedError
28
+ end
29
+
30
+ # Whether or not authentication was successful
31
+ #
32
+ # @return [Boolean] true if the ThreatAgent::APIClient has been
33
+ # authentication, false otherwise
34
+ def authenticated?
35
+ # @authenticated
36
+ raise NotImplementedError
37
+ end
38
+
39
+ # Send a request to the ThreatAgent API
40
+ #
41
+ # @param [String] action the type of request to send
42
+ # @param [Hash] params parameters to send along with the action to
43
+ # api.threatagent.com
44
+ def request(action, params = {})
45
+ params.merge!({ key: @key, sup: @sup })
46
+ action = action.to_s.gsub(/-|_/, '/')
47
+ encoded_params = URI.encode_www_form(params.keys.zip(params.values))
48
+ uri = URI("https://threatagent.com/api/v1/#{action}?#{encoded_params}")
49
+ resp = Net::HTTP.get_response(uri)
50
+ json = resp.body
51
+ end
52
+ end
53
+ end
@@ -0,0 +1,12 @@
1
+ require 'thor'
2
+ require 'threat_agent'
3
+
4
+ module ThreatAgent
5
+ module Tasks
6
+ # A namespace for Breachbot Thor tasks
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class Breachbot < Thor
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,12 @@
1
+ require 'thor'
2
+ require 'threat_agent'
3
+
4
+ module ThreatAgent
5
+ module Tasks
6
+ # A namespace for Drone Thor tasks
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class Drone < Thor
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,12 @@
1
+ require 'thor'
2
+ require 'threat_agent'
3
+
4
+ module ThreatAgent
5
+ module Tasks
6
+ # A namespace for Exfiltrate Thor tasks
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class Exfiltrate < Thor
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,12 @@
1
+ require 'thor'
2
+ require 'threat_agent'
3
+
4
+ module ThreatAgent
5
+ module Tasks
6
+ # A namespace for Passision Thor tasks
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class Passision < Thor
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,12 @@
1
+ require 'thor'
2
+ require 'threat_agent'
3
+
4
+ module ThreatAgent
5
+ module Tasks
6
+ # A namespace for Phishable Thor tasks
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class Phishable < Thor
10
+ end
11
+ end
12
+ end
@@ -0,0 +1,29 @@
1
+ require 'thor'
2
+ require 'threat_agent'
3
+
4
+ module ThreatAgent
5
+ module Tasks
6
+ # A namespace for Pwnxy Thor tasks
7
+ #
8
+ # @author Erran Carey <me@errancarey.com>
9
+ class Pwnxy < Thor
10
+ desc 'pwnxy info', 'List information on Pwnxy instances'
11
+ def info
12
+ info = $threat_agent_client.request(:pwnxy_info)
13
+ # TODO: Add a UI class/method.
14
+ $stdout.puts info
15
+ end
16
+
17
+ desc 'pwnxy logs [INSTANCE] [OPTIONS]', 'Show logs for a Pwnxy instance'
18
+ # TODO: Add logs(identifier = :last), add support in the TA API
19
+ # Support last/first in the TA API. Currently 0 returns first. Use
20
+ # -1 for last?
21
+ # TODO: Add support for dropping all logs?
22
+ def logs(identifier = 0)
23
+ log = $threat_agent_client.request(:pwnxy_logs, { p: identifier })
24
+ # TODO: Add a UI class/method.
25
+ $stdout.puts log
26
+ end
27
+ end
28
+ end
29
+ end
@@ -0,0 +1,14 @@
1
+ require 'threat_agent/tasks/breachbot'
2
+ require 'threat_agent/tasks/drone'
3
+ require 'threat_agent/tasks/exfiltrate'
4
+ require 'threat_agent/tasks/passision'
5
+ require 'threat_agent/tasks/phishable'
6
+ require 'threat_agent/tasks/pwnxy'
7
+
8
+ module ThreatAgent
9
+ # A namespace for ThreatAgent Thor tasks, used in the threatagent executable
10
+ #
11
+ # @author Erran Carey <me@errancarey.com>
12
+ module Tasks
13
+ end
14
+ end
@@ -0,0 +1,4 @@
1
+ module ThreatAgent
2
+ # The version of the ThreatAgent gem
3
+ VERSION = '1.0.0.beta.1'
4
+ end
@@ -0,0 +1,8 @@
1
+ require 'threat_agent/api_client'
2
+ require 'threat_agent/version'
3
+
4
+ # The primary namespace for the ThreatAgent gem
5
+ #
6
+ # @author Erran Carey <me@errancarey.com>
7
+ module ThreatAgent
8
+ end
@@ -0,0 +1 @@
1
+ # TODO: Implement tests
@@ -0,0 +1,29 @@
1
+ # coding: utf-8
2
+ lib = File.expand_path('../lib', __FILE__)
3
+ $:.unshift(lib) unless $:.include?(lib)
4
+ require 'threat_agent/version'
5
+
6
+ Gem::Specification.new do |spec|
7
+ spec.name = 'threat_agent'
8
+ spec.version = ThreatAgent::VERSION
9
+ spec.authors = ['Erran Carey']
10
+ spec.email = ['me@errancarey.com']
11
+ spec.description = %q{A gem to interface with the Threat Agent API}
12
+ spec.summary = %q{Interact with apps from the Threat Agent website}
13
+ spec.homepage = 'http://developer.threatagent.com'
14
+ spec.license = 'MIT'
15
+
16
+ spec.files = `git ls-files`.split($/)
17
+ spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
18
+ spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
19
+ spec.require_paths = ['lib']
20
+
21
+ spec.add_dependency 'colorize'
22
+ spec.add_dependency 'redcarpet'
23
+ spec.add_dependency 'thor'
24
+ spec.add_dependency 'yard'
25
+
26
+ spec.add_development_dependency 'bundler', '~> 1.3'
27
+ spec.add_development_dependency 'rake'
28
+ spec.add_development_dependency 'rspec'
29
+ end
metadata ADDED
@@ -0,0 +1,183 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: threat_agent
3
+ version: !ruby/object:Gem::Version
4
+ version: 1.0.0.beta.1
5
+ prerelease: 6
6
+ platform: ruby
7
+ authors:
8
+ - Erran Carey
9
+ autorequire:
10
+ bindir: bin
11
+ cert_chain: []
12
+ date: 2013-07-07 00:00:00.000000000 Z
13
+ dependencies:
14
+ - !ruby/object:Gem::Dependency
15
+ name: colorize
16
+ requirement: !ruby/object:Gem::Requirement
17
+ none: false
18
+ requirements:
19
+ - - ! '>='
20
+ - !ruby/object:Gem::Version
21
+ version: '0'
22
+ type: :runtime
23
+ prerelease: false
24
+ version_requirements: !ruby/object:Gem::Requirement
25
+ none: false
26
+ requirements:
27
+ - - ! '>='
28
+ - !ruby/object:Gem::Version
29
+ version: '0'
30
+ - !ruby/object:Gem::Dependency
31
+ name: redcarpet
32
+ requirement: !ruby/object:Gem::Requirement
33
+ none: false
34
+ requirements:
35
+ - - ! '>='
36
+ - !ruby/object:Gem::Version
37
+ version: '0'
38
+ type: :runtime
39
+ prerelease: false
40
+ version_requirements: !ruby/object:Gem::Requirement
41
+ none: false
42
+ requirements:
43
+ - - ! '>='
44
+ - !ruby/object:Gem::Version
45
+ version: '0'
46
+ - !ruby/object:Gem::Dependency
47
+ name: thor
48
+ requirement: !ruby/object:Gem::Requirement
49
+ none: false
50
+ requirements:
51
+ - - ! '>='
52
+ - !ruby/object:Gem::Version
53
+ version: '0'
54
+ type: :runtime
55
+ prerelease: false
56
+ version_requirements: !ruby/object:Gem::Requirement
57
+ none: false
58
+ requirements:
59
+ - - ! '>='
60
+ - !ruby/object:Gem::Version
61
+ version: '0'
62
+ - !ruby/object:Gem::Dependency
63
+ name: yard
64
+ requirement: !ruby/object:Gem::Requirement
65
+ none: false
66
+ requirements:
67
+ - - ! '>='
68
+ - !ruby/object:Gem::Version
69
+ version: '0'
70
+ type: :runtime
71
+ prerelease: false
72
+ version_requirements: !ruby/object:Gem::Requirement
73
+ none: false
74
+ requirements:
75
+ - - ! '>='
76
+ - !ruby/object:Gem::Version
77
+ version: '0'
78
+ - !ruby/object:Gem::Dependency
79
+ name: bundler
80
+ requirement: !ruby/object:Gem::Requirement
81
+ none: false
82
+ requirements:
83
+ - - ~>
84
+ - !ruby/object:Gem::Version
85
+ version: '1.3'
86
+ type: :development
87
+ prerelease: false
88
+ version_requirements: !ruby/object:Gem::Requirement
89
+ none: false
90
+ requirements:
91
+ - - ~>
92
+ - !ruby/object:Gem::Version
93
+ version: '1.3'
94
+ - !ruby/object:Gem::Dependency
95
+ name: rake
96
+ requirement: !ruby/object:Gem::Requirement
97
+ none: false
98
+ requirements:
99
+ - - ! '>='
100
+ - !ruby/object:Gem::Version
101
+ version: '0'
102
+ type: :development
103
+ prerelease: false
104
+ version_requirements: !ruby/object:Gem::Requirement
105
+ none: false
106
+ requirements:
107
+ - - ! '>='
108
+ - !ruby/object:Gem::Version
109
+ version: '0'
110
+ - !ruby/object:Gem::Dependency
111
+ name: rspec
112
+ requirement: !ruby/object:Gem::Requirement
113
+ none: false
114
+ requirements:
115
+ - - ! '>='
116
+ - !ruby/object:Gem::Version
117
+ version: '0'
118
+ type: :development
119
+ prerelease: false
120
+ version_requirements: !ruby/object:Gem::Requirement
121
+ none: false
122
+ requirements:
123
+ - - ! '>='
124
+ - !ruby/object:Gem::Version
125
+ version: '0'
126
+ description: A gem to interface with the Threat Agent API
127
+ email:
128
+ - me@errancarey.com
129
+ executables:
130
+ - threatagent
131
+ extensions: []
132
+ extra_rdoc_files: []
133
+ files:
134
+ - .gitignore
135
+ - .travis.yml
136
+ - Gemfile
137
+ - LICENSE
138
+ - README.md
139
+ - Thorfile
140
+ - bin/threatagent
141
+ - lib/threat_agent.rb
142
+ - lib/threat_agent/api_client.rb
143
+ - lib/threat_agent/tasks.rb
144
+ - lib/threat_agent/tasks/breachbot.rb
145
+ - lib/threat_agent/tasks/drone.rb
146
+ - lib/threat_agent/tasks/exfiltrate.rb
147
+ - lib/threat_agent/tasks/passision.rb
148
+ - lib/threat_agent/tasks/phishable.rb
149
+ - lib/threat_agent/tasks/pwnxy.rb
150
+ - lib/threat_agent/version.rb
151
+ - spec/default_spec.rb
152
+ - threat_agent.gemspec
153
+ homepage: http://developer.threatagent.com
154
+ licenses:
155
+ - MIT
156
+ post_install_message:
157
+ rdoc_options: []
158
+ require_paths:
159
+ - lib
160
+ required_ruby_version: !ruby/object:Gem::Requirement
161
+ none: false
162
+ requirements:
163
+ - - ! '>='
164
+ - !ruby/object:Gem::Version
165
+ version: '0'
166
+ segments:
167
+ - 0
168
+ hash: -3825142359742865107
169
+ required_rubygems_version: !ruby/object:Gem::Requirement
170
+ none: false
171
+ requirements:
172
+ - - ! '>'
173
+ - !ruby/object:Gem::Version
174
+ version: 1.3.1
175
+ requirements: []
176
+ rubyforge_project:
177
+ rubygems_version: 1.8.25
178
+ signing_key:
179
+ specification_version: 3
180
+ summary: Interact with apps from the Threat Agent website
181
+ test_files:
182
+ - spec/default_spec.rb
183
+ has_rdoc: