Giter Club home page Giter Club logo

censys-ruby's Introduction

CenSys

Description

Ruby API client to the CenSys internet search engine.

Features

Examples

Initialize the API:

require 'censys'
api = CenSys::API.new(uid,secret)

Initialize the API using $CENSYS_ID and $CENSYS_SECRET environment variables:

api = CenSys::API.new

Search for IPv4 addresses:

response = api.ipv4.search(query: 'dropbox.com')

Search for Websites:

response = api.websites.search(query: 'dropbox.com')

Search for Certificates:

response = api.certificates.search(query: 'dropbox.com')

Enumerate through search results:

response.each_page do |page|
  puts ">>> Page ##{page.metadata.page} / #{page.metadata.pages} ..."

  page.each do |result|
    puts result
  end
end

Generate aggregate reports:

response = api.websites.report(
  query: '80.http.get.headers.server: Apache',
  field: 'location.country_code',
  buckets: 100
)

response.each do |country,count|
  puts "#{country}: #{count}"
end

Requirements

Install

$ gem install censys

Copyright

Copyright (c) 2016 Hal Brodigan

See {file:LICENSE.txt} for details.

censys-ruby's People

Contributors

dguido avatar pdeardorff-r7 avatar postmodern avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.