ip_contact_finder 1.0.0.rc1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7d213095deacf2473debd978f225f195ab175d3baaf77f41db1a80140c5b84a8
+  data.tar.gz: d57a5d01dbd1ffae179702dc4ae93f695bb4f840819650e67dfa735fefcba474
+SHA512:
+  metadata.gz: 78ca2c000c3bcda52f879453ef26d656cbe82f67c1bb04e4cdeae5b6f5519d14db7ccecc467b0f022863b346bd768136bbeda0ac5136b1001912e41cfa8f487d
+  data.tar.gz: 79899f7ed5c6b27987dec77a012fdbd91ae52bc5e58e5d74ed0a0193074f3f22175935e0beebeb2937d7a63572130f96a47c12f82a069e135e22ab8d87c873d1

data/lib/ip_contact_finder/entities.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'ip_contact_finder/entity'
+
+module IPContactFinder
+  class Entities < Array
+    def initialize(entities)
+      super(entities.map { |e| Entity.new(e) })
+    end
+
+    # Return all the email addresses for this group of entities
+    #
+    # @return [Array<String>]
+    def email_addresses
+      addresses = []
+      each do |entity|
+        addresses |= entity.email_addresses
+        addresses |= entity.entities.email_addresses
+      end
+      addresses.sort
+    end
+  end
+end

data/lib/ip_contact_finder/entity.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'ip_contact_finder/entities'
+
+module IPContactFinder
+  class Entity
+    def initialize(entity)
+      @entity = entity
+
+      lookup_vcard_from_rdap if @entity['vcardArray'].nil?
+    end
+
+    # Return all sub entities within this one
+    #
+    # @return [IPContactFinder::Entities]
+    def entities
+      return Entities.new([]) if @entity['entities'].nil?
+
+      @entities ||= Entities.new(@entity['entities'])
+    end
+
+    # Return all email addresses for this entity
+    #
+    # @return [Array<String>]
+    def email_addresses
+      vcard = @entity['vcardArray']
+      return [] if vcard.nil?
+      return [] unless vcard[0] == 'vcard'
+
+      components = vcard[1]
+      version = components.find { |c| c[0] == 'version' }
+      return [] unless version.last == '4.0'
+
+      addresses = components.select { |c| c[0] == 'email' && c.last && c.last.length.positive? }
+      addresses.map { |a| a.last.downcase }
+    end
+
+    private
+
+    def lookup_vcard_from_rdap
+      updated_entity = IPContactFinder.rdap.entity(@entity['handle'])
+      @entity['vcardArray'] = updated_entity['vcardArray']
+    end
+  end
+end

data/lib/ip_contact_finder/error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module IPContactFinder
+  class Error < StandardError
+  end
+
+  class TooManyRedirectsError < Error
+  end
+
+  class RateLimitedError < Error
+  end
+
+  class NotFoundError < Error
+  end
+
+  class RequestError < Error
+  end
+
+  class InvalidObjectError < Error
+  end
+end

data/lib/ip_contact_finder/rdap.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'json'
+require 'ip_contact_finder/error'
+
+module IPContactFinder
+  class RDAP
+    DEFAULT_SERVER = 'rdap.db.ripe.net'
+
+    attr_reader :server
+    attr_reader :logger
+
+    def initialize(server: DEFAULT_SERVER, logger: nil)
+      @server = server
+      @logger = logger
+    end
+
+    def lookup(type, object)
+      request(create_initial_url(type, object))
+    end
+
+    def ip(object)
+      lookup('ip', object)
+    end
+
+    def autnum(object)
+      lookup('autnum', object)
+    end
+
+    def entity(object)
+      lookup('entity', object)
+    end
+
+    private
+
+    def create_initial_url(type, object)
+      "https://#{@server}/#{type}/#{object}"
+    end
+
+    def request(uri, redirect_count: 0)
+      raise TooManyRedirectsError, 'Too many redirects' if redirect_count >= 5
+
+      uri = URI.parse(uri)
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.open_timeout = 10
+      http.read_timeout = 10
+
+      request = Net::HTTP::Get.new(uri.path)
+      request['User-Agent'] = "IP Contact Finder/#{IPContactFinder::VERSION}"
+
+      @logger&.info "Making request to #{uri}"
+
+      response = http.request(request)
+      @logger&.info "Got response #{response.code}"
+
+      case response
+      when Net::HTTPRedirection
+        new_location = response['Location']
+        request(new_location, redirect_count: redirect_count + 1)
+      when Net::HTTPOK
+        JSON.parse(response.body)
+      when Net::HTTPTooManyRequests
+        raise RateLimitedError
+      when Net::HTTPNotFound
+        raise NotFoundError
+      else
+        raise RequestError, "Got status #{response.code} (#{response.body})"
+      end
+    rescue SocketError, Errno::ECONNRESET, EOFError, Errno::EINVAL, Errno::ENETUNREACH, Errno::EHOSTUNREACH,
+           Errno::ECONNREFUSED, OpenSSL::SSL::SSLError, Timeout::Error => e
+      raise RequestError, "#{e.message} (#{e.class})"
+    end
+  end
+end

