🛡️ Framework FuFuFaFa

Framework para Auditoria Unificada de Falhas e Defeitos
O framework definitivo de Auditoria de Segurança em Nuvem AWS que torna a auditoria de segurança tão fácil que você consegue fazer mesmo com sono! 😴

Principais Recursos • Como Funciona • Instalação • Início Rápido • Guia de Uso • Contribuindo

---

🌟 Principais Recursos

🔐 Detecção de Vazamento de Segredos Escaneie repositórios em busca de credenciais embutidas no código com mais de 50 padrões, incluindo chaves AWS, tokens de API e chaves privadas. Inclui detecção por entropia de Shannon.	☁️ Configuração Incorreta na AWS Verificações abrangentes para S3, EC2, IAM, RDS, Lambda, VPC e CloudTrail para garantir que sua infraestrutura de nuvem siga as melhores práticas.
📜 Escaneamento de IaC Analise arquivos Terraform, CloudFormation, Serverless e Kubernetes em busca de falhas de segurança antes da implantação usando o mecanismo Checkov.	👤 Análise de Permissões IAM Visualize e analise permissões IAM para detectar caminhos de escalonamento de privilégios e políticas excessivamente permissivas usando mapeamento baseado em grafos.

---

🔄 Como Funciona

O FuFuFaFa simplifica seu fluxo de trabalho de auditoria de segurança. Veja o fluxo do processo:

graph TD
    A[Start Scan] --> B{Select Scan Type}
    
    B -->|Secrets| C[Cloning Repository]
    C --> D[Regex & Entropy Analysis]
    D --> E[Git History Scan]
    
    B -->|Cloud| F[AWS API Calls]
    F --> G[Resource Enumeration]
    G --> H[Security Rule Check]
    
    B -->|IaC| I[Parse Infrastructure Code]
    I --> J[Checkov Policy Scan]
    
    B -->|IAM| K[Fetch IAM Policies]
    K --> L[Neo4j Graph Building]
    L --> M[Privilege Path Analysis]
    
    E --> N[Generate Report]
    H --> N
    J --> N
    M --> N
    
    N --> O((End))
    
    style A fill:#4F46E5,stroke:#333,stroke-width:2px,color:#fff
    style N fill:#10B981,stroke:#333,stroke-width:2px,color:#fff
    style O fill:#EF4444,stroke:#333,stroke-width:2px,color:#fff

🚀 Instalação

Pré-requisitos

• Python 3.9+
• Docker & Docker Compose (para armazenamento persistente)
• AWS CLI configurado (para varredura na nuvem)

Instalação Rápida

# 1. Clone the repository
git clone https://github.com/Masriyan/FuFuFaFa.git
cd FuFuFaFa

# 2. Set up virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -e ".[dev]"

# 4. Start database services
docker-compose up -d postgres redis neo4j

# 5. Initialize database
fufufafa init-db

⚡ Início Rápido

Comece a usar em segundos!

# 1. Verify installation
fufufafa --version

# 2. Run a secret scan on a local repo
fufufafa secret scan ./your-project

# 3. Scan your default AWS profile
fufufafa cloud scan

# 4. View help for more commands
fufufafa --help

📖 Guia de Uso

🕵️ Verificação de Segredos

Encontre segredos ocultos no seu código, mesmo no histórico profundo do git.

fufufafa secret scan ./target-repo --history

Opções:

• --history: Escaneia todo o histórico do git
• --entropy 4.5: Define um limite de entropia personalizado
• --json: Gera os resultados em formato JSON

☁️ Auditoria de Nuvem

Audite seu ambiente AWS em busca de falhas de segurança.

fufufafa cloud scan --profile production --regions us-east-1,us-west-2

Opções:

• --profile: Especificar perfil da AWS CLI
• --services s3,ec2,iam: Varredura contextual
• --fix: Tentar correção automática (Use com cautela!)

🏗️ Segurança de IaC

Antecipe-se varrendo o código da sua infraestrutura.

fufufafa iac scan ./terraform-files

🕸️ Análise de IAM

Visualize caminhos de permissão e encontre funções perigosas.

fufufafa iam analyze --graph

Nota: Requer que o serviço Neo4j esteja em execução.

---

🏗️ Arquitetura

O framework FuFuFaFa foi construído para modularidade e escalabilidade.

C4Context
    title System Context Diagram for FuFuFaFa

    Person(user, "Security Auditor", "Uses FuFuFaFa to audit cloud security.")
    System(fufufafa, "FuFuFaFa Framework", "CLI tool for scanning secrets, cloud config, IaC, and IAM.")
    
    System_Ext(aws, "AWS Cloud", "Target environment for auditing.")
    System_Ext(neo4j, "Neo4j Database", "Stores IAM graph relationships.")
    System_Ext(postgres, "PostgreSQL", "Stores finding results and reports.")
    
    Rel(user, fufufafa, "Runs CLI commands")
    Rel(fufufafa, aws, "Reads configuration via API")
    Rel(fufufafa, neo4j, "Queries/Updates Graph")
    Rel(fufufafa, postgres, "Persists Audit Data")

🤝 Comunidade e Suporte

Agradecemos as contribuições! Consulte nosso Guia de Contribuição para mais detalhes.

• Encontrou um bug? Abra uma Issue
• Preocupação com segurança? Consulte SECURITY.md
• Código de Conduta? Consulte CODE_OF_CONDUCT.md

---

Feito com ❤️ e ☕ pela Equipe FuFuFaFa