Gathering detailed insights and metrics for @secretlint/secretlint-rule-filter-comments
Gathering detailed insights and metrics for @secretlint/secretlint-rule-filter-comments
Gathering detailed insights and metrics for @secretlint/secretlint-rule-filter-comments
Gathering detailed insights and metrics for @secretlint/secretlint-rule-filter-comments
npm install @secretlint/secretlint-rule-filter-comments
Module System
Min. Node Version
Typescript Support
Node Version
NPM Version
899 Stars
1,257 Commits
40 Forks
9 Watching
6 Branches
28 Contributors
Updated on 28 Nov 2024
TypeScript (95.83%)
JavaScript (3.33%)
Shell (0.59%)
Dockerfile (0.25%)
Cumulative downloads
Total Downloads
Last day
-7.9%
1,968
Compared to previous day
Last week
21.2%
9,290
Compared to previous week
Last month
-24.3%
36,412
Compared to previous month
Last year
-27.2%
581,311
Compared to previous year
1
Secretlint is that Pluggable linting tool to prevent committing credentials.
You can view secretlint linting result on https://secretlint.github.io/.
You can try to use Secretlint on your project at one command.
If you already have installed Docker:
docker run -v `pwd`:`pwd` -w `pwd` --rm -it secretlint/secretlint secretlint "**/*"
If you already have installed Node.js:
npx @secretlint/quick-start "**/*"
After running,
If you got empty result and exit status is 0
, your project is secure.
Otherwise, you got some error report, your project includes credential as raw data.
You want to get continuous security, Please see following installation guide and setup pre-commit hook and CI.
Prerequisites: Require Docker
Use our Docker container to get an environment with Node.js and secretlint and running as fast as you can download them.
You can check all files under the current directory with secretlint by following command:
docker run -v `pwd`:`pwd` -w `pwd` --rm -it secretlint/secretlint secretlint "**/*"
secretlint/secretlint
docker container work without configuration by design.
This Docker Image has built-in packages:
For more details, please see secretlint's Dockerfile.
Prerequisites: Require Node.js 18+.
Secretlint is written by JavaScript. You can install Secretlint using npm:
npm install secretlint @secretlint/secretlint-rule-preset-recommend --save-dev
You should then set up a configuration file:
npx secretlint --init
Finally, you can run Secretlint on any file or directory like this:
npx secretlint "**/*"
:memo: Secretlint support glob pattern and glob pattern should be wrapped by a double quote.
It is also possible to install Secretlint globally using npm install --global
. But, We do not recommended it, some rules may be broken in globally.
Prerequisites: None
You can use secretlint
command without Node.js by using a single-executable binary.
chmod +x ./secretlint
./secretlint --init
to create a configuration file./secretlint "**/*"
to lint your projectFor more details, please see publish/binary-compiler README.
secretlint --help
show Usage.
Secretlint CLI that scan secret/credential data.
Usage
$ secretlint [file|glob*]
Note
supported glob syntax is based on microglob
https://github.com/micromatch/micromatch#matching-features
Options
--init setup config file. Create .secretlintrc.json file from your package.json
--format [String] formatter name. Default: "stylish". Available Formatter: checkstyle, compact, jslint-xml, json, junit, pretty-error, stylish, table, tap, unix, mask-result
--output [path:String] output file path that is written of reported result.
--no-color disable ANSI-color of output.
--no-terminalLink disable terminalLink of output.
--maskSecrets enable masking of secret values. replace actual secrets with "***".
--secretlintrc [path:String] path to .secretlintrc config file. Default: .secretlintrc.*
--secretlintignore [path:String] path to .secretlintignore file. Default: .secretlintignore
Options for Developer
--profile Enable performance profile.
--secretlintrcJSON [String] a JSON string of .secretlintrc. use JSON string instead of rc file.
Experimental Options
--locale [String] locale tag for translating message. Default: en
Examples
$ secretlint ./README.md
# glob pattern should be wrapped with double quote
$ secretlint "**/*"
$ secretlint "source/**/*.ini"
# found secrets and mask the secrets
$ secretlint .zsh_history --format=mask-result --output=.zsh_history
Exit Status
Secretlint exits with the following values:
- 0:
- Linting succeeded, no errors found.
- Found lint error but --output is specified.
- 1:
- Linting failed, errors found.
- 2:
- Unexpected error occurred, fatal error.
Secretlint has a configuration file .secretlintrc.{json,yml,js}
.
After running secretlint --init
, you'll have a .secretlintrc.json
file in your directory.
In it, you'll see some rules configured like this:
1{ 2 "rules": [ 3 { 4 "id": "@secretlint/secretlint-rule-preset-recommend" 5 } 6 ] 7}
The id
property is the name of secretlint rule package.
Secretlint does not have built-in rule.
You want to add some rule and You should install the package and add the rule to .secretlintrc
file.
Each rule has same configuration pattern:
options
: Option definition for the rule. For more details, see each rule documentationdisabled
: If disabled
is true
, disable the ruleallowMessageIds
: allowMessageIds
is an array of message id that you want to suppress error report
options
For example, @secretlint/secretlint-rule-example
has allows
in options
.
This allows
option define a list of RegExp-like String that you want to ignore.
1{ 2 "rules": [ 3 { 4 "id": "@secretlint/secretlint-rule-example", 5 "options": { 6 "allows": [ 7 "/dummy_secret/i" 8 ] 9 } 10 } 11 ] 12}
When you use a preset like @secretlint/secretlint-rule-preset-recommend
, you need to put the option in rules
.
For example, an option for @secretlint/secretlint-rule-preset-recommend > @secretlint/secretlint-rule-aws
1{ 2 "rules": [ 3 { 4 "id": "@secretlint/secretlint-rule-preset-recommend", 5 "rules": [ 6 { 7 "id": "@secretlint/secretlint-rule-aws", 8 "options": { 9 "allows": [ 10 // it will be ignored 11 "xxxx-xxxx-xxxx-xxxx-xxxx" 12 ] 13 } 14 } 15 ] 16 } 17 ] 18}
allowMessageIds
For example, you have got following error report by run secretlint
:
$ secretlint "**/*"
SECRET.txt
1:8 error [EXAMPLE_MESSAGE] found secret: SECRET @secretlint/secretlint-rule-example
✖ 1 problem (1 error, 0 warnings)
This error's message id is EXAMPLE_MESSAGE
in @secretlint/secretlint-rule-example
.
If you want to ignore this error, please use allowMessageIds
.
1{ 2 "rules": [ 3 { 4 "id": "@secretlint/secretlint-rule-example", 5 "allowMessageIds": ["EXAMPLE_MESSAGE"] 6 } 7 ] 8}
When you use a preset like @secretlint/secretlint-rule-preset-recommend
, you need to put the option in rules
.
For example, If you want to ignore "AWSAccountID" and "AWSAccessKeyID" of "@secretlint/secretlint-rule-aws", you can write following.
1{ 2 "rules": [ 3 { 4 "id": "@secretlint/secretlint-rule-preset-recommend", 5 "rules": [ 6 { 7 "id": "@secretlint/secretlint-rule-aws", 8 "allowMessageIds": ["AWSAccountID", "AWSAccessKeyID"] 9 } 10 ] 11 } 12 ] 13}
@secretlint/secretlint-rule-filter-comments supports ignoring comment like secretlint-disable
.
// secretlint-disable
THIS IS SECRET, BUT IT WILL BE IGNORED
// secretlint-enable
For more details, please see Configuring Secretlint.
Secretlint support --maskSecrets
option that mask secrets in lint error message.
It is useful that you want to hide secrets in CI logs.
1$ secretlint --maskSecrets "**/*"
Secretlint can not fix the secrets automatically.
However, It is useful that --format=mask-result
mask the secrets of input file.
For example, you can mask the secrets of .zsh_history
file and overwrite it.
1$ secretlint .zsh_history --format=mask-result --output=.zsh_history
Secretlint rules has been implemented as separated modules.
Also, Secretlint provide rule preset that includes recommened rule set.
You can create own secretlint rule.
You want to get a secretlint rule for suitable your project and you can create it! A secretlint rule is a just npm package.
If you want to know creating secretlint rule, please see docs/secretlint-rule.md.
You can use Secretlint with some pre-commit tool. This can prevent to commit secret data by linting with Secretlint.
Applying secretlint to the project and improve security on team developing.
Use Case: If you want to introduce secretlint to Node.js project, this combination is useful.
Install Husky and lint-staged:
npx husky-init && npm install lint-staged --save-dev
Add hooks to .husky/pre-commit
:
npx husky add .husky/pre-commit "npx --no-install lint-staged"
Edit package.json
:
1{ 2 // add "lint-staged" field 3 "lint-staged": { 4 "*": [ 5 "secretlint" 6 ] 7 } 8}
This means that check each staged file by Secretlint before commit.
Use Case: You have a project that is developing with Docker. Easy to integrate to secretlint.
Install pre-commit
# macOS. see also https://pre-commit.com/#install
brew install pre-commit
Create .pre-commit-config.yaml
:
- repo: local
hooks:
- id: secretlint
name: secretlint
language: docker_image
entry: secretlint/secretlint:latest secretlint
Example setup repository:
Alternately you can save this script as .git/hooks/pre-commit
and give it execute permission(chmod +x .git/hooks/pre-commit
):
1#!/bin/sh 2FILES=$(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g') 3[ -z "$FILES" ] && exit 0 4 5# Secretlint all selected files 6echo "$FILES" | xargs ./node_modules/.bin/secretlint 7# If you using docker 8# echo "$FILES" | xargs docker run -v `pwd`:`pwd` -w `pwd` --rm secretlint/secretlint secretlint 9RET=$? 10if [ $RET -eq 0 ] ;then 11 exit 0 12else 13 exit 1 14fi
Use Case: If you want to check any project by secretlint, you can use global git hooks.
Git 2.9+ supports core.hooksPath
.
It allow to integrate secretlint globally.
We have created example git hooks project using secretlint + Docker.
You can set up by following steps:
1# clone this repository 2git clone https://github.com/secretlint/git-hooks git-hooks 3cd git-hooks 4# integrate secretlint to git hook globally 5git config --global core.hooksPath $(pwd)/hooks
After setup of core.hooksPath
, secretlint check any file before you commit it.
For more details, see secretlint/git-hooks project.
Node.js version also can be used for global git hook. If you interesting in it, please see @azu/git-hooks.
If you already set secretlint Using Node.js, you can run secretlint with your configuration on GitHub Actions.
Put .github/workflows/secretlint.yml
in your repository.
1name: Secretlint 2on: [push, pull_request] 3permissions: 4 contents: read 5jobs: 6 test: 7 name: "Secretlint" 8 runs-on: ubuntu-latest 9 steps: 10 - name: checkout 11 uses: actions/checkout@v3 12 - name: setup Node.js 13 uses: actions/setup-node@v3 14 with: 15 node-version: 20 16 - name: Install 17 run: npm ci 18 - name: Lint with Secretlint 19 run: npx secretlint "**/*"
This configuration also integrate Pull Request review comment via actions/setup-node.
If you want to only check diff files, please see following example:
1name: test-diff 2on: 3 push: 4 pull_request: 5jobs: 6 test-diff: 7 permissions: 8 contents: read 9 name: "Run secretlint to diff files" 10 runs-on: ubuntu-latest 11 steps: 12 - name: checkout 13 uses: actions/checkout@v4 14 with: 15 # fetch history to get all changed files on push or pull_request event 16 fetch-depth: 0 17 - name: Get changed files 18 id: changed-files 19 uses: tj-actions/changed-files@v44 20 - name: setup Node ${{ matrix.node-version }} 21 uses: actions/setup-node@v4 22 with: 23 node-version: 20 24 - name: Show changed files 25 run: echo "${{ steps.changed-files.outputs.all_changed_files }}" 26 - name: Install 27 if: steps.changed-files.outputs.any_changed == 'true' 28 run: npm ci 29 - name: Run secretlint 30 if: steps.changed-files.outputs.any_changed == 'true' 31 run: npx secretlint ${{ steps.changed-files.outputs.all_changed_files }}
Mega-Linter is a linters aggregator natively compliant with any CI tool, embedding 80+ linting apps, including secretlint by default.
You can install it on any repository project using the following command (Node.js must be installed previously)
1npx mega-linter-runner --install
Secretlint WebExtension works on your browser.
This web extension aim to founds credentials that are included in your request/response.
Secretlint WebExtension integrate to DevTools in Chrome/Firefox. This extension help web developer to notice exposed credential.
Please use @secretlint/secretlint-formatter-sarif.
npm install @secretlint/secretlint-formatter-sarif --dev
secretlint --format @secretlint/secretlint-formatter-sarif "**/*"
Secretlint project follow Semantic Versioning(secretlint-rule-preset-canary is exception).
Secretlint adopt opt-in approach.
In our experience, linting tools that report various errors by default is difficult to use. Opt-in approach help to introduce Secretlint increasing.
It will help to reduce false-positive by configuration.
We think a rule as a documentation. So, Each rule should have reasonable documentation.
We need to describe why this file is error. A rule that has not documentation, It is just a opinionated.
Describe the reason of error and then it will lead to reduce false-positive error.
Also, Secretlint CLI support hyperlink in Terminal. It means that you can jump to rule documentation from lint error message directly.
Example on iTerm 2: Cmd + Click error's messageId and open AWSSecretAccessKey on your browser.
If you want to know support terminal, please see Hyperlinks in Terminal Emulators.
Also, Welcome to Contribution about secretlint documentation!
Of course, secretlint also support Docker.
See Releases page.
Pull requests and stars are always welcome.
For bugs and feature requests, please create an issue.
See also, CONTRIBUTING.md and CODE_OF_CONDUCT.md
You can use npm run gen:rule
command to create new rule.
1npm run gen:rule
For more details, please see CONTRIBUTING.md
Benchmark workflow is run on every commit.
MIT © azu
No vulnerabilities found.
Reason
30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Reason
no dangerous workflow patterns detected
Reason
no binaries found in the repo
Reason
license file detected
Details
Reason
packaging workflow detected
Details
Reason
security policy file detected
Details
Reason
SAST tool detected but not run on all commits
Details
Reason
3 existing vulnerabilities detected
Details
Reason
Found 1/25 approved changesets -- score normalized to 0
Reason
detected GitHub workflow tokens with excessive permissions
Details
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
project is not fuzzed
Details
Reason
Project has not signed or included provenance with any releases.
Details
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
Score
Last Scanned on 2024-11-18
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More