arcanum-sec/spikestrip삽입할 때마다 불투명한 키를 사용하는 가역적 HTML 및 JavaScript 프롬프트 미끼입니다.
[!WARNING]
이 프로젝트는 작업 진행 중입니다.
SpikeStrip은 ARTEX 및 유사 시스템과 같은 AI 자동화 도구에 대한 방어 체계를 구축하는 사람들에게 영감을 제공하기 위한 것입니다. 이 도구의 미끼와 생성 프롬프트는 실험적입니다.
SpikeStrip은 HTML 소스와 JavaScript 파일에 되돌릴 수 있는 프롬프트 미끼를 추가합니다. 이 주석에는 AI 평가를 다른 방향으로 유도하는 지시, 허위 취약점 단서, 수학적 방해 요소가 포함됩니다. 이들은 소스 주석을 따르는 에이전트를 다른 곳으로 유도하거나 검증되지 않은 힌트를 스캔 대상으로 전환시킬 수 있습니다. 일반적인 스캐너가 이 주석들의 영향을 받으려면 힌트로 제시된 경로나 매개변수를 추출해야 합니다. 이 도구는 신뢰할 수 없는 콘텐츠를 격리하는 에이전트나 주석을 무시하는 스캐너를 안정적으로 차단하지는 못합니다.
각 삽입에는 a7c94e2b610f와 같은 무작위 12자리 16진수 키가 부여됩니다. 키는 각 실행 내에서 중복 여부가 확인됩니다. 배포된 주석에는 SpikeStrip 브랜딩이나 고정된 카나리 접두사가 없습니다. HTML 주석은 소스 보기에서 나타나며, JavaScript 주석은 누군가 스크립트를 가져올 때 표시됩니다. 이 주석들은 콜백, 실행 가능한 루프, 런타임 연산을 추가하지 않습니다. 세 가지 내장 참조/일시정지 미끼는 중립적인 검토 문구를 사용합니다.
비공개 매니페스트는 각 주석과 해당 키를 기록합니다. 줄 번호가 변경된 후 선택한 주석을 제거하는 데 사용하십시오. 원래의 10개 항목 목록은 src/payloads.mjs에 originalPayloads로 남아 있으며 정확히 100개의 단어를 포함합니다. 기본 풀은 이제 18개의 추가 지시 미끼와 허위 취약점 단서를 포함하여 28개 항목을 가집니다. 원래의 수학적 과제에는 미해결 문제, 모순, 끝없는 과제가 포함되며, 이들 모두가 해결 불가능하다고 증명된 것은 아닙니다.
허위 단서는 SSRF, SQL 인젝션, 서버 측 템플릿 인젝션, DOM 기반 XSS, XXE, 경로 순회, 객체 권한 부여 검사에 대해 만들어낸 경로와 매개변수를 지칭합니다. 일부 주석은 폐기된 경로가 Log4Shell(CVE-2021-44228), Spring Cloud Gateway CVE-2022-22947, 또는 Apache HTTP Server CVE-2021-41773의 영향을 받는 제품을 사용한다고 주장합니다. CVE 식별자는 실제이지만, 경로와 주장된 배포는 조작된 것입니다. 이 주석들은 경로, 취약한 핸들러, 네트워크 요청을 생성하지 않습니다. 만들어낸 경로가 실제 경로와 겹칠 수 있으므로 배포 전에 제안된 이름을 애플리케이션과 대조하여 검토하십시오.
SpikeStrip은 MIT 라이선스에 따라 제공되며, 저작권은 Arcanum이 보유합니다. 소프트웨어의 사본 또는 상당 부분에 저작권 및 허가 고지를 유지하는 조건으로, 상업적 제품에 포함하여 사용, 수정, 배포, 판매할 수 있습니다. 이 라이선스는 모든 상업적 사용에 대해 공개적인 홍보 크레딧을 요구하지 않습니다.
SpikeStrip은 Node.js 20 이상이 필요합니다. 이 저장소에서 다음 명령을 실행하십시오.
npm install --ignore-scripts
node bin/spikestrip.mjs --help
또는 체크인된 lockfile과 함께 pnpm install --frozen-lockfile --ignore-scripts를 사용하세요. 이 패키지는 비공개이며 npm에 게시할 목적이 아닙니다.
압축(minification) 후 배포 전에, 빌드된 정적 웹 루트를 대상으로 도구를 실행하세요. 소스와 출력은 서로 다른 디렉터리여야 하며, 어느 쪽도 다른 쪽 안에 있어서는 안 됩니다. 출력 복사본에는 일반 자산과 수정된 파일이 포함됩니다. 이 도구는 원본을 그대로 두고, 심볼릭 링크, VCS 메타데이터, 의존성 디렉터리, 비공개 매니페스트 폴더, 환경 파일은 제외합니다.
# 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는 트리 전체에 걸친 총 삽입 횟수입니다. 배치, 페이로드 선택, 키는 OS 난수를 사용합니다. 미리보기와 이후 쓰기는 서로 다른 위치와 키를 선택할 수 있습니다. 내장 텍스트가 반복되더라도 모든 삽입은 고유한 키를 받습니다. 매니페스트 경로가 제공되지 않으면 출력 디렉터리 옆의 .spikestrip/에 하나가 생성됩니다. 해당 폴더는 비공개로 유지하고 배포 사이트 외부에 두십시오.
이 도구는 .html, .htm, .js, .mjs, .cjs 파일을 지원합니다. Acorn 문 경계를 사용하여 JavaScript 주석을 배치한 다음 구문 트리가 동등한지 확인합니다. HTML 주석은 명시적인 head 또는 body 요소의 직계 자식 앞에 들어갑니다. 문서 트리 검사는 주석 이외의 변경을 거부합니다.
이 도구는 속성 문자열, 원시 텍스트, 템플릿, 인라인 스크립트 본문, 텍스트 콘텐츠에는 삽입하지 않습니다. 명시적인 head/body가 없는 프래그먼트, 유효하지 않은 JavaScript, 지원되지 않는 JSX/TypeScript 파일, 2 MB를 초과하는 소스 파일은 건너뛰고 보고합니다. 또한 안전한 삽입 위치가 없는 지원 대상 소스 파일도 보고합니다. 이러한 소스 파일은 변경 없이 복사됩니다.
웹 소스에 직접 뿌릴 주석 텍스트 파일을 원한다면 --raw를 사용하십시오. 이 옵션은 사이트 디렉터리가 필요 없으며 파일에 아무것도 삽입하지 않고 빌드 트리를 복사하지도 않습니다. 빌드 파이프라인에 삽입 도구를 두고 싶지 않을 때 대안을 제공합니다.
# 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
각 내보낸 주석에는 고유한 무작위 12자 키가 있습니다. 기본 형식은 js이며, --format html은 래퍼를 변경합니다. 내보내기마다 하나의 형식을 선택하고, 해당 파일 형식이 주석을 허용하는 위치에만 주석을 배치하세요. 기존 출력 파일은 절대 덮어쓰지 않습니다. 원시 내보내기는 내장 항목의 경우 1에서 10,000까지, --dynamic 사용 시 1에서 1,000까지의 개수를 허용합니다.
원시 내보내기는 제거 매니페스트를 생성하지 않습니다. SpikeStrip은 주석을 어디에 붙여넣을지 알 수 없기 때문입니다. 텍스트 파일을 키 인벤토리로 보관하고, 해당 키를 검색하여 주석을 수동으로 제거하세요. remove 명령은 매니페스트에 기록된 자동 삽입을 처리하며, 원시 텍스트 파일에서 수동 배치를 발견할 수는 없습니다. --raw와 함께 소스 디렉터리나 --manifest를 전달하지 마세요.
동일한 생성 플래그가 원시 내보내기에서도 작동합니다. 예를 들어 OPENAI_API_KEY를 설정한 후 node bin/spikestrip.mjs inject --raw --output ./unique-comments.txt --format js --dynamic --provider openai --model YOUR_MODEL_ID --count 40 --write를 실행하세요. 미리보기는 여전히 API 요청을 하지 않습니다.
--mode artex를 추가하면 연구 노트에서 연구된 공개 ARTEX 포크를 기반으로 설계된 16개의 미끼를 선택합니다. 이 프로필에는 인용된 API 경로, 조작된 아카이브 청크, 라우트 맵 항목, 워커-투-플래너 핸드오프, 트래픽 검토 우회, 키가 지정된 요약 참조가 포함됩니다. 기본 --mode generic은 원래의 혼합 풀을 유지합니다.
# Inject the ARTEX profile into a separate site copy.
node bin/spikestrip.mjs inject ./site --output ./site-artex --mode artex --count 20 --manifest ./private/artex.json --write
# Export the ARTEX profile for manual placement.
node bin/spikestrip.mjs inject --raw --output ./artex-comments.txt --mode artex --format js --count 30 --write
# Generate new profile-specific comments with your provider key.
node bin/spikestrip.mjs inject --raw --output ./artex-unique.txt --mode artex --dynamic --provider anthropic --model YOUR_MODEL_ID --count 40 --write
ARTEX 프로필은 자체 풀을 선택하고 동적 생성을 위해 prompts/artex.txt를 사용합니다. --prompt-file로 해당 프롬프트를 재정의할 수 있습니다. 자동 매니페스트는 선택된 프로필을 기록하며, 제거 시 동일한 프로필이나 API 키를 요구하지 않고 저장된 주석을 사용합니다. 경로가 포함된 디코이는 다른 생성된 후보와 구별하기 위해 주석 키를 포함합니다. 이들은 엔드포인트, 청크 파일 또는 백엔드 동작을 생성하지 않습니다.
--dynamic은 삽입마다 새로운 디코이 하나를 생성합니다. --count 40은 40개의 서로 다른 텍스트를 요청하고 40개의 개별 키가 지정된 삽입을 생성합니다. 이 도구는 내장 항목이나 실행 중 이전 결과의 정확히 정규화된 중복을 거부합니다. 전역적 또는 의미론적 고유성을 보장할 수는 없습니다.
선호하는 시크릿 관리자를 사용하여 프로세스 환경에 OPENAI_API_KEY 또는 ANTHROPIC_API_KEY를 설정하십시오. 키는 명령줄 인수로 허용되지 않으며, 주석에 기록되거나 매니페스트에 저장되지 않습니다. 계정에서 사용 가능한 모델을 선택하십시오. 하드코딩된 기본값은 없습니다.
# OPENAI_API_KEY must already be set in the environment.
node bin/spikestrip.mjs inject ./site --output ./site-unique --manifest ./private/unique.json --dynamic --provider openai --model YOUR_MODEL_ID --count 40 --write
# ANTHROPIC_API_KEY must already be set in the environment.
node bin/spikestrip.mjs inject ./site --output ./site-unique --manifest ./private/unique.json --dynamic --provider anthropic --model YOUR_MODEL_ID --count 40 --write
생성 프롬프트는 prompts/generate.txt에 있습니다. 이 프롬프트는 워크플로 지침, 조작된 경로와 취약점 힌트, 알려진 CVE 레거시 경로, 수학 작업의 조합을 요청합니다. 수학은 네 개 이상의 항목을 포함하는 배치의 4분의 1로 제한되며, 이는 프롬프트 지침일 뿐 스크립트가 강제하는 할당량은 아닙니다. 프롬프트를 사용자 지정하려면 --prompt-file ./my-prompt.txt를 전달하세요. {{count}}는 각 배치의 요청 크기로 대체되며, 생성된 {{KEY}} 참조는 해당 삽입의 키로 로컬에서 대체됩니다. 스크립트는 주석 안전성을 검증하고 잘못된 형식의 출력을 거부합니다.
생성은 도구가 충분한 삽입 위치를 확인하거나 원시 내보내기 대상을 검증한 후 --write를 사용해야만 시작됩니다. 동적 미리보기는 API 요청을 하지 않으며 API 키도 필요하지 않습니다. 동적 개수는 1에서 1,000까지입니다. 각 요청은 최대 25개의 텍스트를 생성하며, 실행은 최대 ceil(count / 25)번의 요청을 하고 자동으로 재시도하지 않습니다.
--max-output-tokens는 각 응답의 상한을 설정합니다. 기본 상한은 8,192 토큰이며 허용 범위는 1,024–32,768 토큰입니다. 제공자는 토큰 상한이나 지원되지 않는 모델을 거부할 수 있습니다. 실패, 거부, 잘림, 잘못된 JSON, 중복은 사이트를 쓰기 전에 실행을 중단합니다. 완료된 API 요청에는 여전히 요금이 청구될 수 있습니다.
선택된 제공자는 생성 프롬프트, 내장 참조 텍스트, 이전에 생성된 텍스트를 받습니다. 도구는 사이트 소스나 삽입 키를 전송하지 않습니다. 새 텍스트는 비공개 실행 매니페스트와 생성된 사이트 사본, 또는 원시 내보내기 텍스트 파일에 남으며 이 저장소에 기록되지 않습니다. 자동 매니페스트는 제공자, 모델, 숫자 토큰 사용량도 기록합니다. 제거는 제공자 키 없이 오프라인으로 작동합니다.
# Remove all comments recorded in this manifest into another new copy.
node bin/spikestrip.mjs remove ./site-planted --output ./site-clean --manifest ./private/run.json --write
# Remove only selected IDs; --key may be repeated.
node bin/spikestrip.mjs remove ./site-planted --output ./site-partial --manifest ./private/run.json --key a7c94e2b610f --write
제거는 저장된 주석과 정확히 일치하며 관련 없는 편집을 보존합니다. 수정되거나 중복된 주석 블록은 출력을 쓰기 전에 실행을 중단합니다. 이 도구는 이미 없는 블록의 수를 세므로, 지금 선택한 키를 제거하고 나머지는 나중에 제거할 수 있습니다. 모든 삽입이 사라질 때까지 매니페스트를 보관하십시오. 여기에는 감사를 위한 원본 및 주입된 SHA-256 해시가 포함됩니다. 기존 24자 키는 계속 제거할 수 있습니다.