js-x-ray @nodesecure/[email protected]

JS-X-Ray는 JavaScript 및 TypeScript SAST 도구로, 악성 패턴, 보안 취약점 및 코드 이상을 식별합니다. ESLint와 비슷하지만 보안 분석에 특화되어 있습니다. 원래 NodeSecure CLI를 위해 만들어졌지만, JS-X-Ray는 이제 독립적이고 진지한 공급망 보호 옵션으로 성장했습니다.

🔎 작동 방식

JS-X-Ray는 정규식이나 Semgrep 규칙을 많이 사용하지 않고 JS 또는 TS 코드를 **추상 구문 트리(AST)**로 파싱합니다. 이를 통해 변수 추적, 동적 import 해석, 패턴 매칭 도구가 놓치는 정교한 난독화 탐지가 가능합니다. 단점은 JS-X-Ray가 순수하게 JavaScript/TypeScript 생태계에만 전념한다는 것입니다.

💡 기능

• 변수 추적을 통한 require(), import 및 동적 import 추적
• 난독화된 코드 탐지 및 사용된 도구 식별 (jsfuck, jjencode, obfuscator.io 등)
• 악성 패턴 플래그: 데이터 유출, process.env 직렬화, 안전하지 않은 셸 명령
• 취약 코드 탐지: eval(), Function() 생성자, ReDoS 취약 정규식, SQL 인젝션
• 취약한 암호화 알고리즘 플래그 (MD5, SHA1 등)
• 인프라 지표 추출: URL, IP, 호스트명, 이메일
• 설정 가능한 민감도 모드 (보수적/공격적) 및 확장 가능한 프로브 시스템
• JavaScript 및 TypeScript 모두 지원

💃 시작하기

이 패키지는 Node 패키지 저장소에서 제공되며 npm 또는 yarn으로 쉽게 설치할 수 있습니다.

$ npm i @nodesecure/js-x-ray
# or
$ yarn add @nodesecure/js-x-ray

👀 사용법

import { AstAnalyser } from "@nodesecure/js-x-ray";

const scanner = new AstAnalyser();

const { warnings, dependencies } = await scanner.analyseFile("./file.js");

console.log(dependencies);
console.dir(warnings, { depth: null });

전체 API 문서, 경고 카탈로그 및 고급 사용법은 @nodesecure/js-x-ray 패키지 README를 참조하세요.

Workspaces

• @nodesecure/js-x-ray
• @nodesecure/js-x-ray-ai

🐥 기여자 가이드

프로젝트에 기여하고자 하는 개발자는 먼저 CONTRIBUTING 가이드를 읽어야 합니다.

개발을 완료한 후 다음 스크립트를 실행하여 테스트(및 린터)가 여전히 정상인지 확인하세요:

$ npm run check

[!CAUTION] 새로운 기능을 추가하거나 버그를 수정하는 경우 해당 기능에 대한 테스트도 포함해야 합니다.

내부 API

JS-X-Ray 내부 작업을 위한 기여자를 위해 다음 리소스는 저수준 유틸리티와 AST 조작 패턴을 문서화합니다:

• ESTree 유틸리티 - ESTree AST 노드를 조작하기 위한 저수준 헬퍼
• ESTree 할당 및 선언 패턴 (프랑스어) - AST 형태의 JavaScript 할당 및 선언 패턴 참조 가이드

벤치마크

js-x-ray의 성능은 mitata를 사용하여 측정 및 추적됩니다.

벤치마크를 실행하려면:

1. workspaces/js-x-ray로 이동합니다.
2. npm run bench를 실행합니다.

벤치마크 결과는 workspaces/js-x-ray/benchmark/report.json에 저장됩니다. 이 파일을 수동으로 편집하지 마십시오. 모든 풀 리퀘스트에서 자동으로 업데이트됩니다.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Gentilhomme 💻 📖 👀 🛡️ 🐛	Nicolas Hallaert 📖	Antoine 💻	Mathieu 💻	Vincent Dhennin 💻 ⚠️	Tony Gorez 💻 📖 ⚠️	PierreD ⚠️ 💻
Franck Hallaert 💻	Maji 💻	Michaël Zasso 💻 🐛	Kouadio Fabrice Nguessan 🚧 💻	Jean ⚠️ 💻 📖	tchapacan 💻 ⚠️	mkarkkainen 💻
FredGuiou 📖 💻	Madina 💻	SairussDev 💻	Abdou-Raouf ATARMLA 💻	Clement Gombauld 💻 ⚠️	Ajāy 💻	Michael Mior 📖
Hamed Mohamed 💻	Elie Patrice ⚠️	HoyeongJeon 💻	Anne-Flore 💻	Resham 💻

License

MIT