nuvola

nuvola (com o n minúsculo) é uma ferramenta para despejar e realizar análises de segurança automáticas e manuais em configurações de ambientes AWS e serviços usando regras predefinidas, extensíveis e personalizadas criadas com uma sintaxe Yaml simples.

A ideia geral por trás deste projeto é criar um gêmeo digital abstrato de uma plataforma de nuvem. Para um exemplo mais concreto: nuvola reflete as características do BloodHound usadas para análise de Active Directory, mas em ambientes de nuvem (no momento apenas AWS).

O uso de um banco de dados de grafos também aumenta a possibilidade de encontrar diferentes e inovadores caminhos de ataque e pode ser usado como um gêmeo digital offline, centralizado e leve.

Início Rápido

Requisitos

• docker-compose instalado
• uma conta AWS configurada para ser usada com awscli com acesso total aos recursos da nuvem, melhor se no modo ReadOnly (a política arn:aws:iam::aws:policy/ReadOnlyAccess é suficiente)

Configuração

1. Clone o repositório

git clone --depth=1 https://github.com/primait/nuvola.git; cd nuvola

2. Crie e edite, se necessário, o arquivo .env para definir seu nome de usuário/senha/URL do banco de dados

cp .env_example .env;

Você pode precisar editar o tamanho da memória alocada para o Neo4j se executar a ferramenta em um dispositivo com pouca RAM.

3. Inicie a instância docker do Neo4j

make start-containers

4. Compile a ferramenta

make build

Uso

1. Primeiramente, você precisa despejar todas as configurações dos serviços AWS suportados e carregar os dados no banco de dados Neo4j:

./nuvola dump --aws-profile default_RO --output-dir ~/DumpDumpFolder --output-format zip

2. Para importar uma operação de despejo previamente executada para o banco de dados Neo4j:

./nuvola assess --import ~/DumpDumpFolder/nuvola-default_RO_20220901.zip

3. Para realizar apenas análises estáticas nos dados carregados no banco de dados Neo4j usando o conjunto de regras predefinidas:

./nuvola assess

4. Ou use o Neo4j Browser para explorar manualmente o gêmeo digital.

Solução de Problemas

Se você usar o .env_example, as configurações de memória NEO4J_server_memory_* do neo4j podem ser muito grandes, fazendo com que o contêiner docker trave devido à falta de memória no sistema host. Remover as linhas NEO4J_server_memory_* forçará o neo4j a calcular esses valores com base nos recursos disponíveis do sistema (ref).

Sobre o nuvola

Para começar com o nuvola e seu esquema de banco de dados, consulte o Wiki do nuvola.

Nenhum dado é enviado ou compartilhado com a Prima Assicurazioni.

Como contribuir

• relatar bugs e problemas
• relatar novas melhorias
• revisar issues e pull requests
• corrigir bugs e problemas
• criar novas regras
• melhorar a qualidade geral

Apresentações

• RomHack 2022

  • Slides
  • Demonstrações

• DevSecCon 2024

  • Agenda
  • Vídeo

Licença

nuvola usa teoria dos grafos para revelar possíveis caminhos de ataque e configurações incorretas de segurança em ambientes de nuvem.

Este programa é software livre: você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation, seja a versão 3 da Licença, ou (a seu critério) qualquer versão posterior.

Este programa é distribuído na esperança de que seja útil, mas SEM NENHUMA GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM PROPÓSITO PARTICULAR. Consulte a Licença Pública Geral GNU para obter mais detalhes.

Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este repositório e programa. Se não, veja http://www.gnu.org/licenses/.