ghurcka / cervantes

Cervantes is an opensource collaborative platform for pentesters or red teams who want to save time to manage their projects, clients, vulnerabilities and reports in one place.

Cervantes is an opensource collaborative platform for pentesters or red teams who want to save time to manage their projects, clients, vulnerabilities and reports in one place.

Technologies

Features

• OpenSource
• Multiplatform
• Multilanguage
• Team Collaboration
• BuiltIn dashbaords and analytics
• Manage your clients and Offensive Security projects
• One click reports creation
• And more

Runtime requirements

• Docker
• Docker compose

How to run it locally with Docker compose

1. First you need to clone this repository

git clone https://github.com/CervantesSec/docker.git

2. After that you need to start your docker containers:

docker-compose -p cervantes up -d

3. After this, open your browser at http://localhost

4. Default User is:

[email protected] - Admin123.

How to run it locally from source

1. Install dotnet sdk from https://dotnet.microsoft.com/en-us/download

2. Install PostgreSQL https://www.postgresql.org/download/

3. Clone this repository

git clone https://github.com/CervantesSec/cervantes.git

4. In Cervantes.Web -> appsettings.json edit the DefaultConnection with your database parameters

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=cervantes;Username=postgres;Password=postgres"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Trace",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information",
      "Cervantes.*": "Trace"
    }
  },
  "AllowedHosts": "*",
  "EmailConfiguration": {
    "SmtpServer": "smtp.office365.com",
    "SmtpPort": 587,
    "SmtpUsername": "EMAIL",
    "SmtpPassword": "PASSWORD"
  }
}

5. NOTE if your using linux install wkhtmltopdf and and copy the wkhtmltopdf and wkhtmltoimage from /usr/bin to /CERVANTES_PATH/Cervantes.Web/wwwroot/Rotativa/Linux/

6. Run the project

dotnet run --project /CERVANTES_PATH/Cervantes.Web/

7. After this, open your browser at http://localhost:5001

8. Default User is:

[email protected] - Admin123.

How to contribute

Here are some things you could do to become a contributor:

• ★ Star this project on Github ★
• Suggest new features or ideas
• Improve the code of the platform components
• Report security issues

Before you jump to make any changes make sure you have read the contributing guidelines. This would save us all time. Thanks!

How to report bugs

If you have bugs to report please use the issues tab on Github to submit the details.