Code Monkey home page Code Monkey logo

unprotect_submission's Introduction

How to contribute to the Unprotect Project?

The Unprotect project is an open-source database that aims to classify malware evasion techniques to strengthen the security in place, but also to understand how malware can bypass security mechanisms. This is a handy resource for the red, blue, and purple teamer.

This project is community-centric so that everyone can contribute to the database. The purpose of this repository is to provide a simple way for the community to contribute to the project. For each contributor, we will add your name in the contributor's section.

Before writing a proposal, we recommend that you review an example.

To add a technique, you can fork this repository, create a folder in the techniques section containing the name of the technique, and add the details. You have a sample model available here. Once you've added your technique, you can PR.

More details on the process of adding, modifying, or updating a technique can be found below.

Adding a new technique to the database

To contribute, you can send a pull request to this repository containing the title of the technique in the PR and including the following. You can also have a look to the template description.

1 - Authorship information

  • Name or Pseudo (required)
  • Twitter handle (not required)
  • Website (not required)
  • Linkedin profile (not required)
  • Email address (not required)

2 - Technique Information (required)

Each submission should include several pieces of information to be reviewed:

  • Technique title (required): the techniques you want to add with a minimum of words
  • Technique category (required): add the category on which your technique is based. Check the list
  • Technique description (required): iInclude as much detail as possible about your technique. Don't worry about grammar, the Unprotect team will review the submission.
  • Additional ressources: include any additional resources relevant to the techniques.

3 - Code snippet (not required but highly recommended)

  • For each technique in the database, we try to document it with a functional POC. It is highly recommended to add it if you have it. The Unprotect team will review and test the code.
  • Code can be written in any language (C/C++, Python, Golang, Powershell, ASM, Delphi...)
  • You can add a small description at the top to mention any specific information such as the library required to run.
  • If you are reusing the code from elsewhere, please add a comment at the beginning of your code that includes the original source.

4 - Detection Rules (not required but highly recommended)

The detection rules part is particularly important to help the community defend itself against these techniques. Although it is not always possible to create detection rules, we strongly encourage you to do your best to add them.

  • Yara rules: Please add the Yara rules related to your technique. If it's yours, add your name in the meta, otherwise keep the original authorship.
  • Sigma rules: Please add the Sigma rules related to your technique. If it's yours, add your name in the meta, otherwise keep the original authorship.
  • Capa rules: Please add the Capa rules related to your technique.If it's yours, add your name in the meta, otherwise keep the original authorship.

Modifying a technique

Sometimes you may have more details on a specific technique or you may notice an error somewhere. You can also have snippets or detection rules.

Please add your modification including the following information:

1 - Authorship information

2 - Title of the techniques to modify

3 - New Description (if required)

4 - Code snippet (if you have it)

5 - Detection rules (if you have it)

Thanks for your contribution!

We created this project to help the infosec community. We hope you like it because we put a lot of effort into it. We have more work in the pipeline and if you're interested, we recommend that you stay on top of future releases by following us:

In the future, we would like to thank our contributors and we are planning some goodies. ;)

You can also send greetings to us if you like this project. <3

unprotect_submission's People

Contributors

fr0gger avatar russianpanda95 avatar alsch092 avatar cod3nym avatar tatsuya-hasegawa avatar lisandro-git avatar irfan-eternal avatar sh0ckfr avatar th4nat0s avatar dreamkinn avatar timelifeczy avatar west-wind avatar wand3rlust avatar lexsek avatar f0wl avatar hlldz avatar d4rksystem avatar nuts7 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.