cervantes

Cervantes é uma plataforma colaborativa de código aberto projetada especificamente para pentesters e red teams. Ela funciona como uma ferramenta de gestão abrangente, simplificando a organização de projetos, clientes, vulnerabilidades e relatórios em um único local centralizado.

Ao facilitar o gerenciamento eficiente de dados e fornecer um espaço de trabalho unificado, o Cervantes visa reduzir significativamente o tempo e o esforço necessários na coordenação e execução de atividades de testes de penetração.

Suportado

Cervantes é um projeto da OWASP Foundation

Tecnologias

Funcionalidades

• Código aberto
• Multiplataforma
• Multilíngue
• Colaboração em equipe
• Listas de verificação
• Relatórios de conformidade com OWASP
• Painéis e análises integrados
• Gerencie seus clientes e projetos de Segurança Ofensiva
• Criação de relatórios com um clique
• E mais

Requisitos de execução

• Docker
• Docker compose

Como executar localmente com Docker compose

• Primeiro você precisa clonar este repositório

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

• Depois disso, você precisa iniciar seus contêineres Docker:

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

• Após isso, abra seu navegador em http://localhost ou https://localhost e você verá a página de login do Cervantes.

Usuário e senha padrão

Quando você inicia o aplicativo Cervantes pela primeira vez, um usuário padrão é criado para você. O nome de usuário padrão é [email protected].

A senha para este usuário é gerada aleatoriamente durante a criação do contêiner da aplicação e a primeira inicialização da aplicação. Isso significa que a senha é única para cada instância da aplicação e fornece uma camada adicional de segurança.

Observe que é importante alterar a senha padrão o mais rápido possível para garantir a segurança da sua aplicação. Você pode fazer isso fazendo login com o usuário padrão e navegando até a página de configurações do usuário.

Lembre-se, a segurança da sua aplicação é primordial. Sempre use senhas fortes e únicas e altere-as regularmente.

Como executar localmente a partir do código-fonte

Requisitos

• .NET 8
• PostgresSQL
• Atlassian Jira Server (Opcional, apenas se quiser usar a Integração com Jira)

Como executar localmente

Para instalar o aplicativo Cervantes a partir do código-fonte, você pode seguir estes passos:

• Clone o Repositório: Primeiro, você precisa clonar o repositório do GitHub. Você pode fazer isso executando o seguinte comando no seu terminal:

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

• Navegue até o Diretório do Projeto: Depois que o repositório for clonado, navegue até o diretório do projeto:

cd Cervantes

• Edite o appsettings.json: Para usar a aplicação, você precisa editar o arquivo appsettings.json dentro da pasta Cervantes.Web.

String de Conexão do Banco de Dados A string de conexão do banco de dados é usada para conectar sua aplicação ao seu banco de dados. Geralmente inclui o nome do servidor, nome do banco de dados e detalhes de autenticação. Aqui está um exemplo de como pode parecer no seu appsettings.json:

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

Substitua myServerAddress, myDataBase, myUsername e myPassword pelos seus detalhes reais do banco de dados.

• Instale as Dependências: O projeto usa .NET 8.0, então você precisa tê-lo instalado na sua máquina. Se não tiver, você pode baixá-lo do site oficial do .NET. Depois que o .NET estiver instalado, você pode instalar as dependências do projeto executando:

dotnet restore

• Compile o Projeto: Após as dependências serem instaladas, você pode compilar o projeto:

dotnet build

• Execute o Projeto: Finalmente, você pode executar o projeto:

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

O aplicativo agora deve estar rodando em http://localhost:5235.

Observe que este é um guia de instalação básico e o processo real pode variar dependendo da configuração e requisitos específicos do projeto. Por exemplo, se o projeto usar um banco de dados, você pode precisar configurar o banco de dados e atualizar a string de conexão no arquivo de configuração.

Como contribuir

Aqui estão algumas coisas que você pode fazer para se tornar um contribuidor:

• ★ Dê uma estrela neste projeto no GitHub ★
• Sugira novas funcionalidades ou ideias
• Melhore o código dos componentes da plataforma
• Reporte problemas de segurança

Antes de começar a fazer qualquer alteração, certifique-se de ter lido as diretrizes de contribuição. Isso economizaria tempo para todos. Obrigado!

Segurança

Por favor, reporte problemas de segurança através da nossa política de divulgação.

Como reportar bugs

Se você tiver bugs para reportar, use a aba issues no GitHub para enviar os detalhes.

Contribuidores

Licença

Este projeto está licenciado sob a GNU Affero General Public License (AGPL-3.0), exceto para componentes específicos que permanecem licenciados sob a Apache License 2.0.

Resumo:

AGPL-3.0 se aplica à maior parte do projeto.

Apache License 2.0 se aplica aos componentes listados no arquivo NOTICE.

Para mais detalhes, consulte os arquivos completos LICENSE e NOTICE incluídos neste repositório.

Aviso de Direitos Autorais

Copyright (C) 2025 Ruben Mesquida Gomila

OWASP Cervantes e todas as contribuições são protegidas sob suas respectivas licenças. Para mais informações sobre os termos de licença, visite:

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

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