soleranetworks 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,29 +1,34 @@
1
- # soleranetworks
1
+ = soleranetworks
2
2
 
3
3
  Solera Networks API Gem
4
4
 
5
- ## Description
5
+ = Description
6
6
 
7
7
  Handy little library and binary to automate building Solera Networks REST API calls
8
8
 
9
- ### lib/soleranetworks.rb
9
+ == More Examples
10
+
11
+ Looking for more examples of Solera Networks' API usage in various other scripting languages? Check here: http://github.com/fracBlend/Solera-Example-Scripts
12
+
13
+ == lib/soleranetworks.rb
10
14
 
11
15
  Library for use in your own ruby scripts to build API Call URIs
12
16
 
13
- ### solera_get
17
+ == solera_get
14
18
 
15
19
  Command line tool that automatically builds an API Call and grabs the resulting PCAP.
16
20
 
17
- ## Where to get a Demo VM Appliance
21
+ = Where to get a Demo VM Appliance
18
22
 
19
23
  Don't have a Solera DS Network Forensics Appliance?
20
24
 
21
25
  Download a [VMWare Based Demo Appliance](http://www.soleranetworks.com/products/network-forensics-appliances/virtual-appliance)
22
26
 
23
- ## Install
27
+
28
+ = Install
24
29
  $ sudo gem install soleranetworks
25
- ## Usage (solera_get)
26
- ### Command Line Options
30
+ = Usage (solera_get)
31
+ == Command Line Options
27
32
  $ solera_get -h
28
33
  Usage: solera_get [options] host ...
29
34
  -v, --verbose Output more information
@@ -61,13 +66,14 @@ Download a [VMWare Based Demo Appliance](http://www.soleranetworks.com/products/
61
66
  --vlan_id VLAN_ID vlan_id
62
67
  -h, --help Display this screen
63
68
 
64
- ### Pull all traffic from 1.2.3.4
69
+ == Pull all traffic from 1.2.3.4
65
70
  $ solera_get -u username -p password --ipv4_address 1.2.3.4
66
- ### Pull all traffic from 1.2.3.4 occurring on 03/02/2010
71
+ == Pull all traffic from 1.2.3.4 occurring on 03/02/2010
67
72
  $ solera_get -u username -p password --ipv4_address 1.2.3.4 --timespan 03.02.2010.00.00.00.03.03.2010.00.00.00
68
- ### Pull all DNS traffic larger than 52 bytes
73
+ == Pull all DNS traffic larger than 52 bytes
69
74
  $ solera_get -u username -p password --udp_port 53 --packet_length 53_to_1549
70
- ## Usage lib/soleranetworks.rb
75
+ = Usage lib/soleranetworks.rb
76
+ == Example Script
71
77
  require 'rubygems'
72
78
  require 'soleranetworks'
73
79
 
@@ -76,7 +82,7 @@ Download a [VMWare Based Demo Appliance](http://www.soleranetworks.com/products/
76
82
  :user => 'admin',
77
83
  :pass => 'somePassword',
78
84
  :ipv4_address => '1.2.3.4',
79
- :timespan => (Time.now.getlocal-(60*5)).strftime('%m.%d.%Y.%H.%M.%S')+"."+Time.now.getlocal.strftime('%m.%d.%Y.%H.%M.%S')
85
+ :timespan => (Time.now.getlocal-(60*5)).strftime('%m.%d.%Y.%H.%M.%S')+"."+Time.now.getlocal.strftime('%m.%d.%Y.%H.%M.%S')
80
86
  }
81
87
  request = SoleraNetworks.new(options)
82
88
 
@@ -84,7 +90,7 @@ Download a [VMWare Based Demo Appliance](http://www.soleranetworks.com/products/
84
90
  puts request.uri
85
91
  # https://192.168.20.20/ws/pcap?method=deepsee&user=admin&password=somePassword&path=%2Ftimespan%2F03.25.2010.14.14.37.03.25.2010.14.19.37%2Fipv4_address%2F1.2.3.4%2Fdata.pcap
86
92
 
87
- ## Note on Patches/Pull Requests
93
+ = Note on Patches/Pull Requests
88
94
 
89
95
  * Fork the project.
90
96
  * Make your feature addition or bug fix.
@@ -94,6 +100,6 @@ Download a [VMWare Based Demo Appliance](http://www.soleranetworks.com/products/
94
100
  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
95
101
  * Send me a pull request. Bonus points for topic branches.
96
102
 
97
- ## Copyright
103
+ = Copyright
98
104
 
99
105
  Copyright (c) 2010 fracBlend. See LICENSE for details.
data/VERSION CHANGED
@@ -1 +1 @@
1
- 0.1.4
1
+ 0.1.6
@@ -28,15 +28,15 @@ class SoleraNetworks
28
28
  # GEM Specific Method Paramaters
29
29
  #
30
30
  # DS Appliance Hostname / IP
31
- :host => '', # ie: 192.168.20.20
31
+ :host => '', # ie: 192.168.20.20
32
32
  # Username for Accessing API
33
- :user => '',
33
+ :user => '',
34
34
  # Password
35
- :pass => '',
35
+ :pass => '',
36
36
  # Filename for returned PCAP
37
- :output_filename => "data.pcap",
37
+ :output_filename => "data.pcap",
38
38
  # Type of Request URI ['pcap', 'sonar', 'applications', 'conversations', 'packetsizes', 'ipdiscovery', 'bandwidth']
39
- :type => 'pcap',
39
+ :type => 'pcap',
40
40
  #
41
41
  # DeepSee API Method Parameters
42
42
  #
@@ -132,7 +132,7 @@ class SoleraNetworks
132
132
 
133
133
  def get_pcap(call)
134
134
  open(call, 'User-Agent' => 'Wget') {|call| @pcap = call.read}
135
- File.open(@options[:output_filename], 'w') {|file|
135
+ File.open(@options[:output_filename], 'wb') {|file|
136
136
  file.write(@pcap)
137
137
  puts "#{@options[:output_filename]} : " + make_readable(file.stat.size, 2)
138
138
  }
@@ -5,24 +5,24 @@
5
5
 
6
6
  Gem::Specification.new do |s|
7
7
  s.name = %q{soleranetworks}
8
- s.version = "0.1.4"
8
+ s.version = "0.1.6"
9
9
 
10
10
  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
11
  s.authors = ["fracBlend"]
12
- s.date = %q{2010-03-25}
12
+ s.date = %q{2010-04-01}
13
13
  s.default_executable = %q{solera_get}
14
14
  s.description = %q{Solera Neworks API gem}
15
15
  s.email = %q{gbelknap@soleranetworks.com}
16
16
  s.executables = ["solera_get"]
17
17
  s.extra_rdoc_files = [
18
18
  "LICENSE",
19
- "README.md"
19
+ "README.rdoc"
20
20
  ]
21
21
  s.files = [
22
22
  ".document",
23
23
  ".gitignore",
24
24
  "LICENSE",
25
- "README.md",
25
+ "README.rdoc",
26
26
  "Rakefile",
27
27
  "VERSION",
28
28
  "bin/solera_get",
metadata CHANGED
@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
5
5
  segments:
6
6
  - 0
7
7
  - 1
8
- - 4
9
- version: 0.1.4
8
+ - 6
9
+ version: 0.1.6
10
10
  platform: ruby
11
11
  authors:
12
12
  - fracBlend
@@ -14,7 +14,7 @@ autorequire:
14
14
  bindir: bin
15
15
  cert_chain: []
16
16
 
17
- date: 2010-03-25 00:00:00 -06:00
17
+ date: 2010-04-01 00:00:00 -06:00
18
18
  default_executable: solera_get
19
19
  dependencies: []
20
20
 
@@ -26,12 +26,12 @@ extensions: []
26
26
 
27
27
  extra_rdoc_files:
28
28
  - LICENSE
29
- - README.md
29
+ - README.rdoc
30
30
  files:
31
31
  - .document
32
32
  - .gitignore
33
33
  - LICENSE
34
- - README.md
34
+ - README.rdoc
35
35
  - Rakefile
36
36
  - VERSION
37
37
  - bin/solera_get