itdis 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '02957cae7870578bcf2c51b6e9df6dcd6c05b885ea02dbdcaaf74f82e3b8fce9'
+  data.tar.gz: 6225c2a3c3a98aac3200aec771742e2cdcc3c95363d53c403827f79a36b19a62
+SHA512:
+  metadata.gz: 68d48e54ca89e2a68e144d1f277b8dd939d0125e35d3c7744690b4283bf386e0446b1abafe989bca72c189adb319aa6b9a5006db1f4a99974923b661410229d0
+  data.tar.gz: b17505b1337ddebbcf83cbace09c7461acc7b6bfa6173e51d985ae2cd27a26bc5b7df54a7f350b7d1227243eb062f5d421276f74d5afae1fbdd01d8109a08946

data/.gitignore

@@ -0,0 +1,6 @@
+.yardoc
+*.gem
+/pkg
+/doc
+/vendor
+.bundle/

data/.gitlab-ci.yml

@@ -0,0 +1,51 @@
+# Official language image. Look for the different tagged releases at:
+# https://hub.docker.com/r/library/ruby/tags/
+
+# Caching: https://docs.gitlab.com/ee/ci/caching/#caching-ruby-dependencies
+cache:
+  key: ${CI_COMMIT_REF_SLUG}
+  paths:
+    - vendor/ruby # cache gems in between builds
+
+before_script:
+  - ruby -v # Print out ruby version for debugging
+  - gem install bundler --no-document # Bundler is not installed with the image
+  # install nproc (coreutils) for bundle -j
+  # install git for building the gemspec
+  # install make, gcc for building gem native extension (commonmarker)
+  # libc-dev for musl-dev dependency (stdlib.h) needed by gcc
+  - apk --no-cache add coreutils git make gcc libc-dev
+  - bundle install -j $(nproc) --path vendor # Install dependencies into ./vendor/ruby
+  #- bundle exec rake install # install the gem
+
+# Anchors: https://docs.gitlab.com/ee/ci/yaml/README.html#anchors
+.test_template: &job_definition
+  stage: test
+  script:
+  - bundle exec rubocop
+  #- bundle exec rake test
+
+#test:2.4:
+#  <<: *job_definition
+#  image: ruby:2.4-alpine
+
+#test:2.5:
+#  <<: *job_definition
+#  image: ruby:2.5-alpine
+
+test:2.6:
+  <<: *job_definition
+  image: ruby:2.6-alpine
+
+pages:
+  stage: deploy
+  image: ruby:2.6-alpine
+  script:
+    - bundle exec yard doc
+    - mkdir public
+    - mv doc/* public/
+  artifacts:
+    paths:
+      - public
+  only:
+    - master

data/.gitlab/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Issue
+
+See [bug](issue_templates/Bug.md) or [Feature proposal](issue_templates/Feature_proposal.md) issue templates.
+
+I borrow the [issue guidelines of the YARD project](https://github.com/lsegal/yard/blob/master/CONTRIBUTING.md).
+
+## Filing a Bug Report
+
+If you believe you have found a bug, please include a few things in your report:
+
+1. **A minimal reproduction of the issue.** Providing a huge blob of code is better than nothing, but providing the shortest possible set of instructions is even better. Take out any instructions or code that, when removed, have no effect on the problematic behavior. The easier your bug is to triage and diagnose, the higher up in the priority list it will go. We can do this stuff, but limited time means this may not happen immediately. Make your bug report extremely accessible and you will almost guarantee a quick fix.
+2. **Your environment and relevant versions.** Please include your Ruby, itdis, and system versions (including OS) when reporting a bug. This makes it easier to diagnose problems. If the issue or stack trace includes another library, consider also listing any dependencies that may be affecting the issue. This is where a minimal reproduction case helps a lot.
+3. **Your expected result.** Tell us what you think should happen. This helps us to understand the context of your problem. Many complex features can contain ambiguous usage, and your use case may differ from the intended one. If we know your expectations, we can more easily determine if the behavior is intentional or not.
+
+Finally, please **DO NOT** submit a report that states a feature simply "does not work" without any additional information in the report. Consider the issue from the maintainer's perspective: in order to fix your bug, we need to drill down to the broken line of code, and in order to do this, we must be able to reproduce the issue on our end to find that line of code. The easier we can do this, the quicker your bug gets fixed. Help us help you by providing as much information as you possibly can. We may not have the tools or environment to properly diagnose your issue, so your help may be required to debug the issue.
+
+Also **consider opening a merge request** to fix the issue yourself if you can. This will likely speed up the fix time significantly.
+
+## Asking a Question
+
+Question or discussion about an idea are accepted.
+
+## Asking for a Feature
+
+Feature proposal are accepted.
+
+Also **consider opening a merge request** to fix the issue yourself if you can. This will likely speed up the fix time significantly.
+
+# Merge Request
+
+See the [merge request](merge_request_templates/MR.md) template.
+
+I borrow the [merge request guidelines of the YARD project](https://github.com/lsegal/yard/blob/master/CONTRIBUTING.md).
+
+## Making a Change via Merge Request
+
+If you've been working on a patch or feature that you want in itdis, here are some tips to ensure the quickest turnaround time on getting it merged in:
+
+1. **Keep your changes small.** If your feature is large, consider splitting it up into smaller portions and submit pull requests for each component individually. Feel free to describe this in your first MR or on the mailing list, but note that it will be much easier to review changes if they affect smaller portions of code at a time.
+2. **Keep commits brief and clean**: itdis uses Git and tries to maintain a clean repository. Please ensure that you use commit conventions to make things nice and neat both in the description and commit history. Specifically, consider squashing commits if you have partial or complete reverts of code. Each commit should provide an atomic change that moves the project forwards, not back. Any changes that only fix other parts of your MR should be hidden from the commit history.
+3. **Follow our coding conventions.** itdis uses typical Ruby source formatting, though it occasionally has minor differences with other projects you may have seen. Please look through a few files (at least the file you are editing) to ensure that you are consistent in the formatting your MR is using.
+4. **Make sure you have tests.** Not all changes require tests, but if your changes involve code, you should consider adding at least one new test case for your change (and ideally a couple of tests). This will add confidence when reviewing and will make accepting the change much easier.
+5. **Make sure ALL the tests pass.** itdis has a fairly large suite of tests. Please make sure you can run all of the tests (bundle exec rake) prior to submitting your MR. Please also remember that itdis supports a number of environments, and a number of older Ruby versions, so if you can test under these environments, that helps (but is not required). At the very least, be aware of this fact when submitting code.
+
+If your change is large, consider opening an issue to ask a question or starting a discussion; we will be happy to have a conversation and let you know if the feature would be considered. They usually are, but it might be prudent to ask first!
+
+## Maintainers
+
+**Interested in helping to maintain itdis?** Offering to be a project maintainer is an important contribution to open source software, and your work will be highly valued in the community. If you have been a contributor, consider being a member of the core team to help handle day-to-day operations, such as releases, bug fixes, and triage. You can do some of this as a non-maintainer too, but if you like this project, we can always use more hands on deck!

data/.gitlab/issue_templates/Bug.md

@@ -0,0 +1,55 @@
+Provide a general summary of the issue in the Title above
+
+Please read this!
+
+Before opening a new issue, make sure to search for keywords in the issues
+filtered by the "regression" or "bug" label, and verify the issue you're about to submit isn't a duplicate.
+
+Please remove this notice if you're confident your issue isn't a duplicate.
+
+------
+
+### Summary
+
+(Summarize the bug encountered concisely)
+
+### Steps to reproduce
+
+(How one can reproduce the issue - this is very important)
+
+### What is the current *bug* behavior?
+
+(What actually happens)
+
+### What is the expected *correct* behavior?
+
+(What you should see instead)
+
+### Relevant logs and/or screenshots
+
+(Paste any relevant logs - please use code blocks (```) to format console output,
+logs, and code as it's very hard to read otherwise.)
+
+### Possible fixes
+
+(If you can, link to the line of code that might be responsible for the problem,
+suggest a fix/reason for the bug, or ideas how to implement the addition
+or change )
+
+## Context
+
+(How has this issue affected you? What are you trying to accomplish?)
+(Providing context helps us come up with a solution that is most useful in the real world)
+
+## Your Environment
+
+(Include as many relevant details about the environment you experienced the bug in)
+* Version used:
+  + Version (stable release) `gem query itdis`
+  + Commit ID (development release) `git --no-pager log -1`
+* Ruby version: `ruby -v`
+* Operating System and version:
+* Relevant software dependency/versions:
+  * Any 3rd party libs required to reproduce, omit if none
+
+/label ~bug

data/.gitlab/issue_templates/Feature_proposal.md

@@ -0,0 +1,9 @@
+### Description
+
+(Include problem, use cases, benefits, and/or goals)
+
+### Proposal
+
+### Links / references
+
+/label ~"feature proposal"

data/.gitlab/merge_request_templates/MR.md

@@ -0,0 +1,33 @@
+### What does this MR do?
+
+### Are there points in the code the reviewer needs to double check?
+
+### Why was this MR needed?
+
+### Screenshots (if relevant)
+
+## Types of changes
+
+What types of changes does your code introduce? Put an `x` in all the boxes that apply:
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+
+### Does this MR meet the acceptance criteria?
+
+(Go over all the following points, and put an `x` in all the boxes that apply.)
+(If you're unsure about any of these, don't hesitate to ask. We're here to help!)
+
+* [ ]  I have read the [**CONTRIBUTING**](../CONTRIBUTING.md) document.
+* [ ]  Changelog entry added, if necessary
+* [ ]  Documentation created/updated
+* [ ]  Tests added for this feature/bug
+* [ ]  All new and existing tests passed
+* [ ]  Conform by the style guides (0 issue with rubocop / codacy)
+* [ ]  [Squashed related commits together](https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History#_squashing)
+
+### Related issues
+
+(This project only accepts pull requests related to open issues)
+(If suggesting a new feature or change, please discuss it in an issue first)
+(If fixing a bug, there should be an issue describing it with steps to reproduce)

data/.rubocop.yml

@@ -0,0 +1,49 @@
+AllCops:
+  TargetRubyVersion: 2.6
+
+Layout/AlignHash:
+  EnforcedHashRocketStyle: table
+
+# Rubocop is too stupid too see that the variable is used
+Lint/UselessAssignment:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Max: 50
+
+Metrics/BlockNesting:
+  Max: 4
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+
+Metrics/LineLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 100
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Naming/VariableName:
+  EnforcedStyle: snake_case
+
+Security/JSONLoad:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  EnforcedStyle: never
+
+Style/PerlBackrefs:
+  AutoCorrect: false
+
+# Allow explicit return
+Style/RedundantReturn:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.6.0

data/.yardopts

@@ -0,0 +1,10 @@
+--protected
+--private
+--output-dir doc/
+-
+--main README.md
+LICENSE.txt
+pages/INSTALL.md
+pages/EXAMPLES.md
+pages/CHANGELOG.md
+.gitlab/CONTRIBUTING.md

data/EXAMPLES.md

@@ -0,0 +1,4 @@
+```
+itdis -s 205.251.242.103 -D /tmp/domains.txt
+itdis -S /tmp/scope.txt -D /tmp/domains.txt
+```

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in .gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,60 @@
+PATH
+  remote: .
+  specs:
+    itdis (0.0.1)
+      docopt (~> 0.6)
+      paint (~> 2.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.0)
+    commonmarker (0.18.2)
+      ruby-enum (~> 0.5)
+    concurrent-ruby (1.1.4)
+    docopt (0.6.1)
+    github-markup (3.0.3)
+    i18n (1.5.3)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.2)
+    minitest (5.11.3)
+    paint (2.1.0)
+    parallel (1.14.0)
+    parser (2.6.0.0)
+      ast (~> 2.4.0)
+    powerpack (0.1.2)
+    psych (3.1.0)
+    rainbow (3.0.0)
+    rake (12.3.2)
+    redcarpet (3.4.0)
+    rubocop (0.65.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      psych (>= 3.1.0)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.4.0)
+    ruby-enum (0.7.2)
+      i18n
+    ruby-progressbar (1.10.0)
+    unicode-display_width (1.4.1)
+    yard (0.9.18)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  commonmarker (~> 0.18)
+  github-markup (~> 3.0)
+  itdis!
+  minitest (~> 5.11)
+  rake (~> 12.3)
+  redcarpet (~> 3.4)
+  rubocop (~> 0.65)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.0.1

data/LICENSE.txt

@@ -0,0 +1,7 @@
+Copyright 2019 Alexandre ZANNI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+[![pipeline status](https://gitlab.com/noraj/itdis/badges/master/pipeline.svg)](https://gitlab.com/noraj/itdis/commits/master)
+
+[![Gem version](https://img.shields.io/gem/v/itdis.svg)][rubygems]
+[![Gem stable](https://img.shields.io/gem/dv/itdis/stable.svg)][rubygems]
+[![Gem latest](https://img.shields.io/gem/dtv/itdis.svg)][rubygems]
+[![Gem total download](https://img.shields.io/gem/dt/itdis.svg)][rubygems]
+
+# ITDIS (Is This Domain In Scope)
+
+Is a small tool that allows you to check if a list of domains you have been provided is in the scope of your pentest or not.
+
+Name            | Link
+---             | ---
+Website         | [link](https://noraj.gitlab.io/itdis/)
+Documentation   | [link](https://noraj.gitlab.io/itdis/)
+Gem             | [link](https://rubygems.org/gems/itdis)
+Git repository  | [link](https://gitlab.com/noraj/itdis)
+Merge Requests  | [link](https://gitlab.com/noraj/itdis/merge_requests)
+Issues          | [link](https://gitlab.com/noraj/itdis/issues)
+
+## Quick help
+
+```
+$ itdis -h
+ITDIS (Is This Domain In Scope)
+
+Usage:
+  itdis [options] (-s <IPs> | -S <file>) (-d <domains> | -D <file>)
+  itdis -h | --help
+  itdis --version
+
+Options:
+  -s <IPs>, --scope <IPs>             Specify the scope: one or multiple IP addresses separated by a comma (,)
+  -S <file>, --scope-file <file>      Specify the scope: a file path, the file must contain one IP address per line
+  -d <domains>, --domains <domains>   Specify domains to check: one or multiple domains separated by a comma (,)
+  -D <file>, --domains-file <file>    Specify domains to check: a file path, the file must contain one domain per line
+  --no-color                          Disable colorized output
+  --short                             Display in a short format: display only domains in scope
+  --debug                             Display arguments
+  -h --help                           Show this screen.
+  --version                           Show version.
+
+Examples:
+  itdis -s 1.1.1.1 -D /tmp/domains.txt
+  itdis -s 205.251.242.103,176.32.98.166 -d amazon.com
+  itdis -S /tmp/scope.txt -D /tmp/domains.txt --no-color
+```
+
+For more help see the documentation.

data/bin/itdis

@@ -0,0 +1,100 @@
+#!/usr/bin/env ruby
+
+require 'itdis'
+require 'docopt'
+require 'paint'
+
+doc = <<~DOCOPT
+  ITDIS (Is This Domain In Scope)
+
+  Usage:
+    itdis [options] (-s <IPs> | -S <file>) (-d <domains> | -D <file>)
+    itdis -h | --help
+    itdis --version
+
+  Options:
+    -s <IPs>, --scope <IPs>             Specify the scope: one or multiple IP addresses separated by a comma (,)
+    -S <file>, --scope-file <file>      Specify the scope: a file path, the file must contain one IP address per line
+    -d <domains>, --domains <domains>   Specify domains to check: one or multiple domains separated by a comma (,)
+    -D <file>, --domains-file <file>    Specify domains to check: a file path, the file must contain one domain per line
+    --no-color                          Disable colorized output
+    --short                             Display in a short format: display only domains in scope
+    --debug                             Display arguments
+    -h --help                           Show this screen.
+    --version                           Show version.
+
+  Examples:
+    itdis -s 1.1.1.1 -D /tmp/domains.txt
+    itdis -s 205.251.242.103,176.32.98.166 -d amazon.com
+    itdis -S /tmp/scope.txt -D /tmp/domains.txt --no-color
+DOCOPT
+
+def clean_array(arr)
+  arr.map!(&:chomp) # remove end of line
+  arr.reject!(&:empty?) # remove empty values
+  arr
+end
+
+def file_to_array(file)
+  data = File.readlines(file)
+  scope = clean_array(data)
+end
+
+def colorize_hash(hash)
+  colorized_output = []
+  hash.each do |key, val|
+    color = nil
+    if val == true
+      color = :green
+    elsif val == false
+      color = :red
+    end
+    colorized_output.push(Paint[key, color])
+  end
+  colorized_output
+end
+
+begin
+  args = Docopt.docopt(doc, version: Itdis::VERSION)
+  # use case 1, using the tool
+  # don't need more checks for mutual exclusion, etc. because docopt does it
+  if args['--scope'] || args['--scope-file']
+    scope = domains = []
+    if args['--scope']
+      scope = args['--scope'].split(',')
+    elsif args['--scope-file']
+      scope = file_to_array(args['--scope-file'])
+    end
+    if args['--domains']
+      domains = args['--domains'].split(',')
+    elsif args['--domains-file']
+      domains = file_to_array(args['--domains-file'])
+    end
+    res = Itdis.new(scope, domains).check
+    require 'pp'
+    pp args if args['--debug']
+    # print result
+    res.each do |host, ips|
+      if args['--no-color']
+        if args['--short']
+          # pass the else
+        else
+          in_scope = ips.select { |_k, v| v == true }
+          in_scope = in_scope.keys.join(', ')
+          out_of_scope = ips.select { |_k, v| v == false }
+          out_of_scope = out_of_scope.keys.join(', ')
+          puts "#{host}:\n  In scope: [#{in_scope}]\n  Out of scope: [#{out_of_scope}]"
+        end
+      elsif args['--short']
+        # pass the else
+      else
+        puts "#{host}: [#{colorize_hash(ips).join(', ')}]"
+      end
+      puts host if args['--short'] && ips.value?(true)
+    end
+  end
+  # use case 2, help: already handled by docopt
+  # use case 3, version: already handled by docopt
+rescue Docopt::Exit => e
+  puts e.message
+end

data/itdis.gemspec

@@ -0,0 +1,44 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'itdis/version'
+
+Gem::Specification.new do |s|
+  s.name          = 'itdis'
+  s.version       = ItdisVersion::VERSION
+  s.platform      = Gem::Platform::RUBY
+  s.date          = '2019-02-27'
+  s.summary       = 'Is This Domain In Scope'
+  s.description   = 'Is a small tool that allows you to check if a list of domains you have been provided is in the scope of your pentest or not.'
+  s.authors       = ['Alexandre ZANNI']
+  s.email         = 'alexandre.zanni@europe.com'
+  s.homepage      = 'https://noraj.gitlab.io/itdis/'
+  s.license       = 'MIT'
+
+  s.files         = `git ls-files`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  # s.test_files    = s.files.grep(%r{^(test)/})
+  s.require_paths = ['lib']
+
+  s.metadata = {
+    'yard.run'          => 'yard',
+    'bug_tracker_uri'   => 'https://gitlab.com/noraj/itdis/issues',
+    'changelog_uri'     => 'https://noraj.gitlab.io/itdis/file.CHANGELOG.html',
+    'documentation_uri' => 'https://noraj.gitlab.io/itdis/',
+    'homepage_uri'      => 'https://noraj.gitlab.io/itdis/',
+    'source_code_uri'   => 'https://gitlab.com/noraj/itdis/tree/master'
+  }
+
+  s.required_ruby_version = '~> 2.6'
+
+  s.add_runtime_dependency('docopt', '~> 0.6') # for argument parsing
+  s.add_runtime_dependency('paint', '~> 2.1') # for colorized ouput
+
+  s.add_development_dependency('bundler', '~> 2.0')
+  s.add_development_dependency('commonmarker', '~> 0.18') # for GMF support in YARD
+  s.add_development_dependency('github-markup', '~> 3.0') # for GMF support in YARD
+  s.add_development_dependency('minitest', '~> 5.11')
+  s.add_development_dependency('rake', '~> 12.3')
+  s.add_development_dependency('redcarpet', '~> 3.4') # for GMF support in YARD
+  s.add_development_dependency('rubocop', '~> 0.65')
+  s.add_development_dependency('yard', '~> 0.9')
+end

data/lib/itdis.rb

@@ -0,0 +1,78 @@
+# @author Alexandre ZANNI <alexandre.zanni@engineer.com>
+
+# Ruby internal (stdlib)
+require 'resolv'
+# Project internal
+require 'itdis/version'
+
+# The class used for resolving domains
+class Itdis
+  # Load constants
+  include ItdisVersion
+
+  # @overload scope
+  #   Get the scope
+  #   @!macro return_scope
+  #     @return [Array<String>] Array of IP addresses that are in the scope
+  #   @!macro return_scope
+  #   @example
+  #     ['192.168.0.42']
+  # @overload scope(=scope)
+  #   Set the scope
+  #   @param scope [Array<String>] Array of IP addresses that are in the scope
+  #   @!macro return_scope
+  attr_reader :scope
+
+  # @overload domains
+  #   Get domains
+  #   @!macro return_domains
+  #     @return [Array<String>] Array of domains that must be checked
+  #   @!macro return_domains
+  #   @example
+  #     ['example.org', 'example.com']
+  # @overload domains=(domains)
+  #   Set domains
+  #   @param domains [Array<String>] Array of domains that must be checked
+  #   @!macro return_domains
+  attr_reader :domains
+
+  def scope=(scope)
+    raise TypeError, 'scope must be an array' unless scope.is_a?(Array)
+
+    @scope = scope
+  end
+
+  def domains=(domains)
+    raise TypeError, 'domains must be an array' unless domains.is_a?(Array)
+
+    @domains = domains
+  end
+
+  # A new instance of resolver
+  # @param scope [Array<String>] see {#scope}
+  # @param domains [Array<String>] see {#domains}
+  def initialize(scope, domains)
+    self.scope = scope
+    self.domains = domains
+  end
+
+  # Check if the domains of the instance are in the scope
+  # @return [Hash] the domain and associated IPs checked.
+  #   true if in scope false else.
+  # @example
+  #   irb(main):001:0> Itdis.new(['127.0.0.1', '205.251.242.103'],['amazon.com']).check
+  #   => {"amazon.com"=>{"205.251.242.103"=>true, "176.32.103.205"=>false, "176.32.98.166"=>false}}
+  def check
+    checked = {}
+    @domains.each do |domain|
+      ips = {}
+      Resolv.each_address(domain.chomp) do |ip|
+        is_in_scope = false
+        is_in_scope = true if @scope.include?(ip)
+        ips.store(ip, is_in_scope)
+      end
+      checked.store(domain, ips)
+    end
+    return checked
+  end
+end

data/lib/itdis/version.rb

@@ -0,0 +1,3 @@
+module ItdisVersion
+  VERSION = '0.0.1'.freeze
+end

data/pages/CHANGELOG.md

@@ -0,0 +1,5 @@
+# [0.0.1] - 1 March 2019
+
+[0.0.1]: https://gitlab.com/noraj/itdis/tags/v0.0.1
+
+- First release.

data/pages/EXAMPLES.md

@@ -0,0 +1,84 @@
+# Examples
+
+For all examples don't forget to add `require 'itdis'`.
+
+## Help
+
+```
+$ itdis -h
+ITDIS (Is This Domain In Scope)
+
+Usage:
+  itdis [options] (-s <IPs> | -S <file>) (-d <domains> | -D <file>)
+  itdis -h | --help
+  itdis --version
+
+Options:
+  -s <IPs>, --scope <IPs>             Specify the scope: one or multiple IP addresses separated by a comma (,)
+  -S <file>, --scope-file <file>      Specify the scope: a file path, the file must contain one IP address per line
+  -d <domains>, --domains <domains>   Specify domains to check: one or multiple domains separated by a comma (,)
+  -D <file>, --domains-file <file>    Specify domains to check: a file path, the file must contain one domain per line
+  --no-color                          Disable colorized output
+  --short                             Display in a short format: display only domains in scope
+  --debug                             Display arguments
+  -h --help                           Show this screen.
+  --version                           Show version.
+
+Examples:
+  itdis -s 1.1.1.1 -D /tmp/domains.txt
+  itdis -s 205.251.242.103,176.32.98.166 -d amazon.com
+  itdis -S /tmp/scope.txt -D /tmp/domains.txt --no-color
+```
+
+## Quick use
+
+```
+$ itdis -s 205.251.242.103,176.32.98.166 -d amazon.com,google.com
+amazon.com: [176.32.103.205, 205.251.242.103, 176.32.98.166]
+google.com: [216.58.209.238]
+```
+
+You can't see here, but in scope domains are in green and out of scope ones are in red.
+
+## Load from file
+
+```
+$ itdis -S /tmp/scope.txt -D /tmp/domains.txt
+amazon.com: [176.32.103.205, 205.251.242.103, 176.32.98.166]
+google.com: [216.58.209.238]
+```
+
+With `/tmp/scope.txt`:
+
+```
+205.251.242.103
+176.32.98.166
+```
+
+And `/tmp/domains.txt`:
+
+```
+amazon.com
+google.com
+```
+
+## Short output
+
+Only in scope domains are displayed:
+
+```
+$ itdis -s 205.251.242.103,176.32.98.166 -d amazon.com,google.com --short
+amazon.com
+```
+
+## No color
+
+```
+$ itdis -s 205.251.242.103,176.32.98.166 -d amazon.com,google.com --no-color
+amazon.com:
+  In scope: [176.32.98.166, 205.251.242.103]
+  Out of scope: [176.32.103.205]
+google.com:
+  In scope: []
+  Out of scope: [216.58.209.238]
+```

data/pages/INSTALL.md

@@ -0,0 +1,59 @@
+# Installation
+
+## Production
+
+### Install from rubygems.org
+
+```
+$ gem install itdis
+```
+
+## Development
+
+It's better to use [rbenv](https://github.com/rbenv/rbenv) to have latests version of ruby and to avoid trashing your system ruby.
+
+### Install from rubygems.org
+
+```
+$ gem install --development itdis
+```
+
+### Build from git
+
+Just replace `x.x.x` with the gem version you see after `gem build`.
+
+```
+$ git clone https://gitlab.com/noraj/itdis.git itdis
+$ cd itdis
+$ gem install bundler
+$ bundler install
+$ gem build itdis.gemspec
+$ gem install itdis-x.x.x.gem
+```
+
+Note: if an automatic install is needed you can get the version with `$ gem build itdis.gemspec | grep Version | cut -d' ' -f4`.
+
+### Run the API in irb without installing the gem
+
+Useful when you want to try your changes without building the gem and re-installing it each time.
+
+```
+$ git clone https://gitlab.com/noraj/itdis.git itdis
+$ cd itdis
+$ irb -Ilib -ritdis
+```
+
+Same for the CLI tool:
+
+```
+$ ruby -Ilib -ritdis bin/itdis
+```
+
+# Publishing
+
+```
+$ git tag vx.x.x
+$ gem push itdis-x.x.x.gem
+```
+
+https://guides.rubygems.org/publishing/

metadata

@@ -0,0 +1,211 @@
+--- !ruby/object:Gem::Specification
+name: itdis
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Alexandre ZANNI
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-02-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: docopt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: commonmarker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: github-markup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+- !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: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.65'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.65'
+- !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: Is a small tool that allows you to check if a list of domains you have
+  been provided is in the scope of your pentest or not.
+email: alexandre.zanni@europe.com
+executables:
+- itdis
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".gitlab-ci.yml"
+- ".gitlab/CONTRIBUTING.md"
+- ".gitlab/issue_templates/Bug.md"
+- ".gitlab/issue_templates/Feature_proposal.md"
+- ".gitlab/merge_request_templates/MR.md"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".yardopts"
+- EXAMPLES.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- bin/itdis
+- itdis.gemspec
+- lib/itdis.rb
+- lib/itdis/version.rb
+- pages/CHANGELOG.md
+- pages/EXAMPLES.md
+- pages/INSTALL.md
+homepage: https://noraj.gitlab.io/itdis/
+licenses:
+- MIT
+metadata:
+  yard.run: yard
+  bug_tracker_uri: https://gitlab.com/noraj/itdis/issues
+  changelog_uri: https://noraj.gitlab.io/itdis/file.CHANGELOG.html
+  documentation_uri: https://noraj.gitlab.io/itdis/
+  homepage_uri: https://noraj.gitlab.io/itdis/
+  source_code_uri: https://gitlab.com/noraj/itdis/tree/master
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Is This Domain In Scope
+test_files: []