cervantes

Cervantes ist eine Open-Source-Kollaborationsplattform, die speziell für Pentester und Red Teams entwickelt wurde. Sie dient als umfassendes Verwaltungstool und optimiert die Organisation von Projekten, Kunden, Schwachstellen und Berichten an einem zentralen Ort.

Durch die effiziente Datenverwaltung und einen einheitlichen Arbeitsbereich soll Cervantes den Zeit- und Arbeitsaufwand bei der Koordination und Durchführung von Penetrationstests erheblich reduzieren.

Unterstützt

Cervantes ist ein OWASP Foundation Projekt

Technologien

Funktionen

• OpenSource
• Multiplattform
• Mehrsprachigkeit
• Teamzusammenarbeit
• Checklisten
• OWASP-Compliance-Berichte
• Integrierte Dashboards und Analysen
• Verwalten Sie Ihre Kunden und Offensive-Security-Projekte
• Berichtserstellung mit einem Klick
• Und mehr

Laufzeitanforderungen

• Docker
• Docker compose

So führen Sie es lokal mit Docker Compose aus

• Zuerst müssen Sie dieses Repository klonen

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

• Danach müssen Sie Ihre Docker-Container starten:

docker-compose -p cervantes -f docker-compose.yml up -d

• Öffnen Sie anschließend Ihren Browser unter http://localhost oder https://localhost und Sie sehen die Anmeldeseite von Cervantes.

Standardbenutzer und Passwort

Wenn Sie die Cervantes-Anwendung zum ersten Mal starten, wird ein Standardbenutzer für Sie erstellt. Der Standardbenutzername lautet [email protected].

Das Passwort für diesen Benutzer wird beim Erstellen des Anwendungscontainers und beim ersten Start der Anwendung zufällig generiert. Dies bedeutet, dass das Passwort für jede Instanz der Anwendung eindeutig ist und eine zusätzliche Sicherheitsebene bietet.

Bitte beachten Sie, dass es wichtig ist, das Standardpasswort so schnell wie möglich zu ändern, um die Sicherheit Ihrer Anwendung zu gewährleisten. Sie können dies tun, indem Sie sich mit dem Standardbenutzer anmelden und zur Benutzereinstellungsseite navigieren.

Denken Sie daran, die Sicherheit Ihrer Anwendung hat höchste Priorität. Verwenden Sie stets sichere, eindeutige Passwörter und ändern Sie diese regelmäßig.

So führen Sie es lokal aus dem Quellcode aus

Voraussetzungen

• .NET 8
• PostgresSQL
• Atlassian Jira Server (Optional nur, wenn Sie die Jira-Integration nutzen möchten)

So führen Sie es lokal aus

Um die Cervantes-Anwendung aus dem Quellcode zu installieren, können Sie die folgenden Schritte ausführen:

• Repository klonen: Zuerst müssen Sie das Repository von GitHub klonen. Führen Sie dazu den folgenden Befehl in Ihrem Terminal aus:

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

• In das Projektverzeichnis wechseln: Sobald das Repository geklont ist, navigieren Sie in das Projektverzeichnis:

cd Cervantes

• appsettings.json bearbeiten: Um die Anwendung zu nutzen, müssen Sie die Datei appsettings.json im Ordner Cervantes.Web bearbeiten.

Datenbankverbindungszeichenfolge Die Datenbankverbindungszeichenfolge wird verwendet, um Ihre Anwendung mit Ihrer Datenbank zu verbinden. Sie enthält normalerweise den Servernamen, den Datenbanknamen und Authentifizierungsdetails. Hier ist ein Beispiel, wie es in Ihrer appsettings.json aussehen könnte:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=myServerAddress;Database=myDataBase;Username=myUsername;Password=myPassword"
  }
}

Ersetzen Sie myServerAddress, myDataBase, myUsername und myPassword durch Ihre tatsächlichen Datenbankdetails.

• Abhängigkeiten installieren: Das Projekt verwendet .NET 8.0, daher müssen Sie es auf Ihrem Rechner installiert haben. Falls Sie es noch nicht haben, können Sie es von der offiziellen .NET-Website herunterladen. Sobald .NET installiert ist, können Sie die Projektabhängigkeiten mit folgendem Befehl installieren:

dotnet restore

• Projekt erstellen: Nachdem die Abhängigkeiten installiert sind, können Sie das Projekt erstellen:

dotnet build

• Projekt ausführen: Schließlich können Sie das Projekt ausführen:

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

Die Anwendung sollte nun unter http://localhost:5235 laufen.

Bitte beachten Sie, dass dies eine grundlegende Installationsanleitung ist und der tatsächliche Prozess je nach spezifischer Konfiguration und Anforderungen des Projekts variieren kann. Wenn das Projekt beispielsweise eine Datenbank verwendet, müssen Sie möglicherweise die Datenbank einrichten und die Verbindungszeichenfolge in der Konfigurationsdatei aktualisieren.

So können Sie mitwirken

Hier sind einige Dinge, die Sie tun können, um mitzuwirken:

• ★ Star this project on GitHub ★
• Neue Funktionen oder Ideen vorschlagen
• Den Code der Plattformkomponenten verbessern
• Sicherheitsprobleme melden

Bevor Sie mit Änderungen beginnen, stellen Sie sicher, dass Sie die Richtlinien für Mitwirkende gelesen haben. Das spart uns allen Zeit. Danke!

Sicherheit

Bitte melden Sie Sicherheitsprobleme über unsere Offenlegungsrichtlinie.

So melden Sie Fehler

Wenn Sie Fehler melden möchten, verwenden Sie bitte den Reiter Issues auf GitHub, um die Details einzureichen.

Mitwirkende

Lizenz

Dieses Projekt ist unter der GNU Affero General Public License (AGPL-3.0) lizenziert, mit Ausnahme bestimmter Komponenten, die weiterhin unter der Apache License 2.0 lizenziert sind.

Zusammenfassung:

AGPL-3.0 gilt für den Großteil des Projekts.

Apache License 2.0 gilt für die in der NOTICE-Datei aufgeführten Komponenten.

Weitere Einzelheiten finden Sie in den vollständigen LICENSE- und NOTICE-Dateien in diesem Repository.

Urheberrechtshinweis

Copyright (C) 2025 Ruben Mesquida Gomila

OWASP Cervantes und alle Beiträge sind unter ihren jeweiligen Lizenzen geschützt. Weitere Informationen zu den Lizenzbedingungen finden Sie unter:

• https://www.gnu.org/licenses/agpl-3.0.html

• https://www.apache.org/licenses/LICENSE-2.0.html