httpcap-rb 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 5395126f833961ee4394e9db74233d311b37d17c3509fbca61789a458d65c11a
4
+ data.tar.gz: bda1268e5f8a9088c49e53429d42d6e720243667e1f76dcdd87373f948bb736b
5
+ SHA512:
6
+ metadata.gz: 560de6e2e6e89edac6776f4231c3fad9699262cbda732353a58269b92d60a1dd50d5e7ddafac2dc4fdc3d9fd48a8f811b1c7644e30da43a71a8cbdd125fc52f6
7
+ data.tar.gz: bc12ea968fb4e88e308924acd473d4c65105b3e3f77204452d616fd37d35d93e4f307c7831793377bbb0d675f0a4eeb14b3dfed87687c6adda7632c5f9614c8c
@@ -0,0 +1,11 @@
1
+ /.bundle/
2
+ /.yardoc
3
+ /_yardoc/
4
+ /coverage/
5
+ /doc/
6
+ /pkg/
7
+ /spec/reports/
8
+ /tmp/
9
+
10
+ # rspec failure tracking
11
+ .rspec_status
data/.rspec ADDED
@@ -0,0 +1,3 @@
1
+ --format documentation
2
+ --color
3
+ --require spec_helper
@@ -0,0 +1,13 @@
1
+ Metrics/BlockLength:
2
+ CountComments: false
3
+ Max: 25
4
+ ExcludedMethods: []
5
+ Exclude:
6
+ - spec/**/*_spec.rb
7
+ - ./*.gemspec
8
+
9
+ Metrics/LineLength:
10
+ Max: 180
11
+
12
+ Metrics/MethodLength:
13
+ Max: 20
@@ -0,0 +1,7 @@
1
+ ---
2
+ sudo: false
3
+ language: ruby
4
+ cache: bundler
5
+ rvm:
6
+ - 2.5.0
7
+ before_install: gem install bundler -v 2.0.1
data/Gemfile ADDED
@@ -0,0 +1,6 @@
1
+ # frozen_string_literal: true
2
+
3
+ source 'https://rubygems.org'
4
+
5
+ # Specify your gem's dependencies in httpcap.gemspec
6
+ gemspec
@@ -0,0 +1,72 @@
1
+ PATH
2
+ remote: .
3
+ specs:
4
+ httpcap-rb (0.1.0)
5
+ http-parser-lite
6
+ reassemble_tcp
7
+
8
+ GEM
9
+ remote: https://rubygems.org/
10
+ specs:
11
+ ast (2.4.0)
12
+ byebug (10.0.2)
13
+ coderay (1.1.2)
14
+ diff-lcs (1.3)
15
+ http-parser-lite (0.6.0)
16
+ jaro_winkler (1.5.2)
17
+ method_source (0.9.2)
18
+ packetfu (1.1.13)
19
+ pcaprub
20
+ parallel (1.13.0)
21
+ parser (2.6.0.0)
22
+ ast (~> 2.4.0)
23
+ pcaprub (0.13.0)
24
+ powerpack (0.1.2)
25
+ pry (0.12.2)
26
+ coderay (~> 1.1.0)
27
+ method_source (~> 0.9.0)
28
+ pry-byebug (3.6.0)
29
+ byebug (~> 10.0)
30
+ pry (~> 0.10)
31
+ rainbow (3.0.0)
32
+ rake (10.5.0)
33
+ reassemble_tcp (0.0.2)
34
+ packetfu (~> 1.1.9)
35
+ rspec (3.8.0)
36
+ rspec-core (~> 3.8.0)
37
+ rspec-expectations (~> 3.8.0)
38
+ rspec-mocks (~> 3.8.0)
39
+ rspec-core (3.8.0)
40
+ rspec-support (~> 3.8.0)
41
+ rspec-expectations (3.8.2)
42
+ diff-lcs (>= 1.2.0, < 2.0)
43
+ rspec-support (~> 3.8.0)
44
+ rspec-mocks (3.8.0)
45
+ diff-lcs (>= 1.2.0, < 2.0)
46
+ rspec-support (~> 3.8.0)
47
+ rspec-support (3.8.0)
48
+ rubocop (0.63.1)
49
+ jaro_winkler (~> 1.5.1)
50
+ parallel (~> 1.10)
51
+ parser (>= 2.5, != 2.5.1.1)
52
+ powerpack (~> 0.1)
53
+ rainbow (>= 2.2.2, < 4.0)
54
+ ruby-progressbar (~> 1.7)
55
+ unicode-display_width (~> 1.4.0)
56
+ ruby-progressbar (1.10.0)
57
+ unicode-display_width (1.4.1)
58
+
59
+ PLATFORMS
60
+ ruby
61
+
62
+ DEPENDENCIES
63
+ bundler (~> 2.0)
64
+ httpcap-rb!
65
+ pry
66
+ pry-byebug
67
+ rake (~> 10.0)
68
+ rspec (~> 3.0)
69
+ rubocop
70
+
71
+ BUNDLED WITH
72
+ 2.0.1
@@ -0,0 +1,47 @@
1
+ # HTTPcap
2
+
3
+ parse pcap, then return http request and response
4
+
5
+ ## Installation
6
+
7
+ Add this line to your application's Gemfile:
8
+
9
+ ```ruby
10
+ gem 'httpcap-rb'
11
+ ```
12
+
13
+ And then execute:
14
+
15
+ $ bundle
16
+
17
+ Or install it yourself as:
18
+
19
+ $ gem install httpcap
20
+
21
+ ## Usage
22
+
23
+ ```ruby
24
+ require 'httpcap'
25
+ HTTPcap.http_flows('./http.pcap') do |flow|
26
+ p flow.request.body
27
+ # => "{\"userId\":12345}"
28
+ p flow.request.headers['Authorization']
29
+ # => "Bearer hogehoge123455567890"
30
+ p flow.response.http_status
31
+ # => 200
32
+ p flow.response.body
33
+ # => "{\"userId\":12345,\"name\":\"naari3\",\"author\":true}"
34
+ p flow.request.headers['Content-Length']
35
+ # => "46"
36
+ end
37
+ ```
38
+
39
+ ## Development
40
+
41
+ After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
42
+
43
+ To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
44
+
45
+ ## Contributing
46
+
47
+ Bug reports and pull requests are welcome on GitHub at https://github.com/naari3/httpcap.
@@ -0,0 +1,8 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'bundler/gem_tasks'
4
+ require 'rspec/core/rake_task'
5
+
6
+ RSpec::Core::RakeTask.new(:spec)
7
+
8
+ task default: :spec
@@ -0,0 +1,11 @@
1
+ #!/usr/bin/env ruby
2
+ # frozen_string_literal: true
3
+
4
+ require 'bundler/setup'
5
+ require 'httpcap'
6
+
7
+ # You can add fixtures and/or initialization code here to make experimenting
8
+ # with your gem easier. You can also use a different console, if you like.
9
+
10
+ require 'pry'
11
+ Pry.start
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ IFS=$'\n\t'
4
+ set -vx
5
+
6
+ bundle install
7
+
8
+ # Do any other automated setup that you need to do here
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ lib = File.expand_path('lib', __dir__)
4
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
5
+ require 'httpcap/version'
6
+
7
+ Gem::Specification.new do |spec|
8
+ spec.name = 'httpcap-rb'
9
+ spec.version = HTTPcap::VERSION
10
+ spec.authors = ['naari3']
11
+ spec.email = ['naari.named@gmail.com']
12
+
13
+ spec.summary = 'parse pcap, then return http request and response'
14
+ spec.description = spec.summary
15
+ spec.homepage = 'https://github.com/naari3/httpcap'
16
+
17
+ # Specify which files should be added to the gem when it is released.
18
+ # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
19
+ spec.files = Dir.chdir(File.expand_path(__dir__)) do
20
+ `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
21
+ end
22
+ spec.bindir = 'exe'
23
+ spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
24
+ spec.require_paths = ['lib']
25
+
26
+ spec.add_dependency 'http-parser-lite'
27
+ spec.add_dependency 'reassemble_tcp'
28
+
29
+ spec.add_development_dependency 'bundler', '~> 2.0'
30
+ spec.add_development_dependency 'pry'
31
+ spec.add_development_dependency 'pry-byebug'
32
+ spec.add_development_dependency 'rake', '~> 10.0'
33
+ spec.add_development_dependency 'rspec', '~> 3.0'
34
+ spec.add_development_dependency 'rubocop'
35
+ end
@@ -0,0 +1,40 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'reassemble_tcp'
4
+
5
+ require 'httpcap/version'
6
+ require 'httpcap/http_flow'
7
+ require 'httpcap/request'
8
+ require 'httpcap/response'
9
+
10
+ # HTTPcap - parse pcap, then return http request and response
11
+ module HTTPcap
12
+ class Error < StandardError; end
13
+
14
+ def self.send_recv_combined_tcp_data(filepath)
15
+ Enumerator.new do |y|
16
+ ReassembleTcp.tcp_connections(filepath).map do |stream|
17
+ stream.tcpdata.each_slice(2) do |tcp_send, tcp_recv|
18
+ y << [tcp_send, tcp_recv]
19
+ end
20
+ end
21
+ end
22
+ end
23
+
24
+ # get HTTP request and response from pcap file
25
+ # @param [String] filepath pcapfile path
26
+ # @return [Array<HTTPcap::HTTPConnection>] http connections
27
+ def self.http_flows(filepath)
28
+ Enumerator.new do |y|
29
+ send_recv_combined_tcp_data(filepath) do |tcp_send, tcp_recv|
30
+ recv, send = [tcp_send, tcp_recv].sort_by { |tcp| tcp[1] }
31
+ next unless send[1] == :send && recv[1] == :recv
32
+
33
+ request = Request.new(send[2])
34
+ response = Response.new(recv[2])
35
+
36
+ y << HTTPFlow.new(request, response)
37
+ end
38
+ end
39
+ end
40
+ end
@@ -0,0 +1,37 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'forwardable'
4
+
5
+ module HTTPcap
6
+ # http headers for http-parser
7
+ class Headers
8
+ extend Forwardable
9
+
10
+ TYPE_FIELD = :f
11
+ TYPE_VALUE = :v
12
+
13
+ %i[fetch [] each map].each do |method|
14
+ def_delegator :@content, method, method
15
+ end
16
+
17
+ def initialize
18
+ @content = {}
19
+ @bucket = []
20
+ @state = nil
21
+ end
22
+
23
+ def stream(type, value)
24
+ if @state == type
25
+ @bucket[-1] += value
26
+ else
27
+ @bucket << value
28
+ end
29
+ @state = type
30
+ end
31
+
32
+ def stream_complete
33
+ @content.merge!(@bucket.each_slice(2).to_a.select { |a| a.size == 2 }.to_h)
34
+ @bucket.clear
35
+ end
36
+ end
37
+ end
@@ -0,0 +1,15 @@
1
+ # frozen_string_literal: true
2
+
3
+ module HTTPcap
4
+ # Combining request and response
5
+ class HTTPFlow
6
+ attr_reader :request, :response
7
+
8
+ # @param [HTTPcap::Request] request
9
+ # @param [HTTPcap::Response] response
10
+ def initialize(request, response)
11
+ @request = request
12
+ @response = response
13
+ end
14
+ end
15
+ end
@@ -0,0 +1,48 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'http-parser'
4
+
5
+ require 'httpcap/headers'
6
+
7
+ module HTTPcap
8
+ # Message is a abstract class for Request and Response
9
+ class Message
10
+ attr_reader :body, :headers
11
+
12
+ # @param [Integer] type request or response
13
+ def initialize(type, data)
14
+ @parser = HTTP::Parser.new(type)
15
+ @headers = Headers.new
16
+ @body = ''
17
+
18
+ %i[on_message_complete on_url on_header_field on_header_value on_headers_complete on_body].each do |name|
19
+ @parser.send(name, &method(name))
20
+ end
21
+ receive_data(data)
22
+ end
23
+
24
+ def receive_data(data)
25
+ @parser << data
26
+ end
27
+
28
+ def on_message_complete; end
29
+
30
+ def on_url; end
31
+
32
+ def on_header_field(value)
33
+ @headers.stream(Headers::TYPE_FIELD, value)
34
+ end
35
+
36
+ def on_header_value(value)
37
+ @headers.stream(Headers::TYPE_VALUE, value)
38
+ end
39
+
40
+ def on_headers_complete
41
+ @headers.stream_complete
42
+ end
43
+
44
+ def on_body(data)
45
+ @body += data
46
+ end
47
+ end
48
+ end
@@ -0,0 +1,29 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'httpcap/message'
4
+
5
+ module HTTPcap
6
+ # Request
7
+ class Request < Message
8
+ attr_reader :http_method
9
+
10
+ def initialize(data)
11
+ @http_method = ''
12
+ @relative_url = ''
13
+
14
+ super(HTTP::Parser::TYPE_REQUEST, data)
15
+ end
16
+
17
+ def url
18
+ @headers.fetch('Host', '') + @relative_url
19
+ end
20
+
21
+ def on_url(url)
22
+ @relative_url = url
23
+ end
24
+
25
+ def on_message_complete
26
+ @http_method = @parser.http_method
27
+ end
28
+ end
29
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'httpcap/message'
4
+
5
+ module HTTPcap
6
+ # Response
7
+ class Response < Message
8
+ attr_reader :http_status
9
+
10
+ def initialize(data)
11
+ @http_status = ''
12
+
13
+ super(HTTP::Parser::TYPE_RESPONSE, data)
14
+ end
15
+
16
+ def on_message_complete
17
+ @http_status = @parser.http_status
18
+ end
19
+ end
20
+ end
@@ -0,0 +1,5 @@
1
+ # frozen_string_literal: true
2
+
3
+ module HTTPcap
4
+ VERSION = '0.1.0'
5
+ end
metadata ADDED
@@ -0,0 +1,173 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: httpcap-rb
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - naari3
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2019-02-10 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: http-parser-lite
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: '0'
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ version: '0'
27
+ - !ruby/object:Gem::Dependency
28
+ name: reassemble_tcp
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - ">="
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ - !ruby/object:Gem::Dependency
42
+ name: bundler
43
+ requirement: !ruby/object:Gem::Requirement
44
+ requirements:
45
+ - - "~>"
46
+ - !ruby/object:Gem::Version
47
+ version: '2.0'
48
+ type: :development
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - "~>"
53
+ - !ruby/object:Gem::Version
54
+ version: '2.0'
55
+ - !ruby/object:Gem::Dependency
56
+ name: pry
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - ">="
60
+ - !ruby/object:Gem::Version
61
+ version: '0'
62
+ type: :development
63
+ prerelease: false
64
+ version_requirements: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - ">="
67
+ - !ruby/object:Gem::Version
68
+ version: '0'
69
+ - !ruby/object:Gem::Dependency
70
+ name: pry-byebug
71
+ requirement: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - ">="
74
+ - !ruby/object:Gem::Version
75
+ version: '0'
76
+ type: :development
77
+ prerelease: false
78
+ version_requirements: !ruby/object:Gem::Requirement
79
+ requirements:
80
+ - - ">="
81
+ - !ruby/object:Gem::Version
82
+ version: '0'
83
+ - !ruby/object:Gem::Dependency
84
+ name: rake
85
+ requirement: !ruby/object:Gem::Requirement
86
+ requirements:
87
+ - - "~>"
88
+ - !ruby/object:Gem::Version
89
+ version: '10.0'
90
+ type: :development
91
+ prerelease: false
92
+ version_requirements: !ruby/object:Gem::Requirement
93
+ requirements:
94
+ - - "~>"
95
+ - !ruby/object:Gem::Version
96
+ version: '10.0'
97
+ - !ruby/object:Gem::Dependency
98
+ name: rspec
99
+ requirement: !ruby/object:Gem::Requirement
100
+ requirements:
101
+ - - "~>"
102
+ - !ruby/object:Gem::Version
103
+ version: '3.0'
104
+ type: :development
105
+ prerelease: false
106
+ version_requirements: !ruby/object:Gem::Requirement
107
+ requirements:
108
+ - - "~>"
109
+ - !ruby/object:Gem::Version
110
+ version: '3.0'
111
+ - !ruby/object:Gem::Dependency
112
+ name: rubocop
113
+ requirement: !ruby/object:Gem::Requirement
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
+ requirements:
122
+ - - ">="
123
+ - !ruby/object:Gem::Version
124
+ version: '0'
125
+ description: parse pcap, then return http request and response
126
+ email:
127
+ - naari.named@gmail.com
128
+ executables: []
129
+ extensions: []
130
+ extra_rdoc_files: []
131
+ files:
132
+ - ".gitignore"
133
+ - ".rspec"
134
+ - ".rubocop.yml"
135
+ - ".travis.yml"
136
+ - Gemfile
137
+ - Gemfile.lock
138
+ - README.md
139
+ - Rakefile
140
+ - bin/console
141
+ - bin/setup
142
+ - httpcap.gemspec
143
+ - lib/httpcap.rb
144
+ - lib/httpcap/headers.rb
145
+ - lib/httpcap/http_flow.rb
146
+ - lib/httpcap/message.rb
147
+ - lib/httpcap/request.rb
148
+ - lib/httpcap/response.rb
149
+ - lib/httpcap/version.rb
150
+ homepage: https://github.com/naari3/httpcap
151
+ licenses: []
152
+ metadata: {}
153
+ post_install_message:
154
+ rdoc_options: []
155
+ require_paths:
156
+ - lib
157
+ required_ruby_version: !ruby/object:Gem::Requirement
158
+ requirements:
159
+ - - ">="
160
+ - !ruby/object:Gem::Version
161
+ version: '0'
162
+ required_rubygems_version: !ruby/object:Gem::Requirement
163
+ requirements:
164
+ - - ">="
165
+ - !ruby/object:Gem::Version
166
+ version: '0'
167
+ requirements: []
168
+ rubyforge_project:
169
+ rubygems_version: 2.7.3
170
+ signing_key:
171
+ specification_version: 4
172
+ summary: parse pcap, then return http request and response
173
+ test_files: []