Imported from promovaweb/specsfy (
specialists/specsfy-specialist-application-security/SKILL.md). Install upstream withnpx skills add promovaweb/specsfy --skill specsfy-specialist-application-security. Copyright stays with the author.
Segurança de aplicações
Quando usar
- Acionar quando a mudança introduz ou toca trust boundary, identidade, entrada externa (upload, URL, query, deserialize) ou dado sensível.
- Acionar também antes de desenhar uma feature com superfície de ataque nova (novo endpoint público, nova integração, novo tipo de usuário) para fazer threat modeling preventivo.
- Não acionar como substituto de revisão de credenciais de pipeline/deploy:
usar
$specsfy-specialist-deliverypara isso; aqui o foco é a aplicação e seus dados, não a esteira de entrega. - Para modelar acesso por linha ou tenant, combine com
$specsfy-specialist-postgresse a stack confirmada usar PostgreSQL ou com$specsfy-specialist-supabasese usar Supabase. Para outras stacks, use o especialista da tecnologia confirmada quando houver.
No Specsfy
-
Fonte de entrada por fase
- Em
specsfy-02-backlog, leia o item emspecs/backlog/e registre ali as decisões e sinais do especialista, além das dúvidas abertas. - Em
specsfy-03-specifyespecsfy-04-validate, use a spec aberta e devolva a conclusão à seção trabalhada pela fase. - Em
specsfy-05-tasks, ajude a sugerir e sincronizar especialistas e modos entre o cabeçalho, a seção 8 e as tarefas. Só essa fase escreve a seção 14. - Em
specsfy-06-implement, limite-se à tarefa indicada e ao passo carregado.
Nas fases com spec, leia a spec aberta indicada pela skill chamadora ou localizada por
specsfy status. Consulte a linha| Especialistas |, a subseção#### Especialistasem### 8. Plano técnicoe a seção pertinente à fase. Leia também.specsfy/STACK.mde.specsfy/RULES.mde, quando a superfície for tela ou formulário,INTERFACE.md. - Em
-
Siga o modo indicado na spec ou na tarefa, no formato
Especialista: $specsfy-specialist-application-security. Sem indicação, confirme pelo "Quando usar" acima se a mudança cria trust boundary nova. -
Devolva a conclusão e as dúvidas abertas no destino indicado no item 1, no próprio backlog, na spec ou na tarefa da fase.
-
Não mude o estado da spec nem marque gate: isso pertence a
$specsfy-03-specify,$specsfy-04-validate,$specsfy-05-taskse$specsfy-06-implement. -
Quando a fase trabalhar a spec, registre ameaça e controle em
### 7. Requisitose o teste negativo em### 12. Plano de testes e rastreabilidade, conforme a seção em trabalho. Registre exposição residual com owner e sinal de observabilidade.
Fluxo
- Mapear ativos, atores, trust boundaries, entradas externas e efeitos (o que muda de estado) antes de pensar em controle.
- Definir ameaças plausíveis e seu impacto real antes de escolher controles, não implementar defesa para uma ameaça que não existe no contexto do sistema.
- Verificar autenticação, autorização por objeto (não só por rota) e separação de tenants em toda operação que lê ou muta dado.
- Validar toda entrada pelo tipo, tamanho e destino esperado; normalizar saída conforme o contexto de renderização; proteger operações mutáveis contra replay e CSRF quando aplicável.
- Revisar gestão de secrets, criptografia em trânsito e em repouso, ciclo de vida de sessão, dependências vulneráveis e configuração de produção.
- Materializar testes positivos (fluxo autorizado funciona) e negativos (fluxo não autorizado falha) nos boundaries críticos identificados.
- Registrar a exposição que permanece, owner, sinal de observabilidade associado e plano de resposta: nenhum sistema fica "100% seguro", apenas com falhas possíveis conhecidas e monitoradas.
Padrões
- Negar por padrão e conceder o menor privilégio necessário para cada identidade e operação.
- Autorizar no servidor em toda operação e em todo objeto acessado, nunca confiar em uma verificação apenas client-side ou em um ID de objeto vindo do cliente sem revalidar propriedade/tenant.
- Tratar upload de arquivo, URL fornecida pelo usuário, template renderizado com dado externo, query dinâmica e deserialização de dado externo como entradas hostis por padrão.
- Não implementar criptografia própria; usar primitivas e bibliotecas estabelecidas. Nunca logar segredo, token, senha ou dado sensível, mesmo em ambiente de debug.
- Rotacionar credencial estática por compromisso, troca de tecnologia ou política do provedor, e preferir identidade temporária (tokens de curta duração, STS/OIDC) a segredo estático de longa duração. Troca periódica obrigatória de senha memorizada não é recomendada por NIST SP 800-63B nem por OWASP: empurra o usuário para padrões previsíveis e não cobre o vazamento que já aconteceu.
- Mitigar abuso com limites por ator e por recurso (rate limit por usuário/ API key/tenant), não apenas por IP: um IP compartilhado (NAT, proxy) penaliza usuários legítimos e um atacante distribuído contorna limite só por IP.
- Ao corrigir uma vulnerabilidade, corrigir a causa raiz e adicionar teste de regressão, sem divulgar detalhe de exploração além do necessário para quem precisa corrigir ou validar.
Antipadrões
- Verificar autorização apenas pela rota (
/admin/*protegido) sem verificar o objeto específico acessado dentro da rota: um usuário autenticado como tenant A consegue acessar/api/orders/123de um tenant B só trocando o ID na URL (IDOR, Insecure Direct Object Reference). - Validar entrada só no client (JavaScript no navegador) sem revalidar no servidor: qualquer requisição direta à API contorna completamente a validação client-side.
- Confiar em
Content-Typeou extensão de arquivo declarados pelo cliente para decidir como processar um upload: permite disfarçar um arquivo malicioso como um tipo inofensivo. - Guardar segredo de aplicação (chave de API, senha de banco) em variável de ambiente sem controle de acesso ao processo/log, ou logar o payload completo de uma requisição que contém token de autenticação: o segredo vaza por um canal indireto mesmo com o "cofre" correto na origem.
- Anunciar "sistema seguro" ou "vulnerabilidade corrigida" sem teste negativo específico comprovando que o vetor original não funciona mais.
Validação
- Casos de teste negativos: acesso sem autenticação, com identidade errada, com tenant errado e replay de uma requisição já processada, todos devem falhar de forma controlada.
- Análise de dependências vulneráveis e varredura de secrets vazados com as ferramentas já adotadas pelo projeto, executada como parte do fluxo normal, não apenas manualmente antes de um release grande.
- Configuração segura de produção: headers de segurança (ex.:
Content-Security-Policy,Strict-Transport-Security), atributos de cookie (HttpOnly,Secure,SameSite, lembrando queSameSite=NoneexigeSecure) e política de CORS restrita à origem realmente necessária. - Comprovação concreta de cada controle reivindicado e da exposição que permanece, nunca declarar algo "seguro" em linguagem absoluta sem o teste que comprova. (regra da casa)
Skills relacionadas
$specsfy-specialist-servere$specsfy-specialist-dockerimplementam hardening de host, container e runtime; esta skill define ameaça, privilégio e controle que a configuração precisa provar.$specsfy-specialist-laravel,$specsfy-specialist-nextjse$specsfy-specialist-ui-componentsimplementam superfícies de aplicação; autorização, validação server-side e exposição de dados permanecem aqui.$specsfy-specialist-code-reviewaplica a revisão ampla e$specsfy-specialist-observabilityregistra sinais de abuso sem vazar dados sensíveis.$specsfy-specialist-postgresou$specsfy-specialist-supabasepara autorização por linha ou tenant no nível de dado (RLS, constraints), conforme a tecnologia confirmada na stack.$specsfy-specialist-deliverypara hardening de credenciais de pipeline, assinatura de artefato e supply chain.$specsfy-specialist-architecturequando a exposição vem do desenho do contrato de API (verbos, versionamento, exposição de campo sensível).$specsfy-specialist-mysqle$specsfy-specialist-mongodbmaterializam usuário, privilégio e TLS do banco; ameaça e autorização continuam aqui.$specsfy-specialist-n8nquando webhook, credencial e variável de ambiente do fluxo entram na superfície de ataque.$specsfy-specialist-mcppara autorização por operação e por objeto em servidores MCP; a ameaça e o controle continuam decididos aqui.$specsfy-specialist-cloudflarepara WAF, rate limiting, Access e Tunnel: a política de borda materializa o controle de acesso decidido aqui.
Leia references/standards.md para checklist de threat modeling por boundary, ASVS, segurança de API e supply chain, com fontes primárias.
