Command Injection in PHP

Learn how to fix Command Injection (CWE-78) in PHP. Side-by-side vulnerable vs secure code examples for proc_open(), escapeshellarg(), and shell_exec hazards.

💡 Explicação em Linguagem Simples (ELI5)

Imagine pedir a um assistente de escritório para imprimir um documento chamado 'relatorio.pdf'. A injeção de comando ocorre quando alguém fornece o nome 'relatorio.pdf; whoami', e o assistente entrega o bilhete inteiro ao terminal, fazendo-o imprimir o relatório e ler o crachá de administrador.

Conceitos Centrais e Termos

Web Application Security: Componente de arquitetura principal afetado pelo CWE-918.
CWE-918: Classificação padrão Common Weakness Enumeration (CWE) para command-injection-php.
Defense-in-Depth: Verificação de engenharia em múltiplas camadas e isolamento de limites em tempo de execução.

Fluxo de Ataque Passo a Paso

Step 1

Ingestão de Parâmetros Não Confiáveis

O aplicativo aceita nomes de host diagnósticos, nomes de arquivo ou flags diretamente de uma requisição HTTP ou formulário de usuário.

Step 2

Interpolação de Shell Não Higienizada

O backend constrói uma string de comando shell usando concatenação direta ou formatação em vez de um vetor de argumentos separado.

Step 3

Injeção de Separador de Comandos

O invasor injeta metacaracteres shell como ';', '&&', '|' ou crases (ex: '127.0.0.1; id') para quebrar o contexto pretendido do comando.

Step 4

Execução em Subshell e Comprometimento

O shell do sistema operacional executa o comando anexado com todos os privilégios do processo web em execução.

Código-Fonte: Vulnerável vs. Seguro

✕ IMPLEMENTAÇÃO VULNERÁVEL

<?php
// shell_exec with string concatenation
$ip = $_GET['ip'];
// Attacker input: "127.0.0.1 && cat /etc/shadow"
$output = shell_exec("ping -c 1 " . $ip);
echo $output;
?>

✓ PATCH SEGURO E ROBUSTO

<?php
// escapeshellarg escapes quotes and metacharacters
$ip = $_GET['ip'];

// Validate format first
if (!filter_var($ip, FILTER_VALIDATE_IP)) {
    die("Invalid IP address");
}

// Ensure argument is escaped and isolated
$safe_ip = escapeshellarg($ip);
$output = shell_exec("ping -c 1 " . $safe_ip);
echo htmlspecialchars($output);
?>

Lista de Verificação de Segurança para Engenharia

✓Prática recomendada de segurança: Strictly validate inputs with type checkers (e.g. FILTER_VALIDATE_IP).
✓Prática recomendada de segurança: Always wrap arguments with escapeshellarg().
✓Desative ou restrinja dangerous functions in php.ini: disable_functions = exec,system,shell_exec,passthru.