1~
2Uma vulnerabilidade encontrada enquanto se escreve codigo custa a um desenvolvedor minutos para corrigir. A mesma vulnerabilidade detectada em producao custa um sprint. E se um atacante a encontra primeiro, custa milhoes. Este e o argumento central da **shift-left security**  -  mover os controles de seguranca o mais cedo possivel no ciclo de vida do desenvolvimento.
3~
4O DevSecOps pega essa ideia e a transforma em pratica: a seguranca nao e uma fase separada no final, mas um processo continuo integrado em cada etapa do desenvolvimento, desde a primeira linha de codigo ate o deploy em producao.
5~
6## O custo da seguranca tardia
7~
8O relatorio Cost of a Data Breach da IBM tem demonstrado consistentemente que o custo de corrigir problemas de seguranca cresce exponencialmente quanto mais tarde sao detectados:
9~
10| Etapa | Custo de correcao | Tempo de correcao |
11|-------|--------------------|--------------------|
12| **IDE / Desenvolvimento local** | Minutos | Segundos a minutos |
13| **Code review / PR** | Horas | Minutos a horas |
14| **Pipeline CI/CD** | Dias | Horas a dias |
15| **Staging / QA** | Semanas | Dias |
16| **Producao** | Meses | Semanas a meses |
17| **Post-breach** | Milhoes ($) | Meses a anos |
18~
19A conclusao e clara: cada etapa em que voce antecipa a seguranca economiza uma ordem de grandeza em custo e tempo.
20~
21## A pipeline DevSecOps
22~
23Uma pipeline DevSecOps madura integra controles de seguranca em cada etapa:
24~
25```mermaid
26graph LR
27    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]
33~
34    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```
42~
43Vamos detalhar cada etapa com ferramentas e configuracoes concretas.
44~
45## Etapa 1: seguranca no IDE
46~
47O ciclo de feedback mais rapido. Detecte vulnerabilidades antes mesmo de salvar o arquivo.
48~
49### Ferramentas recomendadas
50~
51- **Semgrep**: analise estatica leve com regras da comunidade para vulnerabilidades OWASP
52- **Snyk IDE Extension**: varredura em tempo real de vulnerabilidades em dependencias
53- **GitLens + GitLeaks**: detecte secrets no seu editor
54- **ESLint Security Plugins**: `eslint-plugin-security` para Node.js, `eslint-plugin-no-unsanitized` para DOM XSS
55~
56### Exemplo: configuracao ESLint para seguranca
57~
58```json
59{
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```
75~
76## Etapa 2: Pre-commit Hooks
77~
78A segunda linha de defesa. Executam-se automaticamente antes de cada commit, bloqueando codigo perigoso de entrar no repositorio.
79~
80### Gitleaks: intercepte secrets antes de chegarem ao Git
81~
82O erro de seguranca mais comum em codebases e fazer commit de secrets  -  chaves de API, senhas de banco de dados, tokens. Uma vez que um secret chega ao historico do git, e extremamente dificil remove-lo completamente (mesmo com force pushes, forks e caches podem rete-lo).
83~
84```yaml
85# .pre-commit-config.yaml
86repos:
87  - repo: https://github.com/gitleaks/gitleaks
88    rev: v8.21.0
89    hooks:
90      - id: gitleaks
91~
92  - repo: https://github.com/semgrep/semgrep
93    rev: v1.90.0
94    hooks:
95      - id: semgrep
96        args: ['--config', 'auto']
97```
98~
99Instale e ative:
100~
101```bash
102pip install pre-commit
103pre-commit install
104```
105~
106Agora cada `git commit` escaneia automaticamente em busca de secrets vazados e vulnerabilidades comuns. Se algo for encontrado, o commit e bloqueado.
107~
108### Regras personalizadas do Gitleaks
109~
110Voce pode adicionar padroes personalizados para os secrets da sua organizacao:
111~
112```toml
113# .gitleaks.toml
114title = "Custom Gitleaks Config"
115~
116[[rules]]
117id = "internal-api-key"
118description = "Internal API key detected"
119regex = '''INTERNAL_KEY_[A-Za-z0-9]{32}'''
120tags = ["key", "internal"]
121```
122~
123## Etapa 3: seguranca da pipeline CI/CD
124~
125E aqui que o trabalho pesado acontece. Sua pipeline CI deveria executar multiplas varreduras de seguranca em cada pull request.
126~
127### SAST (Static Application Security Testing)
128~
129As ferramentas SAST analisam o codigo-fonte sem executa-lo, procurando padroes que indicam vulnerabilidades.
130~
131```yaml
132# .github/workflows/security.yml
133name: Security Scan
134on:
135  pull_request:
136    branches: [main]
137~
138jobs:
139  sast:
140    name: Static Analysis
141    runs-on: ubuntu-latest
142    steps:
143      - uses: actions/checkout@v4
144~
145      - name: Run Semgrep
146        uses: semgrep/semgrep-action@v1
147        with:
148          config: >-
149            p/owasp-top-ten
150            p/typescript
151            p/nodejs
152            p/react
153          generateSarif: true
154~
155      - name: Upload SARIF
156        uses: github/codeql-action/upload-sarif@v3
157        with:
158          sarif_file: semgrep.sarif
159```
160~
161O ruleset `p/owasp-top-ten` do Semgrep detecta as vulnerabilidades mais comuns: SQL injection, XSS, SSRF, path traversal, deserializacao insegura e mais.
162~
163### SCA (Software Composition Analysis)
164~
165O SCA escaneia suas dependencias em busca de vulnerabilidades conhecidas. Isso e fundamental  -  mais de 80% do codigo das aplicacoes modernas vem de dependencias open-source.
166~
167```yaml
168  dependency-scan:
169    name: Dependency Audit
170    runs-on: ubuntu-latest
171    steps:
172      - uses: actions/checkout@v4
173~
174      - name: Run Snyk
175        uses: snyk/actions/node@master
176        env:
177          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
178        with:
179          args: --severity-threshold=high
180~
181      - name: npm audit
182        run: npm audit --audit-level=high
183```
184~
185### Seguranca de containers com Trivy
186~
187Se voce constroi imagens Docker, escanea-las em busca de vulnerabilidades e essencial. **Trivy** e o scanner de containers open-source mais popular.
188~
189```yaml
190  container-scan:
191    name: Container Security
192    runs-on: ubuntu-latest
193    steps:
194      - uses: actions/checkout@v4
195~
196      - name: Build image
197        run: docker build -t my-app:${{ github.sha }} .
198~
199      - name: Run Trivy
200        uses: aquasecurity/trivy-action@master
201        with:
202          image-ref: my-app:${{ github.sha }}
203          format: 'sarif'
204          output: 'trivy-results.sarif'
205          severity: 'CRITICAL,HIGH'
206          exit-code: '1'
207~
208      - name: Upload Trivy SARIF
209        uses: github/codeql-action/upload-sarif@v3
210        with:
211          sarif_file: trivy-results.sarif
212```
213~
214### Geracao de SBOM
215~
216Uma **Software Bill of Materials (SBOM)** e um inventario completo de cada componente na sua aplicacao. E cada vez mais exigida por frameworks de conformidade e regulamentacoes governamentais (a Ordem Executiva dos EUA sobre Ciberseguranca exige SBOM para software federal).
217~
218```yaml
219  sbom:
220    name: Generate SBOM
221    runs-on: ubuntu-latest
222    steps:
223      - uses: actions/checkout@v4
224~
225      - name: Generate SBOM with Syft
226        uses: anchore/sbom-action@v0
227        with:
228          format: spdx-json
229          output-file: sbom.spdx.json
230~
231      - name: Upload SBOM
232        uses: actions/upload-artifact@v4
233        with:
234          name: sbom
235          path: sbom.spdx.json
236```
237~
238## Etapa 4: imagens Docker seguras
239~
240Uma imagem Docker de producao deveria seguir o principio do menor privilegio. Veja como um Dockerfile reforçado se parece:
241~
242```dockerfile
243# Build stage
244FROM node:22-alpine AS builder
245WORKDIR /app
246COPY package.json package-lock.json ./
247RUN npm ci
248COPY . .
249RUN npm run build
250~
251# Production stage
252FROM node:22-alpine AS runner
253WORKDIR /app
254~
255# Install dumb-init before dropping root
256RUN apk add --no-cache dumb-init
257~
258# Don't run as root
259RUN addgroup -S app && adduser -S app -G app
260~
261# Copy only what's needed
262COPY --from=builder --chown=app:app /app/dist ./dist
263COPY --from=builder --chown=app:app /app/node_modules ./node_modules
264COPY --from=builder --chown=app:app /app/package.json ./
265~
266# Drop to non-root user
267USER app
268ENTRYPOINT ["dumb-init", "--"]
269~
270# Health check
271HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
272  CMD wget -qO- http://localhost:3000/health || exit 1
273~
274EXPOSE 3000
275CMD ["node", "dist/server.js"]
276```
277~
278Praticas-chave:
279~
2801. **Use builds multi-stage**: o stage builder tem as dependencias de desenvolvimento; o stage runner tem apenas o codigo de producao
2812. **Nao execute como root**: crie um usuario nao-root e mude para ele
2823. **Use imagens Alpine**: superficie de ataque reduzida (menos pacotes instalados por padrao)
2834. **Fixe as versoes das imagens**: `node:22-alpine` em vez de `node:latest` para evitar ataques a supply chain
2845. **Use `npm ci`**: instalacoes deterministicas a partir do lock file, nao `npm install`
285~
286## Etapa 5: gestao de secrets
287~
288Secrets hard-coded sao a causa numero um de violacoes em incidentes causados por desenvolvedores.
289~
290### O que NAO fazer
291~
292```typescript
293// NEVER do this
294const API_KEY = "sk-1234567890abcdef";
295const DB_PASSWORD = "supersecret123";
296~
297const client = new Client({
298  connectionString: `postgres://admin:${DB_PASSWORD}@db.example.com/prod`
299});
300```
301~
302### O que fazer em vez disso
303~
304```typescript
305// Use environment variables
306const client = new Client({
307  connectionString: process.env.DATABASE_URL
308});
309~
310// Or use a secret manager
311import { SecretManagerServiceClient } from '@google-cloud/secret-manager';
312~
313const 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```
319~
320### Hierarquia da gestao de secrets
321~
322```mermaid
323graph TD
324    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]
328~
329    style A fill:#d4edda
330    style C fill:#fff3cd
331    style E fill:#ffeeba
332    style G fill:#f8d7da
333```
334~
335## O OWASP Top 10: referencia rapida
336~
337Todo desenvolvedor deveria conhecer o OWASP Top 10. Versao resumida:
338~
339| # | Vulnerabilidade | O que e | Prevencao |
340|---|-----------------|---------|-----------|
341| 1 | **Broken Access Control** | Usuarios acessando recursos nao autorizados | Negar por padrao, validar no servidor |
342| 2 | **Cryptographic Failures** | Criptografia fraca, dados em texto puro | Usar algoritmos robustos (AES-256, bcrypt), TLS em tudo |
343| 3 | **Injection** | SQL, NoSQL, OS command injection | Consultas parametrizadas, validacao de entradas |
344| 4 | **Insecure Design** | Arquitetura com falhas | Threat modeling, secure design patterns |
345| 5 | **Security Misconfiguration** | Credenciais padrao, buckets cloud abertos | Padroes reforçados, auditorias automatizadas de configuracao |
346| 6 | **Vulnerable Components** | CVEs conhecidas em dependencias | Varredura SCA, atualizacoes regulares |
347| 7 | **Auth Failures** | Senhas fracas, sessoes comprometidas | MFA, rate limiting, gestao segura de sessoes |
348| 8 | **Data Integrity Failures** | Atualizacoes nao assinadas, CI/CD nao confiavel | Code signing, SBOM, integridade da pipeline |
349| 9 | **Logging Failures** | Sem trilha de auditoria | Logging estruturado, alertas sobre anomalias |
350| 10 | **SSRF** | Server-side request forgery | Allowlist de URLs de saida, validacao de entradas |
351~
352## Workflow completo de seguranca com GitHub Actions
353~
354Um workflow completo e pronto para producao que combina tudo o que foi visto acima:
355~
356```yaml
357# .github/workflows/security.yml
358name: Security Pipeline
359on:
360  pull_request:
361    branches: [main]
362  push:
363    branches: [main]
364~
365permissions:
366  contents: read
367  security-events: write
368~
369jobs:
370  secrets-scan:
371    name: Secret Detection
372    runs-on: ubuntu-latest
373    steps:
374      - uses: actions/checkout@v4
375        with:
376          fetch-depth: 0
377      - uses: gitleaks/gitleaks-action@v2
378        env:
379          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
380~
381  sast:
382    name: Static Analysis (SAST)
383    runs-on: ubuntu-latest
384    steps:
385      - uses: actions/checkout@v4
386      - uses: semgrep/semgrep-action@v1
387        with:
388          config: p/owasp-top-ten p/typescript p/nodejs
389~
390  dependency-audit:
391    name: Dependency Scan (SCA)
392    runs-on: ubuntu-latest
393    steps:
394      - uses: actions/checkout@v4
395      - uses: actions/setup-node@v4
396        with:
397          node-version: 22
398      - run: npm ci
399      - run: npm audit --audit-level=high
400      - uses: snyk/actions/node@master
401        env:
402          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
403        with:
404          args: --severity-threshold=high
405        continue-on-error: true
406~
407  container-scan:
408    name: Container Scan
409    runs-on: ubuntu-latest
410    needs: [sast, dependency-audit]
411    steps:
412      - uses: actions/checkout@v4
413      - run: docker build -t app:${{ github.sha }} .
414      - uses: aquasecurity/trivy-action@master
415        with:
416          image-ref: app:${{ github.sha }}
417          severity: CRITICAL,HIGH
418          exit-code: '1'
419~
420  sbom:
421    name: SBOM Generation
422    runs-on: ubuntu-latest
423    needs: [container-scan]
424    steps:
425      - uses: actions/checkout@v4
426      - uses: anchore/sbom-action@v0
427        with:
428          format: spdx-json
429          output-file: sbom.spdx.json
430```
431~
432```mermaid
433graph TD
434    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 --> S4
439    S4 --> S5[SBOM Generation]
440    S5 --> Deploy[Deploy]
441~
442    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```
447~
448## Metricas a monitorar
449~
450Como saber se o seu programa DevSecOps esta funcionando? Monitore estas metricas:
451~
452- **Mean time to remediate (MTTR)**: a rapidez com que voce corrige vulnerabilidades apos a detecao
453- **Vulnerability escape rate**: porcentagem de vulnerabilidades que chegam a producao
454- **False positive rate**: muitos falsos positivos levam a fadiga de alertas e avisos ignorados
455- **Dependency freshness**: idade media das suas dependencias (mais antigas = mais probabilidade de CVEs conhecidas)
456- **SBOM coverage**: porcentagem de projetos com SBOMs atualizadas
457~
458## Para comecar: um roteiro pratico
459~
460Nao tente implementar tudo de uma vez. Uma abordagem gradual funciona melhor:
461~
462```mermaid
463flowchart TD
464    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]
467~
468    A --> A1[Add Gitleaks pre-commit hooks]
469    A --> A2[Enable npm audit in CI]
470    A --> A3[Add .gitignore for .env files]
471~
472    B --> B1[Add Semgrep to GitHub Actions]
473    B --> B2[Add Snyk dependency scanning]
474    B --> B3[Set up SARIF upload to GitHub]
475~
476    C --> C1[Add Trivy container scanning]
477    C --> C2[Harden Dockerfiles]
478    C --> C3[Generate SBOMs]
479~
480    D --> D1[Secret manager integration]
481    D --> D2[Runtime protection - DAST]
482    D --> D3[Policy as code - OPA]
483```
484~
485## Conclusao
486~
487DevSecOps nao e sobre adicionar mais ferramentas a sua pipeline  -  e sobre tornar a seguranca uma parte natural de como voce constroi software. O objetivo nao e bloquear cada PR com avisos de seguranca, mas dar aos desenvolvedores feedback rapido para que possam corrigir os problemas enquanto o codigo ainda esta fresco na mente.
488~
489Comece com o basico: pre-commit hooks para secrets, dependency scanning na CI e container scanning para imagens Docker. Depois itere com base nas necessidades da sua equipe.
490~
491Seguranca nao e uma funcionalidade que se entrega uma unica vez. E uma pratica que se integra em cada commit.
492~
493> **Checklist inicial DevSecOps:**
494>
495> - [x] Pre-commit hooks Gitleaks instalados
496> - [x] Arquivos .env e secrets no .gitignore
497> - [x] Semgrep SAST na pipeline CI
498> - [x] Snyk ou npm audit para dependency scanning
499> - [x] Trivy para varredura de imagens de containers
500> - [x] Usuario nao-root nos Dockerfiles
501> - [x] Secrets em variaveis de ambiente ou secret manager
502> - [x] Geracao de SBOM em cada release
503> - [x] Conhecimento do OWASP Top 10 em toda a equipe
504~