railroader - A static analysis security vulnerability scanner f

项目说明

<!-- ![Railroader Logo]() -->

![Build Status]()
![Maintainability]()
![Test Co]()
![License]()
![CII Best Practices]()
<!-- ![Gitter]() -->

Railroader

Railroader is an open source static analysis tool which checks Ruby on Rails applications for security .

Railroader is a fork of the Brakeman analysis tool 4.3.1 (the last of Brakeman that was open source software). A key distinguishing feature is that Railroader is open source software (OSS), while Brakeman is not open source software any more. Railroader is licensed under the MIT-LICENSE. As a result, Railroader can be freely used for any purpose, including any commercial purposes. In addition, contributors to Railroader (unlike Brakeman) retain their copyrights.

If you are interested in Brakeman, please see the Brakeman site instead!

We are currently in a transition process, because we have just started creating Railroader as a fork of Brakeman. Some names in the process of changing - help is wanted to complete it. We need to change the name, because we assume that Synopsys owns the trademarks and in any case we want to make sure there is *no* confusion by anyone that Railroader is Brakeman (they are now different projects).

Installation

Using RubyGems:

gem install railroader

Using Bundler:

group :de do
gem 'railroader', :require => false
end

Usage

From a Rails application's root directory:

railroader

Outside of Rails root:

railroader /path/to/rails/application

Compatibility

Railroader should work with any of Rails from 2.3.x to 5.x.

Railroader can analyze code written with Ruby 1.8 syntax and newer, but requires at least Ruby 1.9.3 to run.

Basic Options

For a full list of options, use railroader --help or see the OPTIONS.md file.

To specify an output file for the results:

railroader -o output_file

The output format is determined by the file extension or by using the -f option. Current options are: text, html, tabs, json, markdown, csv, and codeclimate.

Multiple output files can be specified:

railroader -o output.html -o output.json

To suppress informational warnings and just output the report:

railroader -q

Note all Railroader output except reports are sent to stderr, making it simple to redirect stdout to a file and just get the report.

To see all kinds of debugging information:

railroader -d

Specific checks can be skipped, if desired. The name needs to be the correct case. For example, to skip looking for default routes (DefaultRoutes):

railroader -x DefaultRoutes

Multiple checks should be separated by a comma:

railroader -x DefaultRoutes,Redirect

To do the opposite and only run a certain set of tests:

railroader -t SQL,

If Railroader is running a bit slow, try

railroader --faster

This will disable some features, but will probably be much faster (currently it is the same as --skip-libs --no-branching). *WARNING*: This may cause Railroader to miss some .

By default, Railroader will return a non-zero exit code if any security warnings are found or scanning errors are encountered. To disable this:

railroader --no-exit-on-warn --no-exit-on-error

To skip certain files or directories that Railroader may ha parsing, use:

railroader --skip-files file1,/path1/,path2/

To compare results of a scan with a previous scan, use the JSON output option and then:

railroader --compare old_report.json

This will output JSON with two lists: one of fixed warnings and one of new warnings.

Railroader will ignore warnings if configured to do so. By default, it looks for a configuration file in config/railroader.ignore.
(To help people transition from Brakeman, if config/railroader.ignore
doesn't exist, but config/brakeman.ignore does, then we'' use the
latter file.)
To create and manage this file, use:

railroader -I

Warning information

See warning\_types for more information on the warnings reported by this tool.

Warning context

The HTML output format provides an excerpt from the original application source where a warning was triggered. Due to the processing done while looking for , the source may not resemble the reported warning and reported line numbers may be slightly off. However, the context still provides a quick look into the code which raised the warning.

Confidence levels

Railroader assigns a confidence level to each warning. This provides a rough estimate of how certain the tool is that a gi is actually a problem. Naturally, these ratings should not be taken as absolute truth.

There are three levels of confidence:

+ High - Either this is a simple warning (boolean value) or user input is very likely being used in unsafe ways.
+ Medium - This generally indicates an unsafe use of a , but the may or may not be user input.
+ Weak - Typically means user input was indirectly used in a potentially unsafe manner.

To only get warnings above a gi level:

railroader -w3

The -w switch takes a number from 1 to 3, with 1 being low (all warnings) and 3 being high (only highest confidence warnings).

Configuration files

Railroader options can stored and read from YAML files. To simplify the process of writing a configuration file, the -C option will output the currently set options.

Options passed in on the commandline ha o files.

The default config locations are ./config/railroader.yml, ~/.railroader/config.yml, and /etc/railroader/config.yml

The -c option can be used to specify a configuration file to use.

Continuous Integration

There is a plugin a for Jenkins/Hudson.

For even more continuous testing, try the Guard plugin.

Building

git clone git://github.com/da/railroader.git
cd railroader
gem build railroader.gemspec
gem install railroader*.gem

<!-- # Who is Using Railroader?

* Code Climate
* GitHub
* Groupon
* New Relic
* Twitter

..and more!

-->

Contributing

We lo! Please help us!

For more about how to contribute, see CONTRIBUTING.md.

Reporting in Railroader itself

If you find an exploitable in Railroader itself,
see CONTRIBUTING.md.

Homepage/News

Website:

Twitter:

License

See MIT-LICENSE.

项目信息

开发语言：Ruby

Star 数：48

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕A static analysis security vulnerability scanner for Ruby on Rails applications (OSS fork of Brakeman)展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。