cervantes

Cervantes è una piattaforma open-source collaborativa progettata specificamente per pentester e red team. Funge da strumento di gestione completo, semplificando l'organizzazione di progetti, clienti, vulnerabilità e report in un unico luogo centralizzato.

Facilitando una gestione efficiente dei dati e fornendo uno spazio di lavoro unificato, Cervantes mira a ridurre significativamente il tempo e lo sforzo necessari per il coordinamento e l'esecuzione delle attività di penetration testing.

Supportato

Cervantes è un progetto della OWASP Foundation

Tecnologie

Funzionalità

• OpenSource
• Multipiattaforma
• Multilingua
• Collaborazione di squadra
• Checklist
• Report di conformità OWASP
• Dashboard e analisi integrate
• Gestisci i tuoi clienti e progetti di sicurezza offensiva
• Creazione di report con un clic
• E altro ancora

Requisiti di runtime

• Docker
• Docker compose

Come eseguirlo localmente con Docker compose

• Per prima cosa devi clonare questo repository

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

• Dopodiché devi avviare i tuoi container docker:

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

• Dopo di che, apri il tuo browser all'indirizzo http://localhost o https://localhost e vedrai la pagina di login di Cervantes.

Utente e password predefiniti

Quando avvii l'applicazione Cervantes per la prima volta, viene creato un utente predefinito. Il nome utente predefinito è [email protected].

La password per questo utente viene generata casualmente durante la creazione del container dell'applicazione e il primo avvio. Ciò significa che la password è unica per ogni istanza dell'applicazione e fornisce un ulteriore livello di sicurezza.

Tieni presente che è importante cambiare la password predefinita il prima possibile per garantire la sicurezza della tua applicazione. Puoi farlo accedendo con l'utente predefinito e andando alla pagina delle impostazioni utente.

Ricorda, la sicurezza della tua applicazione è fondamentale. Usa sempre password forti e uniche e cambiale regolarmente.

Come eseguirlo localmente dal sorgente

Requisiti

• .NET 8
• PostgresSQL
• Atlassian Jira Server (Opzionale solo se vuoi utilizzare l'integrazione Jira)

Come eseguirlo localmente

Per installare l'applicazione Cervantes dal codice sorgente, puoi seguire questi passaggi:

• Clona il Repository: Innanzitutto, devi clonare il repository da GitHub. Puoi farlo eseguendo il seguente comando nel tuo terminale:

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

• Naviga nella Directory del Progetto: Una volta clonato il repository, spostati nella directory del progetto:

cd Cervantes

• Modifica appsettings.json: Per utilizzare l'applicazione devi modificare il file appsettings.json all'interno della cartella Cervantes.Web.

Stringa di connessione al database La stringa di connessione al database viene utilizzata per connettere la tua applicazione al database. Di solito include il nome del server, il nome del database e i dettagli di autenticazione. Ecco un esempio di come potrebbe apparire nel tuo appsettings.json:

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

Sostituisci myServerAddress, myDataBase, myUsername e myPassword con i dettagli reali del tuo database.

• Installa le Dipendenze: Il progetto utilizza .NET 8.0, quindi devi averlo installato sulla tua macchina. Se non lo hai, puoi scaricarlo dal sito ufficiale di .NET. Una volta installato .NET, puoi installare le dipendenze del progetto eseguendo:

dotnet restore

• Compila il Progetto: Dopo aver installato le dipendenze, puoi compilare il progetto:

dotnet build

• Esegui il Progetto: Infine, puoi eseguire il progetto:

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

L'applicazione dovrebbe ora essere in esecuzione su http://localhost:5235.

Tieni presente che questa è una guida di installazione di base e il processo effettivo potrebbe variare a seconda della configurazione e dei requisiti specifici del progetto. Ad esempio, se il progetto utilizza un database, potresti dover configurare il database e aggiornare la stringa di connessione nel file di configurazione.

Come contribuire

Ecco alcune cose che puoi fare per diventare un contributore:

• ★ Metti una stella a questo progetto su GitHub ★
• Suggerisci nuove funzionalità o idee
• Migliora il codice dei componenti della piattaforma
• Segnala problemi di sicurezza

Prima di apportare qualsiasi modifica, assicurati di aver letto le linee guida per contribuire. Questo ci farà risparmiare tempo a tutti. Grazie!

Sicurezza

Segnala i problemi di sicurezza tramite la nostra politica di divulgazione.

Come segnalare bug

Se hai bug da segnalare, utilizza la scheda issues su GitHub per inviare i dettagli.

Contributors

Licenza

Questo progetto è concesso in licenza sotto GNU Affero General Public License (AGPL-3.0), tranne per componenti specifici che rimangono sotto licenza Apache 2.0.

Riepilogo:

AGPL-3.0 si applica alla maggior parte del progetto.

Apache License 2.0 si applica ai componenti elencati nel file NOTICE.

Per maggiori dettagli, consulta i file LICENSE e NOTICE completi inclusi in questo repository.

Avviso sul copyright

Copyright (C) 2025 Ruben Mesquida Gomila

OWASP Cervantes e tutti i contributi sono protetti dalle rispettive licenze. Per maggiori informazioni sui termini di licenza, visita:

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

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