🛡️ Framework FuFuFaFa

Framework para la Auditoría Unificada de Defectos y Fallos
El framework definitivo de auditoría de seguridad en la nube de AWS que hace que la auditoría de seguridad sea ¡tan fácil que puedes hacerla incluso cuando tienes sueño! 😴

Características Principales • Cómo Funciona • Instalación • Inicio Rápido • Guía de Uso • Contribuir

---

🌟 Características Principales

🔐 Detección de Fugas de Secretos Escanea repositorios en busca de credenciales codificadas de forma rígida con más de 50 patrones, incluyendo claves de AWS, tokens de API y claves privadas. Incluye detección de entropía de Shannon.	☁️ Configuración Incorrecta de AWS Comprobaciones exhaustivas para S3, EC2, IAM, RDS, Lambda, VPC y CloudTrail para garantizar que tu infraestructura en la nube siga las mejores prácticas.
📜 Escaneo de IaC Analiza archivos de Terraform, CloudFormation, Serverless y Kubernetes en busca de fallos de seguridad antes del despliegue utilizando el motor Checkov.	👤 Análisis de Permisos IAM Visualiza y analiza los permisos IAM para detectar rutas de escalada de privilegios y políticas excesivamente permisivas mediante mapeo basado en grafos.

---

🔄 Cómo Funciona

FuFuFaFa optimiza tu flujo de trabajo de auditoría de seguridad. Este es el flujo del proceso:

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

🚀 Instalación

Requisitos previos

• Python 3.9+
• Docker y Docker Compose (para almacenamiento persistente)
• AWS CLI configurado (para escaneo en la nube)

Instalación 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

⚡ Inicio rápido

¡Ponte en marcha en 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

📖 Guía de uso

🕵️ Escaneo de secretos

Encuentra secretos ocultos en tu código, incluso en lo más profundo del historial de git.

fufufafa secret scan ./target-repo --history

Opciones:

• --history: Escanear el historial completo de git
• --entropy 4.5: Establecer un umbral de entropía personalizado
• --json: Mostrar los resultados en formato JSON

☁️ Auditoría en la nube

Audita tu entorno de AWS en busca de brechas de seguridad.

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

Opciones:

• --profile: Especificar el perfil de AWS CLI
• --services s3,ec2,iam: Escaneo contextual
• --fix: Intentar la corrección automática (¡Usar con precaución!)

🏗️ Seguridad de IaC

Desplázate a la izquierda escaneando el código de tu infraestructura.

fufufafa iac scan ./terraform-files

🕸️ Análisis de IAM

Visualiza rutas de permisos y encuentra roles peligrosos.

fufufafa iam analyze --graph

Nota: Requiere que el servicio Neo4j esté en ejecución.

---

🏗️ Arquitectura

El framework FuFuFaFa está diseñado para la modularidad y la escalabilidad.

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")

🤝 Comunidad y soporte

¡Damos la bienvenida a las contribuciones! Consulta nuestra Guía de contribución para más detalles.

• ¿Encontraste un error? Abre un Issue
• ¿Preocupación de seguridad? Consulta SECURITY.md
• ¿Código de conducta? Consulta CODE_OF_CONDUCT.md

---

Hecho con ❤️ y ☕ por el equipo de FuFuFaFa