Como a entrada altera o comando
A injeção de argumentos é uma falha que permite usar uma entrada externa para modificar os argumentos ou as opções de um comando chamado pela aplicação. Um valor recebido como nome de arquivo pode ser interpretado como uma opção do programa, mudando a ação executada.
A separação dos argumentos interfere nesse resultado. Ao montar uma única string, a aplicação pode permitir que delimitadores criem argumentos adicionais. Uma lista de argumentos preserva essa separação, mas a interpretação de cada valor continua a cargo do programa chamado.
Um valor tratado como opção no Node.js
A função execFile do Node.js executa um programa diretamente, sem shell por padrão. O exemplo didático abaixo chama a versão GNU do cat, uma ferramenta que escreve o conteúdo de arquivos na saída padrão:
import { execFile } from 'node:child_process';
const nomeRecebido = '--help';execFile('cat', [nomeRecebido], (erro, saida) => { if (erro) throw erro; console.log(saida);});A entrada --help faz o GNU cat imprimir suas instruções de uso na saída padrão. O programa interpreta o valor recebido como uma opção, embora a aplicação esperasse fornecer um nome de arquivo. Esse exemplo altera o comportamento do próprio cat sem executar um segundo comando.
Nesse programa, ['--', nomeRecebido] encerra a leitura de opções antes do nome. Com essa lista, o cat tenta abrir um arquivo chamado --help e informa erro caso ele não exista. Você precisa confirmar essa sintaxe no programa utilizado e restringir os arquivos acessíveis, pois o separador não controla as permissões de leitura.
Dúvidas frequentes
Perguntas frequentes sobre Argument injection
- A injeção de argumentos exige um segundo comando?
- A alteração pode ocorrer nas opções do próprio programa chamado. O efeito depende das funções que essas opções permitem executar.
- Uma lista de argumentos elimina essa falha?
- A lista preserva a separação entre os argumentos, mas o programa chamado ainda pode interpretar um valor iniciado por hífen como uma opção.
- O separador -- protege qualquer chamada?
- Ele encerra a leitura de opções nos programas que documentam esse comportamento. Você ainda precisa validar os valores e as permissões necessárias para a tarefa.
Para continuar
Recursos relacionados
Documentação
MITRE: CWE-88 e delimitadores de argumentos
A CWE-88 descreve falhas na separação de argumentos, suas consequências e formas de validar as entradas aceitas.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
A sessão de Desenvolvimento Colaborativo permite revisar ao vivo as chamadas de comandos e os testes das entradas aceitas pela aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao integrar comandos ao código, você precisa conferir como cada programa interpreta os valores recebidos pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.