censu 0.1.1

data/spec/report_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+describe Censys::API do
+  before(:context) do
+    @api = Censys::API.new
+  end
+
+  describe "#report", :vcr do
+    context "ipv4" do
+      it "should return ipv4 response" do
+        params = {
+          query: "8.8.8.8",
+          field: "ports",
+          buckets: 10
+        }
+        report = @api.report(:ipv4, params)
+        expect(report).to be_a(Report::Response)
+        expect(report.status).to eq("ok")
+        expect(report.ok?).to be_truthy
+        expect(report.results).to be_a(Hash)
+        expect(report.metadata).to be_a(Report::Metadata)
+        expect(report.metadata.count).to be_a(Integer)
+        expect(report.metadata.backend_time).to be_a(Integer)
+        expect(report.metadata.non_null_count).to be_a(Integer)
+        expect(report.metadata.other_result_count).to be_a(Integer)
+        expect(report.metadata.buckets).to be_a(Integer)
+        expect(report.metadata.error_bound).to be_a(Integer)
+        expect(report.metadata.query).to eq("8.8.8.8")
+      end
+    end
+
+    context "websites" do
+      it "should return website response" do
+        params = {
+          query: "google.com",
+          field: "ports",
+          buckets: 10
+        }
+        report = @api.report(:websites, params)
+        expect(report).to be_a(Report::Response)
+        expect(report.metadata).to be_a(Report::Metadata)
+        expect(report.metadata.query).to eq("google.com")
+      end
+    end
+
+    context "certificates" do
+      it "should return certificate response" do
+        params = {
+          query: "google.com",
+          field: "precert",
+          buckets: 10
+        }
+        report = @api.report(:certificates, params)
+        expect(report).to be_a(Report::Response)
+        expect(report.metadata).to be_a(Report::Metadata)
+        expect(report.metadata.query).to eq("google.com")
+      end
+    end
+  end
+end

data/spec/search_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe Censys::API do
+  before(:context) do
+    @api = Censys::API.new
+  end
+
+  describe "#search", :vcr do
+    context "ipv4" do
+      it "should return IPv4 response" do
+        res = @api.ipv4.search(query: "dropbox.com")
+        expect(res).to be_a(Search::Response)
+        expect(res.metadata).to be_a(Search::Metadata)
+        expect(res.each).to be_a(Enumerator)
+        expect(res.pages).to be_a(Enumerator)
+
+        first = res.results.first
+        expect(first).to be_a(Search::IPv4)
+        expect(first.ip).to be_a(String)
+        expect(first.protocols).to be_a(Array)
+      end
+    end
+
+    context "websites" do
+      it "should return Website response" do
+        res = @api.websites.search(query: "dropbox.com")
+        expect(res).to be_a(Search::Response)
+
+        first = res.results.first
+        expect(first).to be_a(Search::Website)
+        expect(first.domain).to be_a(String)
+        expect(first.alexa_rank).to be_a(Integer)
+      end
+    end
+
+    context "certificates" do
+      it "should return Certificate response" do
+        res = @api.certificates.search(query: "dropbox.com")
+        expect(res).to be_a(Search::Response)
+
+        first = res.results.first
+        expect(first).to be_a(Search::Certificate)
+        expect(first.fingerprint_sha256).to be_a(String)
+        expect(first.subject_dn).to be_a(String)
+        expect(first.issuer_dn).to be_a(String)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'dotenv/load'
+require 'rspec'
+require 'vcr'
+require 'censys'
+
+include Censys
+
+def authorization_field
+  require 'base64'
+  token = "#{ENV['CENSYS_ID']}:#{ENV['CENSYS_SECRET']}"
+  "Basic #{Base64.strict_encode64(token)}"
+end
+
+VCR.configure do |config|
+  config.cassette_library_dir = "spec/fixtures/vcr_cassettes"
+  config.hook_into :webmock
+  config.configure_rspec_metadata!
+  config.filter_sensitive_data("<CENSORED>") { authorization_field }
+end

