Ruby

Applicability and integration

Ruby is supported for Snyk Code and Snyk Open Source.

Available integrations:

• SCM import

• CLI and IDE: test or monitor your app

Available functions:

• Test your app's SBOM using pkg:gem

• Test your app's packages using pkg:gem

Technical specifications

Snyk supports the following Ruby versions:

Ruby main version	Ruby specific version
2.3.X	2.3.1, 2.3.6
2.4.X	2.4.0, 2.4.1, 2.4.2, 2.4.5, 2.4.6, 2.4.9
2.5.X	2.5.0, 2.5.1, 2.5.3
2.6.X	2.6.1, 2.6.3, 2.6.5, 2.6.6
2.7.X	2.7.2, 2.7.3, 2.7.4, 2.7.5, 2.7.6, 2.7.7, 2.7.8
3.0.X	3.0.0
3.1.X	3.1.0, 3.1.1, 3.1.2, 3.1.3
3.2.X	3.2.0, 3.2.1
3.3.X	3.3.0, 3.3.1, 3.3.2, 3.3.3, 3.3.4 , 3.3.5, 3.3.6, 3.3.7, 3.3.8, 3.3.9
3.4.X	3.4.0, 3.4.1, 3.4.2, 3.4.3, 3.4.4, 3.4.5

Supported frameworks and libraries

For Ruby, the following frameworks and libraries are supported:

• ActiveRecord - Partial

• Connection - Comprehensive

• grpc-ruby - Comprehensive

• LibXML - Comprehensive

• mysql2 - Comprehensive

• Nokogiri - Comprehensive

• OpenSSL - Comprehensive

• openai ruby client - Comprehensive

• ruby-openai - Comprehensive

• rexml - Comprehensive

• Ruby On Rails - Comprehensive

• sinatra - Comprehensive

• sqlite3-ruby - Comprehensive

Supported package managers and registries

For Ruby, Snyk supports Bundler as a package manager. All Gemfile and Gemfile.lock are compatible with the Ruby versions that Snyk supports.

As a package registry, rubygems.org is supported.

Ruby for Snyk Code

For Ruby with Snyk Code, the following file formats are supported: .erb, .haml, .rb, .rhtml, .slm

Available features:

• Reports

• Custom rules

Ruby for Snyk Open Source

Depending on your plan, some features may not be available. For more information, see plans and pricing.

Platform-specific packages are not supported. If these are present in your Gemfile.lock, this can cause an invalid Fix PR to be created. If possible, use the non-platform-specific variant of a package.

For Ruby with Snyk Open Source, the following file formats are supported: gemfile, gemfile.lock

Available features:

• Fix PRs

• License scanning

• Reports

Bundler support

Snyk supports testing, monitoring, and fixing Ruby Projects in the CLI and Git integrations that have their dependencies managed by Bundler and comparing the specific dependency versions against the Ruby vulnerability database.

Snyk tests all Bundler groups. It is not possible to exclude certain groups, such as test or development groups.

Manifest files supported for Ruby

For Ruby, Snyk supports the following manifest files:

• Gemfile

• Gemfile.lock

Snyk requires both files to be present to correctly test, monitor, and fix Ruby Projects.

Private Gem sources

If your Gemfile needs access to private Gem sources, see Private gem sources for Ruby configuration.

Using private Gem sources should work normally when you are using the Snyk CLI.

When creating Fix PRs for Ruby Projects using private Gem sources, Snyk may need access to the service hosting the Gems to update the file correctly.

Fixing vulnerabilities in your Ruby Projects

For Ruby versions < 3.2, Snyk does not support pinning a specific version of Ruby in the Gemfile, for example, ruby "2.7.7". You must use a more permissive version range that encapsulates all point versions, such asruby "~> 2.7.x"

Snyk can fix vulnerabilities by updating vulnerable gems using bundle update after modifying your Gemfile, adhering to the rules you have specified there as far as possible.

In some scenarios, Snyk cannot upgrade all dependencies to non-vulnerable versions. In this case, consider updating the rules in your Gemfile.