data/lib/ip_contact_finder/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module IPContactFinder
+  VERSION_FILE_ROOT = File.expand_path('../../VERSION', __dir__)
+  VERSION = if File.file?(VERSION_FILE_ROOT)
+              File.read(VERSION_FILE_ROOT).strip.sub(/\Av/, '')
+            else
+              '0.0.0.dev'
+            end
+end

data/lib/ip_contact_finder.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'ipaddr'
+require 'ip_contact_finder/rdap'
+require 'ip_contact_finder/entities'
+
+module IPContactFinder
+  class << self
+    IPV4_REGEXP = /\A[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+\z/.freeze
+    IPV6_REGEXP = /\A[a-f0-9]+:[a-f0-9:]+\z/i.freeze
+    AUTNUM_REGEXP = /\A[0-9]+\z/.freeze
+    ENTITY_REGEXP = /\A[a-z\-_0-9]+\z/i.freeze
+
+    def rdap
+      @rdap ||= RDAP.new
+    end
+
+    def lookup(object)
+      case object
+      when AUTNUM_REGEXP
+        autnum(object)
+      when IPV4_REGEXP, IPV6_REGEXP
+        ip(object)
+      else
+        entity(object)
+      end
+    end
+
+    def ip(ip)
+      raise InvalidObjectError, "IP address given doesn't look at a valid IP address" unless valid_ip?(ip)
+
+      result = rdap.ip(ip)
+      Entities.new(result['entities']).email_addresses
+    end
+
+    def autnum(autnum)
+      raise InvalidObjectError, "Autnum given doesn't look at a valid autnum" unless autnum.match?(AUTNUM_REGEXP)
+
+      result = rdap.autnum(autnum)
+      Entities.new(result['entities']).email_addresses
+    end
+
+    def entity(entity)
+      raise InvalidObjectError, "Entity given doesn't look at a valid entity" unless entity.match?(ENTITY_REGEXP)
+
+      result = rdap.entity(entity)
+      Entities.new([result]).email_addresses
+    end
+
+    private
+
+    def valid_ip?(ip)
+      return false unless ip.match?(IPV4_REGEXP) || ip.match?(IPV6_REGEXP)
+
+      IPAddr.new(ip)
+      true
+    rescue IPAddr::InvalidAddressError
+      false
+    end
+  end
+end

metadata

@@ -0,0 +1,205 @@
+--- !ruby/object:Gem::Specification
+name: ip_contact_finder
+version: !ruby/object:Gem::Version
+  version: 1.0.0.rc1
+platform: ruby
+authors:
+- Adam Cooke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-05-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-expectations
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.17.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.17.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: solargraph
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby library to resolve IP addresses and AS numbers to responsible
+  email addressses
+email:
+- adam@krystal.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ip_contact_finder.rb
+- lib/ip_contact_finder/entities.rb
+- lib/ip_contact_finder/entity.rb
+- lib/ip_contact_finder/error.rb
+- lib/ip_contact_finder/rdap.rb
+- lib/ip_contact_finder/version.rb
+homepage: https://github.com/krystal/ip_contact_finder
+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: 1.3.1
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: A Ruby library to resolve IP addresses and AS numbers to responsible email
+  addressses
+test_files: []