작동 방식

• 플러그인은 빌드 실행기의 운영 체제와 아키텍처를 기반으로 GitHub에서 Nuclei의 최신 릴리스를 다운로드합니다.
• 다운로드된 아티팩트의 압축이 해제됩니다.
  • 현재 실행 중인 빌드의 작업 공간에 이미 Nuclei 바이너리가 있으면 처음 두 단계는 생략됩니다.
• Nuclei 템플릿이 다운로드/업데이트됩니다.
• 제공된 사용자 입력을 사용하여 스캔이 실행됩니다.

사용법

• Freestyle 프로젝트를 생성하거나 편집합니다.
• Nuclei Vulnerability Scanner 빌드 단계를 추가합니다.
• 테스트하려는 대상 웹 애플리케이션의 URL을 입력합니다.
• 선택 사항:
  • Jira 및 GitHub와 같은 플랫폼에서 자동으로 이슈를 생성할 수 있는 보고 구성을 추가합니다. 아래의 추가 플래그를 사용하면 로그 레벨을 높여 이슈 트래커 통합과 관련된 잠재적 문제를 디버깅할 수 있습니다.
  • 추가 CLI 인수를 추가합니다(예: -v, -debug).
• 기본적으로 이 플러그인은 Nuclei의 최신 릴리스 버전을 사용합니다. 드물게 새 주요 버전이 플러그인에서 사용하는 CLI 인터페이스와 하위 호환되지 않는 경우, 이전 버전을 수동으로 선택하여 문제를 임시로 해결할 수 있습니다. 플러그인 업데이트를 요청하려면 티켓을 생성해 주세요.

수동으로 빌드하기

1. pom.xml이 있는 루트 디렉터리에서 Maven을 사용하여 코드를 빌드할 수 있습니다.
   • mvn clean package -DskipTests
2. 빌드된 아티팩트는 ./target/nuclei.hpi에서 찾을 수 있습니다.
3. 플러그인이 사전 설치된 Jenkins 배포를 시작하려면 mvn hpi:run을 사용하면 됩니다.
   • 디버깅을 활성화하려면 mvnDebug hpi:run을 사용한 다음, 실행 구성에 다음 매개변수를 추가하여 원격 디버거를 연결하세요: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000

Pull Request를 생성하기 전에 다음 단계를 반드시 수행하세요:

1. 프로젝트 내에서 테스트를 실행하세요(-DskipTests 플래그를 제거하고).
2. 완전한 Jenkins 인스턴스에서 플러그인을 테스트하세요:
   • <jenkins_install_dir>/plugins 내에 nuclei.hpi 파일을 복사/덮어써서 플러그인을 "설치"할 수 있습니다(예: /var/lib/jenkins/plugins/nuclei.hpi).
   • Jenkins 서비스를 다시 시작해야 합니다(sudo service jenkins restart).
3. Primary(마스터) 노드와 원격 에이전트에서도 플러그인 실행을 테스트하세요.

새로 시작하기

1. target 폴더 내의 컴파일된 클래스와 생성된 아티팩트를 삭제합니다: mvn clean
2. 현재 사용자의 Nuclei 구성을 제거합니다(있는 경우): rm -rf ~/.config/nuclei
3. jenkins 사용자의 Nuclei 구성을 제거합니다(있는 경우): sudo rm -rf <jenkins_install_dir>/.config/nuclei (예: /var/lib/jenkins/.config/nuclei)
4. Nuclei 바이너리, 해당 템플릿 및 생성된 출력을 제거합니다: sudo rm -rf <jenkins_install_dir>/workspace/<build_name>/nuclei*
5. 원격 에이전트에 연결하여 동일하게 수행합니다.

제한 사항

• Freestyle 프로젝트만 지원합니다(파이프라인 없음).
• 스캐너 바이너리가 번들로 제공되지 않으며, 에이전트는 인터넷 액세스가 필요합니다.

Nuclei 문서

• https://nuclei.projectdiscovery.io
• https://github.com/projectdiscovery/nuclei