Carregando
0xB0Lição 12 de 14

Mantendo os projetos seguros

Proteja contas, dependências, secrets e workflows com 2FA, Dependabot, varredura de secrets, varredura de código, rulesets e Actions blindadas.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Proteger contas com autenticação de dois fatores e passkeys
  • Usar o Dependabot, a varredura de secrets com push protection e a varredura de código
  • Blindar branches com rulesets e workflows com actions fixadas e menor privilégio

Um jogo open source pode não parecer um alvo, mas os atacantes adoram repositórios populares: comprometa um e você consegue distribuir malware para todo mundo que o instala. A aba Security do GitHub reúne as defesas:

RecursoProtege contra
Autenticação de dois fatores / passkeysuma senha roubada tomando a conta de um mantenedor
Alertas do Dependabotdependências com vulnerabilidades conhecidas (do GitHub Advisory Database)
Atualizações do Dependabotficar para trás - ele abre PRs que atualizam dependências vulneráveis ou desatualizadas
Varredura de secrets + push protectiontokens e chaves commitados; o push protection bloqueia o push antes de o secret chegar
Varredura de código (CodeQL)vulnerabilidades no seu próprio código, como injeção de SQL, sinalizadas nos PRs
Proteção de branch / rulesetscódigo não revisado ou não testado chegando na main, force pushes, histórico apagado
SECURITY.md + relato privado de vulnerabilidadespesquisadores anunciando uma vulnerabilidade publicamente antes da correção
.github/dependabot.yml
1version: 2
2updates:
3  - package-ecosystem: pip
4    directory: "/"
5    schedule:
6      interval: weekly
7  - package-ecosystem: github-actions   # keep the actions in workflows up to date too
8    directory: "/"
9    schedule:
10      interval: weekly

Blindando o GitHub Actions

Os workflows rodam código com acesso aos seus secrets e ao seu repositório, então são um alvo favorito. O essencial:

  • Fixe as actions de terceiros no SHA completo de um commit: uses: some/action@8f4b7f84... em vez de @v2. As tags podem ser movidas para apontar para código malicioso - isso já aconteceu. (Acrescente a versão como comentário; o Dependabot ainda consegue atualizar SHAs fixados.)
  • Menor privilégio: defina permissions: no topo de todo workflow, começando por contents: read.
  • Cuidado com pull_request_target: ele roda com secrets e acesso de escrita no contexto do repositório base, mesmo para PRs vindos de forks. Nunca faça checkout do código do PR e o execute nele.
  • Não interpole entradas não confiáveis em scripts: run: echo "${{ github.event.issue.title }}" deixa qualquer pessoa que abra uma issue injetar comandos de shell. Passe o valor por uma variável de ambiente.

Experimente

Até 15 XP

Audite este workflow

Um contribuidor propôs este workflow para dar boas-vindas a quem abre a primeira issue. Clique em cada linha que é um problema de segurança e depois veja o que deixou passar.

.github/workflows/welcome.yml (rodada 1 de 1)Sinais encontrados 0/0

Clique em todos os trechos suspeitos. São 4.

name: Welcome on: issues: types: [opened] permissions: write-all jobs: greet: runs-on: ubuntu-latest steps: - uses: cool-bots/greeter@main - run: echo "Thanks for ${{ github.event.issue.title }}!" - run: curl -H "Authorization: ${{ secrets.ADMIN_TOKEN }}" https://stats.example.com/new-issue
the safe version
1name: Welcome
2on:
3  issues:
4    types: [opened]
5permissions:
6  issues: write
7jobs:
8  greet:
9    runs-on: ubuntu-latest
10    steps:
11      - uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea  # v7.0.1
12        env:
13          TITLE: ${{ github.event.issue.title }}
14        with:
15          script: |
16            await github.rest.issues.createComment({
17              ...context.repo,
18              issue_number: context.issue.number,
19              body: `Thanks for reporting "${process.env.TITLE}"! A maintainer will take a look.`,
20            })

Principais conclusões

  • Ative o 2FA (ou passkeys) - as contas dos mantenedores são as chaves das instalações de todo mundo.

  • Os alertas e as atualizações do Dependabot cuidam das dependências vulneráveis; a varredura de secrets com push protection barra tokens vazados.

  • Rulesets e proteção de branch mantêm código não revisado e não testado fora da main.

  • Blinde os workflows: fixe as actions em SHAs, use permissões de menor privilégio e nunca interpole entradas não confiáveis em scripts.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: automatize tarefas do GitHub com Python

O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.

Exercício 1

Audite as actions

+25 XP

A entrada é um arquivo de workflow. Encontre cada referência uses: e classifique-a, imprimindo owner/repo@ref: CATEGORY em ordem:

  • local - começa com ./
  • docker - começa com docker://
  • pinned - a ref é o SHA completo de um commit, com 40 caracteres hexadecimais
  • trusted tag - uma tag ou branch não fixada numa action cujo dono é actions ou github
  • UNPINNED - qualquer outra action de terceiros numa tag ou branch

Por fim, imprima N unpinned third-party actions (ou all clear) - e permissions: missing se o arquivo não tiver chave permissions: nenhuma.

  • O workflow de boas-vindas
  • Blindado
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Faça a triagem dos alertas do Dependabot

+25 XP

Cada linha de entrada é um alerta em JSON: {"package": ..., "severity": "critical"|"high"|"medium"|"low", "vulnerable": "<2.3.4", "fixed_in": "2.3.4"|null, "state": "open"|"dismissed"|"fixed"}. Só para os alertas abertos, imprima-os do mais grave para o menos grave (empates pelo nome do pacote) como CRITICAL pillow: update to 10.3.0 ou HIGH tinyparse: no fix yet e depois um resumo open: 1 critical, 2 high, 0 medium, 0 low.

  • Esta semana
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…