Metadata-Version: 2.2
Name: discosub
Version: 0.3.0
Summary: Simple, Faster, & Efficient, Subdomain Discovery Scanner
Home-page: https://4383.github.io/discosub/
Author: Hervé Beraud
Author-email: herveberaud.pro@gmail.com
License: GNU General Public License v3
Keywords: discosub
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Environment :: Console
Classifier: Topic :: Security
Classifier: Topic :: Utilities
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: click
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: summary

==============
discosub 0.3.0
==============

Free and opensource subdomain scanner. Discosub is simple and faster
subdomain discover.

Discosub test if a list of subdomains exist via fuzzing on root domain.

Discosub use dictionaries for perform an analyze (BruteForce).

You can use discosub directly from a python interpreter, or use it
inside docker container.

You can perform an anonymous scanning directly by using a specific
`docker version <https://hub.docker.com/r/4383/discosub/tags/>`__ (alias
tor).

Different type of docker container are available: \* simple docker
container with discosub installed on \* `torified
(tor) <https://www.torproject.org/>`__ docker container with discosub
installed on (all discosub scanning connections use tor network)

For more details visit the `official webpage
project <https://4383.github.io/discosub/>`__.

Install from pypi
-----------------

.. code:: shell

    pip install -U discosub

Install as a docker container
-----------------------------

.. code:: shell

    docker pull 4383/discosub:latest

Install as an anonymous scanner (tor + docker)
----------------------------------------------

.. code:: shell

    docker pull 4383/discosub:tor

Install from sources
--------------------

.. code:: shell

    $ git clone https://github.com/4383/discosub
    $ cd discosub
    $ python setup.py install

Usages from a local installation (from pypi or from sources)
------------------------------------------------------------

.. code:: shell

    discosub run google.com

Usages inside a docker container
--------------------------------

.. code:: shell

    docker run -e "TARGET=google.com" 4383/discosub:latest

Usages as an anonymous scanner from docker container (using tor inside docker)
------------------------------------------------------------------------------

.. code:: shell

    docker run -e "TARGET=google.com" 4383/discosub:tor

Usages for an agressive scanning mode
-------------------------------------

.. code:: shell

    discosub run google.com -a

Prerequistes
------------

-  python >= 2.6 (but prefer python3.x)

Features
--------

-  Analyze a root domain and discover its subdomains
-  Analyze domain over tor via specific docker container (anonymous
   scanning)

Advertissments
--------------

-  scan over docker container are more slowly than direct usage from
   python interpreter
-  scan over torified docker container are more slowly than direct usage
   from python interpreter and classical discosub docker container
-  scan over torified docker container are more verbose than an
   classical scanning (identifiable IP)

Upcoming features
-----------------

- Perform whois request on discovered subdomains
- Pass discosub options to docker container on run
- Perform scanning from user keywords file
- Save output into a file

License
-------

-  Free software: GNU General Public License v3

Credits
-------

Author: 4383 (Hervé Beraud)

This package was created with
`Cookiecutter <https://github.com/audreyr/cookiecutter>`__ and the
`audreyr/cookiecutter-pypackage <https://github.com/audreyr/cookiecutter-pypackage>`__
project template.


=======
History
=======

0.3.0 (2016-09-03)
-------------------

* Optimize scanning by using a new tiny list of frequently used subdomains
* Introduce more efficient and faster default scanning mode, agressive scanning mode, and user keywords list based on scanning mode

0.2.0 (2016-09-03)
-------------------

* New docker tag for allow anonymous scanning. Integrate a second dockerfile for build a container where network connections are relayed per a tor client embdded inside this container.

0.1.16 (2016-09-02)
-------------------

* Apply Alpha development status for pypi classifiers
* Adding badges on README

0.1.15 (2016-09-01)
-------------------

* Fixing mistake on Dockerfile (docker run command)

0.1.14 (2016-09-01)
-------------------

* Fixing bad packaging. Error when loading dictionaries files.

0.1.13 (2016-09-01)
-------------------

* Link official webpage with repo (pypi, github, docker)

0.1.12 (2016-08-31)
-------------------

* Fix somes documentation mistakes and syntax error
* Update pypi project classifiers

0.1.11 (2016-08-31)
-------------------

* Fix somes documentation mistakes and syntax error

0.1.10 (2016-08-31)
-------------------

* Dockerize app
* Stable pypi deployment via travis-ci

0.1.6 (2016-08-31)
------------------

* First release on Pypi.
* Using click instead of argparse

0.1.0 (2016-08-29)
------------------

* First release on Github.
