Skip to content

magicsword-io/LOLRMM

Repository files navigation

LOLRMM - Living Off the Land Remote Monitoring and Management 🖥️🔍

CI build RMM Tools

Welcome to LOLRMM (Living Off the Land Remote Monitoring and Management), a community-driven project that provides a curated list of Remote Monitoring and Management (RMM) tools that could potentially be abused by threat actors. Our mission is to assist security professionals in staying informed about these tools and their potential for misuse, providing the community a catalog of these tools which can be used for threat hunting, detection and prevention policy creations.

🌟 Key Features

  • A comprehensive collection of RMM tools, that have historically been abused by threat actors
  • Structured YAML files that describe key details of each RMM tool, including:
    • Tool name and description
    • Author and creation/modification dates
    • Technical details (website, PE metadata, privileges required, etc.)
    • Supported operating systems and capabilities
    • Known vulnerabilities
    • Installation paths
    • Artifacts left on disk, in event logs, registry, or network
    • Detection methods (including Sigma rules)
    • References and acknowledgements
  • Integrates with Sigma to provide detection rules for RMM tools

🚀 Getting Started

To begin working with LOLRMM, you can:

  1. Check out the LOLRMM website for browsing the catalog.
  2. Clone the repository to explore the YAML files directly.
  3. Use our API to access the data programmatically in JSON or CSV format.

API Usage Example

To fetch the complete list of RMM tools in JSON format, you can use the following curl command:

curl https://lolrmm.io/api/rmm_tools.json

This will return a JSON array containing detailed information about all cataloged RMM tools.

For CSV format, simply change the extension to .csv:

curl https://lolrmm.io/api/rmm_tools.csv

These APIs provide an easy way to integrate LOLRMM data into your threat hunting, detection, and prevention workflows.

Support 📞

Please use the GitHub issue tracker to submit bugs or request features.

🤝 Contributing & Making PRs

Stay engaged with the LOLRMM community by regularly checking for updates and contributing to the project. Your involvement will help ensure the project remains up-to-date and even more valuable to others.

If you'd like to contribute, please follow these steps:

  1. Fork the repository
  2. Create a new branch for your changes
  3. Make your changes and commit them to your branch
  4. Push your changes to your fork
  5. Open a Pull Request (PR) against the upstream repository

For more detailed instructions, please refer to the CONTRIBUTING.md file (if available). To create a new YAML file for an RMM tool, use the provided YAML templates in the yaml directory.

🚨 Sigma Detection

LOLRMM provides Sigma detection rules to help you effectively detect potential threats related to RMM tools. To explore these rules in detail, navigate to the detections/sigma/ directory.

Happy hunting! 🕵️‍♂️

🏗️ Building and Testing Locally

Requirements

Steps to Build and Test Locally

  1. Clone the repository:
git clone https://github.com/magicsword-io/LOLRMM.git
  1. Change to the project directory:
cd LOLRMM
  1. Install dependencies:
poetry install
  1. Activate the virtual environment:
poetry shell
  1. Build the site using the files under the /yaml folder:
python bin/site.py
  1. Change to the website directory and install dependencies:
cd website && pnpm i
  1. Run the website locally:
pnpm dev
  1. Visit http://localhost:3000 in your browser to view the site.

Join us in our quest to create a safer and more secure digital environment for organizations everywhere. With LOLRMM by your side, you'll be well-equipped to understand and address the potential risks associated with RMM tools in the ever-evolving cyber landscape.