arcanum-sec/spikestripDecoys de prompt reversíveis em HTML e JavaScript com chaves opacas por inserção.
[!WARNING]
Este projeto está em desenvolvimento.
O SpikeStrip tem como objetivo fornecer inspiração para pessoas que constroem defesas contra ferramentas de automação de IA, como o ARTEX e sistemas semelhantes. Seus chamarizes e prompts de geração são experimentais.
O SpikeStrip adiciona chamarizes de prompt reversíveis ao código-fonte HTML e a arquivos JavaScript. Os comentários incluem instruções que redirecionam uma avaliação de IA, pistas falsas de vulnerabilidade e distrações matemáticas. Eles podem desviar agentes que seguem comentários no código-fonte ou transformar dicas não verificadas em alvos de varredura. Um scanner convencional precisaria extrair os caminhos ou parâmetros sugeridos para que esses comentários afetassem seu trabalho. A ferramenta não impede de forma confiável agentes que isolam conteúdo não confiável nem scanners que ignoram comentários.
Cada inserção recebe uma chave hexadecimal aleatória de 12 caracteres, como a7c94e2b610f. As chaves são verificadas quanto a duplicatas em cada execução. Os comentários implantados não têm a marca SpikeStrip nem um prefixo canário fixo. Comentários HTML aparecem em Exibir código-fonte; comentários JavaScript ficam visíveis quando alguém busca o script. Os comentários não adicionam callbacks, loops executáveis nem computação em tempo de execução. Três chamarizes de referência/pausa integrados usam uma redação neutra de revisão.
O manifesto privado registra cada comentário e sua chave. Use-o para remover comentários selecionados depois que os números de linha mudarem. A lista original de dez entradas permanece em src/payloads.mjs como originalPayloads e contém exatamente 100 palavras. O conjunto padrão agora tem 28 entradas, incluindo 18 chamarizes de instrução adicionais e pistas falsas de vulnerabilidade. As tarefas matemáticas originais incluem problemas em aberto, contradições e tarefas infinitas; não se comprovou que todas sejam insolúveis.
As pistas falsas nomeiam rotas e parâmetros inventados para SSRF, injeção de SQL, injeção de template do lado do servidor, XSS baseado em DOM, XXE, path traversal e verificações de autorização de objetos. Alguns comentários afirmam que um caminho desativado usa um produto afetado por Log4Shell (CVE-2021-44228), Spring Cloud Gateway CVE-2022-22947 ou Apache HTTP Server CVE-2021-41773. Os identificadores CVE são reais; os caminhos e as implantações alegadas são fabricados. Esses comentários não criam rotas, handlers vulneráveis nem requisições de rede. Revise os nomes propostos em relação à sua aplicação antes de implantá-los, pois um caminho inventado pode coincidir com uma rota real.
O SpikeStrip está disponível sob a Licença MIT, com direitos autorais detidos pela Arcanum. Você pode usar, modificar, distribuir e vender cópias, inclusive em produtos comerciais, desde que mantenha os avisos de direitos autorais e de permissão em cópias ou partes substanciais do software. A licença não exige crédito promocional público para cada uso comercial.
O SpikeStrip requer Node.js 20 ou mais recente. Execute estes comandos a partir deste repositório.
npm install --ignore-scripts
node bin/spikestrip.mjs --help
Como alternativa, use pnpm install --frozen-lockfile --ignore-scripts com o lockfile versionado. O pacote é privado e não se destina à publicação no npm.
Execute a ferramenta contra a raiz web estática compilada, após a minificação e antes da implantação. Os diretórios de origem e de saída devem ser separados, sem que nenhum esteja dentro do outro. A cópia de saída inclui os recursos comuns e os arquivos modificados. A ferramenta deixa os originais intactos e exclui symlinks, metadados de VCS, diretórios de dependências, pastas de manifesto privadas e arquivos de ambiente.
# This preview validates inputs and writes nothing.
node bin/spikestrip.mjs inject ./site --output ./site-planted --count 20 --manifest ./private/run.json
# Apply the plan to a new copy.
node bin/spikestrip.mjs inject ./site --output ./site-planted --count 20 --manifest ./private/run.json --write
--count é o número total de inserções em toda a árvore. O posicionamento, a seleção de payload e as chaves usam a aleatoriedade do SO. As pré-visualizações e gravações subsequentes podem escolher posições e chaves diferentes. Cada inserção recebe sua própria chave, mesmo quando o texto embutido se repete. Se nenhum caminho de manifesto for fornecido, um é criado em .spikestrip/ ao lado do diretório de saída. Mantenha essa pasta privada e fora do site implantado.
A ferramenta suporta arquivos .html, .htm, .js, .mjs e .cjs. Ela usa os limites de instrução do Acorn para posicionar comentários JavaScript e, em seguida, verifica se a árvore de sintaxe é equivalente. Os comentários HTML vão antes dos filhos diretos de elementos head ou body explícitos. Uma verificação da árvore do documento rejeita alterações além dos comentários.
A ferramenta não insere em strings de atributos, texto bruto, templates, corpos de script inline ou conteúdo de texto. Ela ignora e relata fragmentos sem head/body explícitos, JavaScript inválido, arquivos JSX/TypeScript não suportados e arquivos de origem com mais de 2 MB. Ela também relata arquivos de origem suportados que não têm posições de inserção seguras. Esses arquivos de origem são copiados sem alteração.
Use --raw se você quiser um arquivo de texto de comentários para espalhar no seu código-fonte web por conta própria. Esta opção não precisa de um diretório de site e não insere nada nos seus arquivos nem copia uma árvore de build. Ela oferece uma alternativa quando você não quer uma ferramenta de inserção no seu pipeline de build.
# Preview an export without creating a file.
node bin/spikestrip.mjs inject --raw --output ./comments.txt --count 30
# Export JavaScript/CSS block comments, with one comment per line.
node bin/spikestrip.mjs inject --raw --output ./comments.txt --format js --count 30 --write
# Export HTML/SVG comments instead.
node bin/spikestrip.mjs inject --raw --output ./html-comments.txt --format html --count 30 --write
Cada comentário exportado tem sua própria chave aleatória de 12 caracteres. O formato padrão é js; --format html altera o wrapper. Escolha um formato por exportação e coloque comentários apenas onde esse tipo de arquivo permite comentários. Arquivos de saída existentes nunca são sobrescritos. Exportações brutas aceitam contagens de 1 a 10.000 para built-ins e de 1 a 1.000 com --dynamic.
Exportações brutas não criam manifesto de remoção porque o SpikeStrip não sabe onde você cola os comentários. Mantenha o arquivo de texto como seu inventário de chaves e pesquise por essas chaves para remover os comentários manualmente. O comando remove lida com inserções automáticas registradas em um manifesto; ele não consegue descobrir posicionamentos manuais a partir de um arquivo de texto bruto. Não passe um diretório de origem nem --manifest com --raw.
As mesmas flags de geração funcionam com exportações brutas. Por exemplo, após definir OPENAI_API_KEY, execute node bin/spikestrip.mjs inject --raw --output ./unique-comments.txt --format js --dynamic --provider openai --model YOUR_MODEL_ID --count 40 --write. Uma pré-visualização ainda não faz nenhuma requisição à API.
Adicione --mode artex para selecionar 16 decoys projetados em torno dos forks públicos do ARTEX estudados em as notas de pesquisa. O perfil inclui caminhos de API entre aspas, chunks de arquivo fabricados, entradas de mapa de rotas, handoffs de worker para planner, desvios de revisão de tráfego e referências de resumo com chave. O padrão --mode generic mantém o pool misto original.