Skip to content
README.rst 4.04 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.
You can now play with ``Burp-UI`` at `demo.ziirish.me <http://demo.ziirish.me>`_

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 *on-the-fly* restorations and to edit/manage
your burp-server's configuration files.
ziirish's avatar
ziirish committed

It is actually an improvement of the burp status monitor (``burp -c /etc/burp/burp-server.conf -a s``).

In order to work properly, you must be running ``Burp-UI`` on the same host that
runs your burp-server (because the burp status port only listen on *localhost*).
If you don't want to, I developed a ``bui-agent`` that allows you to *proxify*
ziirish's avatar
ziirish committed
external commands to your burp status port.


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
=====
Please 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.

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 fedbacks and bug reports that make the project moving
forward.

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