Enlightn Security Checker
The Enlightn Security Checker is a command line tool that checks if your application uses dependencies with known security vulnerabilities. It uses the Security Advisories Database.
Installation Options
- You may install the Enlightn Security Checker with Composer globally, for use with multiple projects:
composer global require enlightn/security-checker
- You may also install the Enlightn Security Checker in your project as a dev dependency using Composer:
composer require --dev enlightn/security-checker
- Instead of installing via Composer, you may also download the security-checker.phar file. Then, in the commands below you can replace
security-checkerwithsecurity-checker.phar.
Usage
To check for security vulnerabilities in your dependencies, you may run the security:check command:
php security-checker security:check /path/to/composer.lock
This command will return a success status code of 0 if there are no vulnerabilities and 1 if there is at least one vulnerability.
Note: You would need to provide the full path of the security-checker executable if the directory is not in your path. For instance:
php vendor/bin/security-checker security:check /path/to/composer.lock
Options
Format
By default, this command displays the result in ANSI. You may use the --format option to display the result in JSON instead:
php security-checker security:check /path/to/composer.lock --format=json
Exclude Dev Dependencies
If you would like to exclude dev dependencies from the vulnerabilities scanning, you may use the --no-dev option (defaults to false):
php security-checker security:check /path/to/composer.lock --no-dev
Allow vulnerabilities
If you would like to exclude some vulnerabilities, you may use the --allow-list option by passing the CVE identifier, or the CVE title. You can pass multiple values as well:
php security-checker security:check /path/to/composer.lock --allow-list CVE-2018-15133 --allow-list "untrusted X-XSRF-TOKEN value"
Do not forget to wrap the title with quotes
Custom Directory for Caching Advisories Database
By default, the SecurityChecker API and the security:check command use the directory returned by the sys_get_temp_dir PHP function for storing the cached advisories database. If you wish to modify the directory, you may use the --temp-dir option:
php security-checker security:check /path/to/composer.lock --temp-dir=/tmp
API
You may also use the API directly in your own code like so:
use Enlightn\SecurityChecker\SecurityChecker;
$result = (new SecurityChecker)->check('/path/to/composer.lock');
The result above is an associative array. The key is the package name and the value is an array of vulnerabilities based on your package version. An example of the JSON encoded version is as below:
{
"laravel/framework": {
"version": "8.22.0",
"time": "2021-01-13T13:37:56+00:00",
"advisories": [{
"title": "Unexpected bindings in QueryBuilder",
"link": "https://blog.laravel.com/security-laravel-62011-7302-8221-released",
"cve": null
}]
}
}
Contribution Guide
Thank you for considering contributing to the Enlightn security-checker project! The contribution guide can be found here.
License
The Enlightn security checkers licensed under the MIT license.
6 Jun 11, 2023
53 Dec 23, 2022
0 Jun 11, 2022
651 Dec 6, 2022
105 Jan 4, 2023
797 Jan 5, 2023
507 Dec 27, 2022
11 Nov 9, 2022
12 Nov 15, 2022
106 Sep 30, 2022
13 Dec 19, 2022
28 Nov 15, 2022
1 Jan 6, 2022
50 Jul 30, 2022
112 Feb 15, 2022
4 Mar 30, 2022
726 Jan 1, 2023
5.4k Jan 7, 2023
3 May 4, 2022