At GuardRails, we focus on security that doesn't get in your way. That means supporting a quick and easy installation, without any additional configuration.
Nonetheless, we understand that one size doesn't fit all. A great developer experience requires flexibility to configure GuardRails to your needs.
You can override the default configuration for your account/organization in the Settings tab of the dashboard. By default, the config is:
bundles: "auto" report: pullRequest: findings: "onChangedLinesOnly" comment: true notifications: slack: enabled: false
Bundles are set of tools we use to detect security issues in repositories.
Currently, we support the following bundles:
By default, we run the general bundle, along with the bundle(s) matching the language(s) we detect in your repository. It can happen that we don't detect (all) the language(s) of your repository properly, so you can override the bundles attribute to serve your needs:
You can even go further by overriding the tools that run within a bundle:
Here are all the possibilities:
This attribute enables you to control the behavior of GuardRails in your pull requests. Per default, we only notify you of security issues detected in the lines that changed in your pull requests (
true (default) or
By default, we post a comment in your pull requests if we find any security issues. If you prefer to review the reports via our dashboard and want to disable the comments, set this attribute to
The attribute should be a valid URL corresponding to a Slack Incoming Webhook (e.g. https://hooks.slack.com/services/xxxxxxxxx/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx).
The ignore file can come handy if you notice GuardRails is alerting you on some code you deliberately know is vulnerable, or causes false positives. The ignore file follows the gitignore file pattern. Refer to the gitignore docs for more details. One example file is:
If you want to disable one line in particular, you need to add
guardrails-disable-line on the concerned line, usually as a comment.
const mySecret = "e32kdjksw'(&dej+"; // guardrails-disable-line