semgrep-rules
branch | using semgrep docker image | test status |
---|---|---|
master |
returntocorp/semgrep:latest |
|
develop |
returntocorp/semgrep:develop |
Welcome! This repository is the “standard library” for Semgrep rules, but there are many more written by r2c and other contributors available in the Semgrep Registry. If there a specific rule you are looking for, you can also search the Semgrep registry here.
How do I use these rules?
We recommend starting with a pre-selected subset of rules that someone has already carefully tuned for precision. These subsets of rules, which we will call rulesets, may include rules not present in this repository. However, they are available for free on the Semgrep Registry.
The two most popular rulesets are:
semgrep --config=p/ci
to find logic bugs and high-confidence security vulnerabilities; recommended for CIsemgrep --config=p/security-audit
to find security audit points; noisy, recommended for manual scans
If you are determined to drink from the firehose, you can also pull directly from the registry by specifying r/<foldername.subfolder.etc>
. So to run all the Python Flask rules from the python/flask directory in this repo, just run:
semgrep --config=r/python.flask
Semgrep releases new versions very frequently and the rules in this repo are always updated to take advantage of new features or fix breaking changes on new releases. For that reason, we suggest that you avoid stale copies of registry rules.
Contributing
We welcome Semgrep rule contributions directly to this repository! Since this repo is maintained by r2c, there are some extra benefits-for example, if there are bug reports for your rule, we’ll take responsibility to help fix it. If you are submitting to the semgrep-rules repo (rather than your own, separate repository as mentioned above) we’ll ask you to make r2c a joint owner of your contributions. While you still own copyright rights to your rule, joint ownership allows r2c to license these contributions to other Semgrep Registry users pursuant to the LGPL 2.1 under the Commons Clause. Check out the Contributing Guidelines to get started.
You can also contact us at support@r2c.dev to make Semgrep rule contributions. We will import your rules for everyone to use!
Rulesets
Rulesets -- that is, combined sets of rules from the Semgrep registry -- are organized in a private repository. If you want to modify existing sets or create your own, please contact us at support@r2c.dev.
If you have more questions, please see the FAQ section in the Semgrep docs.
Help
Join Slack for the fastest answers to your questions! Or contact the team at support@r2c.dev.
Rule Namespacing
The namespacing format for contributing rules is <language>.<framework>.<category>.$MORE
. If a framework
isn't applicable, use lang
instead.
category
is one of:
- security
- correctness
- best-practice
- maintainability
- performance
If a security
rule is discouraging the use of a bad pattern (such as formatted SQL strings), we recommended appending audit
to your namespace. This distinguishes it from a security
rule that is specifically aiming to detect a vulnerability.
Github Action To Run Tests
If you fork this repo or create your own, you can add a special semgrep-rules-test Github Action to your workflow that will automatically test your rules by running make test
using the latest version of semgrep.
See ours here
Benchmarks
The benchmark job runs every weekend. It uploads a few artifacts, which can be downloaded. If you download the test logs, there are two relevant pieces of information in there: the benchmark table, which roughly shows the performance of every rule that completes in under 60 seconds, and any failed tests are rules that did not complete within 60 seconds.
To run benchmark tests locally, do the following from the root of semgrep-rules
:
pipenv shell
pipenv install --dev
export PYTHONPATH=.
pytest --timeout=60 --rule-directory=[path_to_rule_directory] --git-repo=[git_URL] tests/performance/test_public_repos.py
If you omit --git-repo
from the pytest command, it will run the provided benchmark repo.