data/spec/view_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Censys::API do
+  before(:context) do
+    @api = Censys::API.new
+  end
+
+  describe "#view", :vcr do
+    context "ipv4" do
+      it "should return IPv4 response" do
+        view = @api.view(:ipv4, "8.8.8.8")
+        expect(view).to be_a(Censys::IPv4)
+        expect(view.tags).to be_a(Array)
+        expect(view.updated_at).to be_a(Time)
+        expect(view.autonomous_system).to be_a(AutonomousSystem)
+        expect(view.location).to be_a(Location)
+        expect(view.ports).to be_a(Hash)
+        expect(view.protocols).to be_a(Array)
+        expect(view.dig("location", "city")).to eq("Mountain View")
+
+        expect(view.ip).to eq("8.8.8.8")
+        expect(view.to_s).to eq("8.8.8.8")
+        expect(view.protocols).to be_a(Array)
+      end
+    end
+
+    context "websites" do
+      it "should return Website response" do
+        view = @api.view(:websites, "google.com")
+        expect(view).to be_a(Censys::Website)
+        expect(view.domain).to eq("google.com")
+        expect(view.to_s).to eq("google.com")
+        expect(view.alexa_rank).to be_a(Integer)
+      end
+    end
+
+    context "certificates" do
+      it "should return Certificate response" do
+        sha256 = "821a712a29d8e25915f66a9771519746c5aa73a45321fd4ca7ef644e1cadda59"
+        view = @api.view(:certificates, sha256)
+        expect(view).to be_a(Censys::Certificate)
+        expect(view.raw).to be_a(String)
+        expect(view.parsed).to be_a(Hash)
+        expect(view.valid_nss).to eq(true)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,219 @@
+--- !ruby/object:Gem::Specification
+name: censu
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Manabu Niseki
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-12-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Ruby API client for the Censys Internet search engine.
+email: manabu.niseki@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".codeclimate.yml"
+- ".document"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- ".yardopts"
+- ChangeLog.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- censys.gemspec
+- lib/censys.rb
+- lib/censys/api.rb
+- lib/censys/autonomous_system.rb
+- lib/censys/certificate.rb
+- lib/censys/document.rb
+- lib/censys/document/has_asn.rb
+- lib/censys/document/has_location.rb
+- lib/censys/document/has_services.rb
+- lib/censys/exceptions.rb
+- lib/censys/ipv4.rb
+- lib/censys/location.rb
+- lib/censys/report.rb
+- lib/censys/report/metadata.rb
+- lib/censys/report/response.rb
+- lib/censys/search.rb
+- lib/censys/search/certificate.rb
+- lib/censys/search/ipv4.rb
+- lib/censys/search/metadata.rb
+- lib/censys/search/response.rb
+- lib/censys/search/result.rb
+- lib/censys/search/website.rb
+- lib/censys/version.rb
+- lib/censys/website.rb
+- spec/censys_spec.rb
+- spec/fixtures/vcr_cassettes/Censys_API/_report/certificates/should_return_certificate_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_report/ipv4/should_return_ipv4_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_report/websites/should_return_website_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_search/certificates/should_return_Certificate_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_search/ipv4/should_return_IPv4_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_search/websites/should_return_Website_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_view/certificates/should_return_Certificate_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_view/ipv4/should_return_IPv4_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_view/websites/should_return_Website_response.yml
+- spec/report_spec.rb
+- spec/search_spec.rb
+- spec/spec_helper.rb
+- spec/view_spec.rb
+homepage: https://github.com/ninoseki/censu
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: API client for censys.io
+test_files:
+- spec/censys_spec.rb
+- spec/fixtures/vcr_cassettes/Censys_API/_report/certificates/should_return_certificate_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_report/ipv4/should_return_ipv4_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_report/websites/should_return_website_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_search/certificates/should_return_Certificate_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_search/ipv4/should_return_IPv4_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_search/websites/should_return_Website_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_view/certificates/should_return_Certificate_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_view/ipv4/should_return_IPv4_response.yml
+- spec/fixtures/vcr_cassettes/Censys_API/_view/websites/should_return_Website_response.yml
+- spec/report_spec.rb
+- spec/search_spec.rb
+- spec/spec_helper.rb
+- spec/view_spec.rb