spinny:~/writing $ less devsecops-shift-left-security-guide.md
12Una vulnerabilita trovata mentre si scrive codice costa a uno sviluppatore pochi minuti per essere corretta. La stessa vulnerabilita individuata in produzione costa uno sprint. E se un attaccante la trova per primo, costa milioni. Questo e l'argomento centrale della **shift-left security** - spostare i controlli di sicurezza il prima possibile nel ciclo di vita dello sviluppo.34Il DevSecOps prende questa idea e la trasforma in una pratica: la sicurezza non e una fase separata alla fine, ma un processo continuo integrato in ogni fase dello sviluppo, dalla prima riga di codice al deploy in produzione.56## Il costo della sicurezza tardiva78Il report Cost of a Data Breach di IBM ha costantemente dimostrato che il costo per risolvere i problemi di sicurezza cresce esponenzialmente quanto piu tardi vengono individuati:910| Fase | Costo di correzione | Tempo di correzione |11|------|---------------------|---------------------|12| **IDE / Sviluppo locale** | Minuti | Secondi o minuti |13| **Code review / PR** | Ore | Minuti o ore |14| **Pipeline CI/CD** | Giorni | Ore o giorni |15| **Staging / QA** | Settimane | Giorni |16| **Produzione** | Mesi | Settimane o mesi |17| **Post-breach** | Milioni ($) | Mesi o anni |1819La conclusione e chiara: ogni fase in cui anticipi la sicurezza fa risparmiare un ordine di grandezza in costi e tempo.2021## La pipeline DevSecOps2223Una pipeline DevSecOps matura integra controlli di sicurezza in ogni fase:2425```mermaid26graph LR27 IDE[IDE / Editor] --> PC[Pre-commit Hooks]28 PC --> PR[Pull Request]29 PR --> CI[CI Pipeline]30 CI --> Build[Build / Package]31 Build --> Deploy[Deploy]32 Deploy --> Runtime[Runtime / Production]3334 IDE -.- S1[SAST\nSecret Detection\nLinting]35 PC -.- S2[Secrets Scan\nFormat Check]36 PR -.- S3[Code Review\nDependency Audit]37 CI -.- S4[SAST\nSCA\nContainer Scan\nSBOM]38 Build -.- S5[Image Signing\nArtifact Verification]39 Deploy -.- S6[Policy Enforcement\nAdmission Control]40 Runtime -.- S7[DAST\nWAF\nMonitoring]41```4243Analizziamo ogni fase con strumenti e configurazioni concreti.4445## Fase 1: sicurezza nell'IDE4647Il ciclo di feedback piu rapido. Individua le vulnerabilita prima ancora di salvare il file.4849### Strumenti consigliati5051- **Semgrep**: analisi statica leggera con regole della community per le vulnerabilita OWASP52- **Snyk IDE Extension**: scansione in tempo reale delle vulnerabilita delle dipendenze53- **GitLens + GitLeaks**: rileva i secret nel tuo editor54- **ESLint Security Plugins**: `eslint-plugin-security` per Node.js, `eslint-plugin-no-unsanitized` per DOM XSS5556### Esempio: configurazione ESLint per la sicurezza5758```json59{60 "extends": ["eslint:recommended"],61 "plugins": ["security", "no-unsanitized"],62 "rules": {63 "security/detect-object-injection": "warn",64 "security/detect-non-literal-regexp": "warn",65 "security/detect-unsafe-regex": "error",66 "security/detect-buffer-noassert": "error",67 "security/detect-eval-with-expression": "error",68 "security/detect-no-csrf-before-method-override": "error",69 "security/detect-possible-timing-attacks": "warn",70 "no-unsanitized/method": "error",71 "no-unsanitized/property": "error"72 }73}74```7576## Fase 2: Pre-commit Hooks7778La seconda linea di difesa. Si eseguono automaticamente prima di ogni commit, bloccando il codice pericoloso dall'entrare nel repository.7980### Gitleaks: intercetta i secret prima che finiscano in Git8182L'errore di sicurezza piu comune nei codebase e il commit di secret - chiavi API, password di database, token. Una volta che un secret finisce nella cronologia di git, e estremamente difficile rimuoverlo completamente (anche con i force push, fork e cache potrebbero conservarlo).8384```yaml85# .pre-commit-config.yaml86repos:87 - repo: https://github.com/gitleaks/gitleaks88 rev: v8.21.089 hooks:90 - id: gitleaks9192 - repo: https://github.com/semgrep/semgrep93 rev: v1.90.094 hooks:95 - id: semgrep96 args: ['--config', 'auto']97```9899Installa e attiva:100101```bash102pip install pre-commit103pre-commit install104```105106Ora ogni `git commit` scansiona automaticamente alla ricerca di secret trapelati e vulnerabilita comuni. Se viene trovato qualcosa, il commit viene bloccato.107108### Regole Gitleaks personalizzate109110Puoi aggiungere pattern personalizzati per i secret della tua organizzazione:111112```toml113# .gitleaks.toml114title = "Custom Gitleaks Config"115116[[rules]]117id = "internal-api-key"118description = "Internal API key detected"119regex = '''INTERNAL_KEY_[A-Za-z0-9]{32}'''120tags = ["key", "internal"]121```122123## Fase 3: sicurezza della pipeline CI/CD124125Qui avviene il lavoro pesante. La tua pipeline CI dovrebbe eseguire piu scansioni di sicurezza su ogni pull request.126127### SAST (Static Application Security Testing)128129Gli strumenti SAST analizzano il codice sorgente senza eseguirlo, cercando pattern che indicano vulnerabilita.130131```yaml132# .github/workflows/security.yml133name: Security Scan134on:135 pull_request:136 branches: [main]137138jobs:139 sast:140 name: Static Analysis141 runs-on: ubuntu-latest142 steps:143 - uses: actions/checkout@v4144145 - name: Run Semgrep146 uses: semgrep/semgrep-action@v1147 with:148 config: >-149 p/owasp-top-ten150 p/typescript151 p/nodejs152 p/react153 generateSarif: true154155 - name: Upload SARIF156 uses: github/codeql-action/upload-sarif@v3157 with:158 sarif_file: semgrep.sarif159```160161Il ruleset `p/owasp-top-ten` di Semgrep intercetta le vulnerabilita piu comuni: SQL injection, XSS, SSRF, path traversal, deserializzazione non sicura e altro.162163### SCA (Software Composition Analysis)164165L'SCA scansiona le tue dipendenze alla ricerca di vulnerabilita note. Questo e fondamentale - oltre l'80% del codice delle applicazioni moderne proviene da dipendenze open-source.166167```yaml168 dependency-scan:169 name: Dependency Audit170 runs-on: ubuntu-latest171 steps:172 - uses: actions/checkout@v4173174 - name: Run Snyk175 uses: snyk/actions/node@master176 env:177 SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}178 with:179 args: --severity-threshold=high180181 - name: npm audit182 run: npm audit --audit-level=high183```184185### Sicurezza dei container con Trivy186187Se costruisci immagini Docker, scansionarle alla ricerca di vulnerabilita e essenziale. **Trivy** e lo scanner di container open-source piu popolare.188189```yaml190 container-scan:191 name: Container Security192 runs-on: ubuntu-latest193 steps:194 - uses: actions/checkout@v4195196 - name: Build image197 run: docker build -t my-app:${{ github.sha }} .198199 - name: Run Trivy200 uses: aquasecurity/trivy-action@master201 with:202 image-ref: my-app:${{ github.sha }}203 format: 'sarif'204 output: 'trivy-results.sarif'205 severity: 'CRITICAL,HIGH'206 exit-code: '1'207208 - name: Upload Trivy SARIF209 uses: github/codeql-action/upload-sarif@v3210 with:211 sarif_file: trivy-results.sarif212```213214### Generazione SBOM215216Una **Software Bill of Materials (SBOM)** e un inventario completo di ogni componente nella tua applicazione. E sempre piu richiesta dai framework di conformita e dalle normative governative (l'Executive Order statunitense sulla Cybersecurity impone la SBOM per il software federale).217218```yaml219 sbom:220 name: Generate SBOM221 runs-on: ubuntu-latest222 steps:223 - uses: actions/checkout@v4224225 - name: Generate SBOM with Syft226 uses: anchore/sbom-action@v0227 with:228 format: spdx-json229 output-file: sbom.spdx.json230231 - name: Upload SBOM232 uses: actions/upload-artifact@v4233 with:234 name: sbom235 path: sbom.spdx.json236```237238## Fase 4: immagini Docker sicure239240Un'immagine Docker di produzione dovrebbe seguire il principio del minimo privilegio. Ecco come appare un Dockerfile rafforzato:241242```dockerfile243# Build stage244FROM node:22-alpine AS builder245WORKDIR /app246COPY package.json package-lock.json ./247RUN npm ci248COPY . .249RUN npm run build250251# Production stage252FROM node:22-alpine AS runner253WORKDIR /app254255# Install dumb-init before dropping root256RUN apk add --no-cache dumb-init257258# Don't run as root259RUN addgroup -S app && adduser -S app -G app260261# Copy only what's needed262COPY --from=builder --chown=app:app /app/dist ./dist263COPY --from=builder --chown=app:app /app/node_modules ./node_modules264COPY --from=builder --chown=app:app /app/package.json ./265266# Drop to non-root user267USER app268ENTRYPOINT ["dumb-init", "--"]269270# Health check271HEALTHCHECK --interval=30s --timeout=3s --retries=3 \272 CMD wget -qO- http://localhost:3000/health || exit 1273274EXPOSE 3000275CMD ["node", "dist/server.js"]276```277278Pratiche chiave:2792801. **Usa build multi-stage**: lo stage builder ha le dipendenze di sviluppo; lo stage runner ha solo il codice di produzione2812. **Non eseguire come root**: crea un utente non-root e passa a quello2823. **Usa immagini Alpine**: superficie di attacco ridotta (meno pacchetti installati di default)2834. **Fissa le versioni delle immagini**: `node:22-alpine` invece di `node:latest` per evitare attacchi alla supply chain2845. **Usa `npm ci`**: installazioni deterministiche dal lock file, non `npm install`285286## Fase 5: gestione dei secret287288I secret hard-coded sono la causa numero uno delle violazioni negli incidenti causati dagli sviluppatori.289290### Cosa NON fare291292```typescript293// NEVER do this294const API_KEY = "sk-1234567890abcdef";295const DB_PASSWORD = "supersecret123";296297const client = new Client({298 connectionString: `postgres://admin:${DB_PASSWORD}@db.example.com/prod`299});300```301302### Cosa fare invece303304```typescript305// Use environment variables306const client = new Client({307 connectionString: process.env.DATABASE_URL308});309310// Or use a secret manager311import { SecretManagerServiceClient } from '@google-cloud/secret-manager';312313const client = new SecretManagerServiceClient();314const [version] = await client.accessSecretVersion({315 name: 'projects/my-project/secrets/db-password/versions/latest',316});317const dbPassword = version.payload?.data?.toString();318```319320### Gerarchia della gestione dei secret321322```mermaid323graph TD324 A[Secret Manager\nAWS Secrets Manager\nGCP Secret Manager\nHashiCorp Vault] --> B[Best: Rotated, audited, centralized]325 C[Environment Variables\nInjected at deploy time] --> D[Good: Not in code, but static]326 E[.env files\nWith .gitignore] --> F[Acceptable: Local development only]327 G[Hard-coded in source] --> H[NEVER: Instant breach risk]328329 style A fill:#d4edda330 style C fill:#fff3cd331 style E fill:#ffeeba332 style G fill:#f8d7da333```334335## L'OWASP Top 10: un riferimento rapido336337Ogni sviluppatore dovrebbe conoscere l'OWASP Top 10. Versione sintetica:338339| # | Vulnerabilita | Cos'e | Prevenzione |340|---|---------------|-------|-------------|341| 1 | **Broken Access Control** | Utenti che accedono a risorse non autorizzate | Nega per default, valida lato server |342| 2 | **Cryptographic Failures** | Crittografia debole, dati in chiaro | Usa algoritmi robusti (AES-256, bcrypt), TLS ovunque |343| 3 | **Injection** | SQL, NoSQL, OS command injection | Query parametrizzate, validazione degli input |344| 4 | **Insecure Design** | Architettura con difetti | Threat modeling, secure design patterns |345| 5 | **Security Misconfiguration** | Credenziali di default, bucket cloud aperti | Default rafforzati, audit automatici della configurazione |346| 6 | **Vulnerable Components** | CVE note nelle dipendenze | Scansione SCA, aggiornamenti regolari |347| 7 | **Auth Failures** | Password deboli, sessioni compromesse | MFA, rate limiting, gestione sicura delle sessioni |348| 8 | **Data Integrity Failures** | Aggiornamenti non firmati, CI/CD non affidabile | Code signing, SBOM, integrita della pipeline |349| 9 | **Logging Failures** | Nessuna traccia di audit | Logging strutturato, alerting sulle anomalie |350| 10 | **SSRF** | Server-side request forgery | Allowlist degli URL in uscita, validazione degli input |351352## Workflow completo di sicurezza con GitHub Actions353354Un workflow completo e pronto per la produzione che combina tutto quanto sopra:355356```yaml357# .github/workflows/security.yml358name: Security Pipeline359on:360 pull_request:361 branches: [main]362 push:363 branches: [main]364365permissions:366 contents: read367 security-events: write368369jobs:370 secrets-scan:371 name: Secret Detection372 runs-on: ubuntu-latest373 steps:374 - uses: actions/checkout@v4375 with:376 fetch-depth: 0377 - uses: gitleaks/gitleaks-action@v2378 env:379 GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}380381 sast:382 name: Static Analysis (SAST)383 runs-on: ubuntu-latest384 steps:385 - uses: actions/checkout@v4386 - uses: semgrep/semgrep-action@v1387 with:388 config: p/owasp-top-ten p/typescript p/nodejs389390 dependency-audit:391 name: Dependency Scan (SCA)392 runs-on: ubuntu-latest393 steps:394 - uses: actions/checkout@v4395 - uses: actions/setup-node@v4396 with:397 node-version: 22398 - run: npm ci399 - run: npm audit --audit-level=high400 - uses: snyk/actions/node@master401 env:402 SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}403 with:404 args: --severity-threshold=high405 continue-on-error: true406407 container-scan:408 name: Container Scan409 runs-on: ubuntu-latest410 needs: [sast, dependency-audit]411 steps:412 - uses: actions/checkout@v4413 - run: docker build -t app:${{ github.sha }} .414 - uses: aquasecurity/trivy-action@master415 with:416 image-ref: app:${{ github.sha }}417 severity: CRITICAL,HIGH418 exit-code: '1'419420 sbom:421 name: SBOM Generation422 runs-on: ubuntu-latest423 needs: [container-scan]424 steps:425 - uses: actions/checkout@v4426 - uses: anchore/sbom-action@v0427 with:428 format: spdx-json429 output-file: sbom.spdx.json430```431432```mermaid433graph TD434 PR[Pull Request] --> S1[Secret Detection]435 PR --> S2[SAST - Semgrep]436 PR --> S3[SCA - Snyk + npm audit]437 S2 --> S4[Container Scan - Trivy]438 S3 --> S4439 S4 --> S5[SBOM Generation]440 S5 --> Deploy[Deploy]441442 S1 -.- F1[Block if secrets found]443 S2 -.- F2[Block on critical vulns]444 S3 -.- F3[Block on high severity]445 S4 -.- F4[Block on critical CVEs]446```447448## Metriche da monitorare449450Come sapere se il tuo programma DevSecOps funziona? Monitora queste metriche:451452- **Mean time to remediate (MTTR)**: quanto velocemente correggi le vulnerabilita dopo il rilevamento453- **Vulnerability escape rate**: percentuale di vulnerabilita che raggiungono la produzione454- **False positive rate**: troppi falsi positivi portano ad affaticamento da alert e avvisi ignorati455- **Dependency freshness**: eta media delle tue dipendenze (piu vecchie = piu probabilita di CVE note)456- **SBOM coverage**: percentuale di progetti con SBOM aggiornate457458## Per iniziare: una roadmap pratica459460Non provare a implementare tutto in una volta. Un approccio graduale funziona meglio:461462```mermaid463flowchart TD464 A[Week 1-2: Foundations] --> B[Week 3-4: CI/CD Integration]465 B --> C[Month 2: Container Security]466 C --> D[Month 3+: Advanced]467468 A --> A1[Add Gitleaks pre-commit hooks]469 A --> A2[Enable npm audit in CI]470 A --> A3[Add .gitignore for .env files]471472 B --> B1[Add Semgrep to GitHub Actions]473 B --> B2[Add Snyk dependency scanning]474 B --> B3[Set up SARIF upload to GitHub]475476 C --> C1[Add Trivy container scanning]477 C --> C2[Harden Dockerfiles]478 C --> C3[Generate SBOMs]479480 D --> D1[Secret manager integration]481 D --> D2[Runtime protection - DAST]482 D --> D3[Policy as code - OPA]483```484485## Conclusione486487Il DevSecOps non consiste nell'aggiungere piu strumenti alla tua pipeline - si tratta di rendere la sicurezza una parte naturale del modo in cui costruisci il software. L'obiettivo non e bloccare ogni PR con avvisi di sicurezza, ma dare agli sviluppatori un feedback rapido cosi che possano correggere i problemi mentre il codice e ancora fresco nella loro mente.488489Inizia con le basi: pre-commit hooks per i secret, dependency scanning nella CI e container scanning per le immagini Docker. Poi itera in base alle esigenze del tuo team.490491La sicurezza non e una funzionalita che rilasci una sola volta. E una pratica che integri in ogni commit.492493> **Checklist iniziale DevSecOps:**494>495> - [x] Pre-commit hooks Gitleaks installati496> - [x] File .env e secret nel .gitignore497> - [x] Semgrep SAST nella pipeline CI498> - [x] Snyk o npm audit per il dependency scanning499> - [x] Trivy per la scansione delle immagini container500> - [x] Utente non-root nei Dockerfile501> - [x] Secret nelle variabili d'ambiente o nel secret manager502> - [x] Generazione SBOM a ogni release503> - [x] Consapevolezza dell'OWASP Top 10 in tutto il team504
:DevSecOps per sviluppatori: una guida pratica alla shift-left securitylines 1-504 (END) — press q to close