auditoria-seguranca
Skill1 starsChanged 32 days agoMITView on GitHub
Auditoria e endurecimento de segurança de projetos web com Supabase (Postgres + RLS + Storage + Edge Functions) e front React/Vite/Next na Vercel. Use quando o usuário pedir "auditoria de segurança", "ver se está vazando dado", "revisar segurança", "RLS", "policy", "página pública segura", "link com token", "proteger dados de clientes", "posso colocar em produção?", ou quiser aplicar as correções de segurança de um projeto em outro. Roteiro em fases (só leitura → evidência → plano → correção aprovada → verificação), com consultas SQL, scripts de teste como visitante, catálogo de ~40 classes de falha e o padrão de correção de cada uma.
- Reads credentials
1 other project uses a version of this.
Adopted by
Most recently taken up by
- victorbeppler/claude-bootstraptheir own version, first seen Nov 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- victorbeppler/claude-bootstrap★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 45
Nada de dado real em testes: use tokens falsos (00000000-0000-4000-8000-000000000000) e dados fictícios.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Auditoria de segurança (Supabase + front)
Você vai conduzir uma auditoria de segurança com evidência, no projeto aberto, seguindo este roteiro.
O material completo (explicado para leigos e com o detalhe técnico) está em GUIA_COMPLETO.md, nesta mesma
pasta. Leia as partes que a fase pedir; não precisa ler tudo de uma vez.
Arquivos desta skill:
GUIA_COMPLETO.md: conceitos, roteiro detalhado, catálogo de falhas (com "como achar / como corrigir / como confirmar / armadilha"), publicação segura, padrões de desenho, incidentes reais, checklist final.referencias/consultas.sql: todas as consultas de diagnóstico (só leitura).referencias/padroes-correcao.sql: modelos de migration (revoke/grant, policies, travas, blocos de verificação).referencias/pecas-de-codigo.md: código pronto para Edge Functions e front (autorização, link assinado, CORS, IP e limite de tentativas, HTML seguro, storage privado, webhook, links seguros).referencias/ferramentas.md: as skills e ferramentas (Claude Security, /security-review, find-bugs, 007, supabase, rea, advisors) e os equivalentes para quem não usa Claude.scripts/: teste do visitante, conferência de endpoints com tokens falsos,deno checkem todas as funções, busca de segredos.
Skills e ferramentas complementares
Esta skill funciona sozinha. Se estas estiverem instaladas, use-as junto (detalhes em referencias/ferramentas.md):
supabase e supabase-postgres-best-practices (antes de escrever migration/policy), 007 (modelagem de ameaças e
veredito), find-bugs e /security-review (revisar o diff antes de publicar), plugin Claude Security (varredura
independente com painel de verificadores), reverse-engineer-anything / MCP rea (capturar o tráfego de páginas).
Se faltarem, siga sem elas e sugira ao usuário o instalador instalar.sh do repositório da skill.
Regras que valem a auditoria inteira
- Primeiro só leitura. Não altere banco, edge function, storage, segredos nem config sem aprovação explícita do usuário. Diagnóstico e plano vêm antes.
- Evidência sempre. Todo achado traz
arquivo:linhaou a consulta + o resultado. Achado grave é verificado no código e, quando possível, no banco ao vivo antes de ser reportado como fato. - O banco ao vivo é a verdade. Dumps, fotos de schema e migrations antigas podem não bater com produção.
Consulte o catálogo (
pg_policies,pg_proc,has_function_privilege,storage.buckets). - Teste com papel errado. Prove o que vaza chamando a API como visitante (só a chave pública), como
funcionário sem permissão e como bloqueado. Distinga "protegido" (erro 42501/401/403) de "vazio" (
[]numa tabela sem dados não prova nada). - Nunca rode
supabase config push(aplica oconfig.tomlinteiro sem perguntar e já derrubou o login de vários apps). Nunca teste envio em lote (WhatsApp, e-mail) contra produção. Nunca imprima o.env. - Nada de dado real em testes: use tokens falsos (
00000000-0000-4000-8000-000000000000) e dados fictícios; ensaios de escrita em transação desfeita (begin; ... rollback;). - Explique em linguagem simples. Para cada correção: como está hoje, como fica, o que pode afetar no app, como reverter. O usuário pode ser leigo.
- Se outras sessões/agentes mexem no mesmo repositório: não use
git stash,checkout -- .nemreset; faça commit só dos seus arquivos; confira o número da migration contra a maior existente; rode o--dry-rune confira que só aparecem as suas.
Princípios do veredito e da verificação
Valem junto com as regras acima (incorporados da cloudflare/security-audit-skill, 27/10/2026). Evitam reportar
desvio de checklist como se fosse furo:
- Três veredictos, não só "achei": cada candidato termina como confirmado (rastro completo da entrada até o impacto, com resultado observado e limitado), a validar (um fato exato ainda sem resolver, sem severidade — nunca vira "grave" sem prova) ou descartado (candidato derrubado, guardado com o porquê para não reabrir).
- Severidade = probabilidade × impacto, nunca "fugiu do checklist". Sem impacto demonstrável, não é alto.
- Defesa em profundidade é nota de endurecimento, não vulnerabilidade. Se outra camada já barra o ataque (ex.:
RLS + gatilho "mesmo salão" seguram um
updatepor id sem filtro de tenant no app), a camada que falta é melhoria, não furo — diga isso com todas as letras no relatório, sem inflar a severidade. - Quem confirma ≠ quem achou. Todo achado grave é verificado por um olhar/agente diferente do que o levantou (encaixa na orquestração). O verificador tenta derrubar o achado, não confirmá-lo.
- Cobertura explícita (lacuna ≠ limpo). Ao fim de cada fase, registre o que foi examinado e o que ficou de fora. "Não deu para olhar" nunca vira "está seguro"; um scanner que parou no meio (ex.: estourou o orçamento) é inconclusivo, não um atestado.
Roteiro (fases)
Siga a ordem. Ao fim de cada fase, resuma para o usuário o que achou (com evidência) antes de seguir.
Detalhes de cada fase: GUIA_COMPLETO.md, Parte 3.
- Preparar. Descubra a stack (front,
supabase/,vercel.json), qual projeto Supabase o site usa (.env,supabase/config.tomlsó para ler oproject_id), se o CLI está ligado (supabase projects list,supabase migration list --linked). Se o MCP do Supabase negar permissão, usesupabase db query --linked "<SQL>". Pergunte ao usuário o que é público de propósito (páginas sem login, links enviados a clientes) e se há dados reais no banco. - Inventário. Liste: tabelas, views, funções, buckets, edge functions (com
verify_jwtdesupabase/config.toml), rotas públicas do front, webhooks, crons (cron.job), segredos usados (Deno.env.get,import.meta.env). - Banco. Rode
referencias/consultas.sql(seções 1 a 8): RLS, policies abertas, grants, funçõesSECURITY DEFINERexecutáveis poranon/authenticated,search_path, views semsecurity_invoker, buckets e policies de storage, crons com chave escrita. Rode tambémsupabase db advisors --linked --type security. - Teste do visitante (empírico).
scripts/teste-visitante.mjs: com só a chave pública, tenta ler toda tabela/view, chama as funções estáveis sem argumento e lista os buckets. Marca respostas com CPF, e-mail, telefone e colunas sensíveis, sem imprimir valores. - Teste por perfil. Em transação desfeita, simule visitante, funcionário sem a permissão, funcionário
com a permissão, bloqueado, dono e servidor (
set local role+ claims). Teste leitura E escrita, inclusive escrita cruzada (o próprio id num parâmetro e o id alheio em outro). VerGUIA_COMPLETO.md3.4. - Edge functions. Para cada uma: quem pode chamar? (
verify_jwt=truenão é "logado": a chave pública passa.) Procure: falta de checagem, decisão pelo corpo (automatico: true), id de usuário vindo do corpo,service_roleusado antes de autorizar, segredo com valor de reserva, CORS*, IP do primeiro item dex-forwarded-for, limite que falha aberto, caminho de storage montado com dado do cliente, webhook sem assinatura. Rodescripts/deno-check-todas.sh. - Páginas públicas e links com token. Para cada rota pública: força do token (bits, gerador), validade,
revogação, limite de tentativas, resposta igual para "não existe"/"errado", o que a API entrega a mais do
que a tela mostra,
noindex, token em log/URL/Referer. Confira comscripts/conferir-endpoints.mjs(tokens falsos) e pelo navegador (F12 → Rede, Console, Aplicação, Fontes): sigaGUIA_COMPLETO.md, Parte 9, e peça ao usuário para repetir o teste em janela anônima se você não tiver um navegador (com o MCPrea, capture o tráfego com token falso). - Front. XSS (
dangerouslySetInnerHTML,document.write,innerHTML,<iframe src>/<a href>com valor do banco), segredos no bundle (VITE_/NEXT_PUBLIC_comservice_role), headers (vercel.json: CSP, HSTS, X-Frame-Options, Referrer-Policy),npm audit. - Segredos e histórico.
scripts/procurar-segredos.sh(código + histórico do git). Chave que já esteve no git precisa ser trocada, não só apagada. - Varredura independente (opcional, recomendada). Se o plugin Claude Security estiver instalado:
/claude-security:claude-security→ Scan codebase, escopo no servidor (supabase/), esforçomedium. Para um diff:/security-reviewou/find-bugs. Verreferencias/ferramentas.md. - Relatório e plano. Escreva o relatório (achados por severidade, evidência, impacto em linguagem
simples, correção proposta) e o plano em ordem de prioridade. Registre no
docs/do projeto. Não aplique nada.
Corrigindo (só depois da aprovação)
Siga GUIA_COMPLETO.md, Parte 5 (publicação segura). Resumo:
- Toda mudança de banco vira migration nova (número acima da maior existente), com cabeçalho
PROBLEMA / CORREÇÃO / QUEM USA / ORDEM / COMO REVERTER e um bloco
DOque falha se a correção não pegou. - Ensaie em transação desfeita;
supabase db push --linked --dry-run; só então aplique. - Antes de restringir uma função/policy, procure quem usa (front, edge functions, outras policies, gatilhos).
- Ordem: o código novo não pode chamar o que ainda não existe; o banco novo não pode quebrar o código que está no ar. Em geral: banco → funções → site; para fechar um caminho antigo: caminho novo → telas → publicar → fechar o antigo.
- Antes do push:
tsccom 0 erros numa cópia limpa do commit (o build da Vercel rodatsc; 1 erro derruba o site), testes,deno checknas funções alteradas. - Depois de publicar: confira de fora com tokens falsos (
scripts/conferir-endpoints.mjs) e no catálogo. - Segredo exposto: troque (rotação) e confira por hash, sem exibir o valor.
- Diga ao usuário o que NÃO foi testado (ex.: fluxo real no celular, WhatsApp real) e o que mudou por conta própria.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

