Skip to content
README.rst 3.84 KiB
Newer Older
ziirish's avatar
ziirish committed
Badges
======
ziirish's avatar
ziirish committed
.. image:: https://ci.ziirish.me/projects/1/status.png?ref=master
    :target: https://ci.ziirish.me/projects/1?ref=master
ziirish's avatar
ziirish committed
    :alt: Build Status

ziirish's avatar
ziirish committed
.. image:: https://readthedocs.org/projects/burp-ui/badge/?version=latest
    :target: https://readthedocs.org/projects/burp-ui/?badge=latest
ziirish's avatar
ziirish committed
    :alt: Documentation Status
ziirish's avatar
ziirish committed
Introduction
============

ziirish's avatar
ziirish committed
Screenshots
-----------

ziirish's avatar
ziirish committed
.. image:: https://git.ziirish.me/ziirish/burp-ui/raw/master/docs/_static/burp-ui.gif
    :target: https://git.ziirish.me/ziirish/burp-ui/blob/master/docs/_static/burp-ui.gif
ziirish's avatar
ziirish committed


ziirish's avatar
ziirish committed
Demo
----

A screenshot is worth a thousand words, but a Demo is worth a thousand
screenshots.
ziirish's avatar
ziirish committed
You can now play with ``Burp-UI`` at `demo.ziirish.me <https://demo.ziirish.me>`_
ziirish's avatar
ziirish committed

Credentials:

ziirish's avatar
ziirish committed
- *admin / admin* to play with ``Burp-UI`` as an administrator
- *demo / demo* to play with ``Burp-UI`` as a regular user
ziirish's avatar
ziirish committed


ziirish's avatar
ziirish committed
What's that?
------------

Let me introduce you ``Burp-UI``. It is a web-based UI to manage your
burp-servers.
You can view different reports about burp-servers, burp-clients, backups, etc.
ziirish's avatar
ziirish committed
``Burp-UI`` allows you to perform *online* restorations and to edit/manage
ziirish's avatar
ziirish committed
your burp-server's configuration files.
ziirish's avatar
ziirish committed


Who are you?
------------

ziirish's avatar
ziirish committed
I'm `Ziirish <http://ziirish.info>`__, a French sysadmin who loves `Burp`_ and
who'd like to help its adoption by providing it a nice and powerful interface.
ziirish's avatar
ziirish committed
If you like my work, you can:

ziirish's avatar
ziirish committed
* Thank me by sending me an email or writing nice comments
* Buy me a beer or some fries (or both!)
* Make a donation on my `Paypal <http://ziirish.info>`__
ziirish's avatar
ziirish committed

ziirish's avatar
ziirish committed

ziirish's avatar
ziirish committed
Documentation
=============
ziirish's avatar
ziirish committed
The documentation is hosted on `readthedocs <https://readthedocs.org>`_ at the
ziirish's avatar
ziirish committed
following address: `burp-ui.readthedocs.org
<https://burp-ui.readthedocs.org/en/latest/>`_
ziirish's avatar
ziirish committed

ziirish's avatar
ziirish committed
FAQ
===

A `FAQ <https://burp-ui.readthedocs.org/en/latest/faq.html>`_ is available with
the documentation.


ziirish's avatar
ziirish committed
Community
=========

ziirish's avatar
ziirish committed
Please refer to the `Contributing
<https://burp-ui.readthedocs.org/en/latest/contributing.html>`_ page.
Notes
ziirish's avatar
ziirish committed
=====
ziirish's avatar
ziirish committed
Feel free to report any issues on my `gitlab
<https://git.ziirish.me/ziirish/burp-ui/issues>`_.
I have closed the *github tracker* to have a unique tracker system.
ziirish's avatar
ziirish committed
Also please, read the `Contributing
<https://burp-ui.readthedocs.org/en/latest/contributing.html>`_
page before reporting any issue to make sure we have all the informations to
help you.
Licenses
ziirish's avatar
ziirish committed
========
ziirish's avatar
ziirish committed
``Burp-UI`` is released under the BSD 3-clause `License`_.

But this project is built on top of other tools listed here:

- `d3.js <http://d3js.org/>`_
- `nvd3.js <http://nvd3.org/>`_
- `jQuery <http://jquery.com/>`_
- `jQuery-UI <http://jqueryui.com/>`_
- `fancytree <https://github.com/mar10/fancytree>`_
- `bootstrap <http://getbootstrap.com/>`_
- `typeahead <http://twitter.github.io/typeahead.js/>`_
- `bootswatch <http://bootswatch.com/>`_ theme ``Slate``
- `angular-bootstrap-switch <https://github.com/frapontillo/angular-bootstrap-switch>`_
- `angular.js <https://angularjs.org/>`_
- `angular-ui-select <https://github.com/angular-ui/ui-select>`_
- `AngularStrap <http://mgcrea.github.io/angular-strap/>`_
- `lodash <https://github.com/lodash/lodash>`_
- `DataTables <http://datatables.net/>`_
ziirish's avatar
ziirish committed
- Home-made `favicon <https://git.ziirish.me/ziirish/burp-ui/blob/master/burpui/static/images/favicon.ico>`_ based on pictures from `simpsoncrazy <http://www.simpsoncrazy.com/pictures/homer>`_
ziirish's avatar
ziirish committed
Also note that this project is made with the Awesome `Flask`_ micro-framework.
ziirish's avatar
ziirish committed

ziirish's avatar
ziirish committed
Thanks
ziirish's avatar
ziirish committed
======
ziirish's avatar
ziirish committed
Thank you all for your feedbacks and bug reports those are making the project
moving forward.
ziirish's avatar
ziirish committed

Special Thanks to Graham Keeling for its great piece of software! This project
would not exist without `Burp`_.
ziirish's avatar
ziirish committed

.. _Flask: http://flask.pocoo.org/
.. _License: https://git.ziirish.me/ziirish/burp-ui/blob/master/LICENSE
.. _Burp: http://burp.grke.org/
ziirish's avatar
ziirish committed
.. _burpui.cfg: https://git.ziirish.me/ziirish/burp-ui/blob/master/share/burpui/etc/burpui.sample.cfg