nmap-webgui's Introduction

nmap-webgui

Code status

This webapp is being developped. Basic structure is here, you can launch scan and have nmap scan reports automatically stored but no more so far :p

Use cases

nmap-webgui is a multi-user small web application based on flask to enable the user to:

launch nmap scans (DONE)
schedule periodic scans
review scan reports
diff and compare scan reports
display stats of scan reports

nmap-webgui is relying on the following technologies:

flask
celery
rabbitmq
mongodb
python-libnmap

Dependencies

Following packages need to be installed:

flask via pip
flask-login via pip
flask-pymongo via pip
flask-scripts via pip (optional)
rabbitmq server (no specific config needed)
mongodb daemon (to store users data and celery tasks)

##Quick install

This is a draft on how to install and run nmap-webgui:

    # install packages in a virtualenv or whatever
    $ pip install Flask
    $ pip install Flask-Login
    $ pip install Flask-PyMongo
    $ pip install Flask-Script
    # for celery, ensure you are running chiastic slide (version > 3)
    $ pip install celery

    # install mongodb and rabbitmq (the way you want it)
    $ yum install mongod
    $ yum install mongod-server
    $ yum install rabbitmq-server

    # start rabbitmq and mongodb
    $ service mongod start
    $ service rabbitmq-server start

    # install nmap
    $ yum install nmap

    # install python-libnmap
    $ git clone https://github.com/savon-noir/python-libnmap.git
    $ cd python-libnmap
    $ python setup.py install

    # install the webgui
    $ git clone https://[email protected]/savon_noir/nmap-webgui.git
    $ cd nmap-webgui
    $ python setup.py install

    # run celery
    $ celery -A nmapui.tasks worker --loglevel=debug

    # add a user, start the web app in debug and login
    $ python manage.py adduser <username> <email>
    $ python manage.py runserver

nmap-webgui's People

Contributors

Stargazers

Watchers

nmap-webgui's Issues

call libnmap NmapProcess error

i deploy this project .
i found this problem in master latest code .
i used python-libnmap is lastest too.

[2017-03-14 22:38:14,432: DEBUG/MainProcess] Task accepted: tasks.nmap_scan[b8a38b55-2fe7-441b-afc7-a440b94276ff] pid:8427
[2017-03-14 22:38:14,444: ERROR/PoolWorker-1] Task tasks.nmap_scan[b8a38b55-2fe7-441b-afc7-a440b94276ff] raised unexpected: Exception('Supplied target list should be either a string or a list',)
Traceback (most recent call last):
  File "/home/xxx/github/nmap-webgui/test/local/lib/python2.7/site-packages/celery/app/trace.py", line 367, in trace_task
    R = retval = fun(*args, **kwargs)
  File "/home/xxx/github/nmap-webgui/test/local/lib/python2.7/site-packages/celery/app/trace.py", line 622, in __protected_call__
    return self.run(*args, **kwargs)
  File "/home/xxx/github/nmap-webgui/nmapui/tasks.py", line 13, in celery_nmap_scan
    nm = NmapProcess(targets, options, event_callback=status_callback)
  File "/home/xxx/github/nmap-webgui/test/local/lib/python2.7/site-packages/libnmap/process.py", line 112, in __init__
    raise Exception("Supplied target list should be either a "
Exception: Supplied target list should be either a string or a list

Recommend Projects