This project, introduced by OVH, aims to help ISP managing abuses on their network by providing a complete toolsuite such as an email parser, an email topic detection system, a ticketing system, an API and an UX.
This project comes in addition of cerberus-core which provides the backend API.
You're in a hurry and you only want to give the application a whirl? Why not running the provided docker image?
- Checkout the code and download the zipfile.
- If not already done, install docker by following this nice guide
- Build the image by running
docker build -t cerberus <dockerfile-path> - Install an email server (postfix, or whatever). If you don't, you also can use an already running MX such your personnal MX.
- Run the image providing your MX information so the app can poll the mails
docker run -e EMAIL_HOST=mx.domain.com -e EMAIL_PORT=993 -e [email protected] -e EMAIL_PASS=pass -p 6060:6060 -t cerberus
If you followed all these steps, congratulations ! You can now browse the app
by entering URI http://127.0.0.1:6060 and login using default login
admin:admin.
If you want to know how it does work, read the next sections.
Important note: no data persistence provided since it remains a docker.
- Git
- Node.js and npm Node ^4.2.4, npm ^2.14.7
- Bower (
npm install --global bower) - Grunt (
npm install --global grunt-cli)
To run the app in production, follow these few steps:
- Check out the code or download the zipfile.
- Run
make installto install the dependencies. - Run
make buildto build the app. - Copy all the content of
dist/client(even hidden files) in yourwww. - Celebrate.
(Law) A a person who brings a civil action in a court (aka claimant).
(Law) A person or entity against whom an action or claim is brought in a court of law. It is one of your customer who is suspected of illegal activities on his service(s).
A Defendant has suscribed to one or more services(s) (product(s)) your company offers. It can be xDSL, hosting, email services ...
The source of the email. It can be direclty the plaintiff or an representative third party.
One Provider + one Category. If a defendant is identified, the report is linked to a defendant, a service and contains item(s).
One or more reports + one Category. It might be linked to a defendant/service, so all reports themselves linked to this defendant/service.
Fraudulent item found in an email.
An action on a customer's service (suspend, shutdown, breach of contract).
Get a look at the API which might provide more information about the workflow: cerberus-core