Overview

The Senthor Rails middleware integrates directly into your Ruby on Rails application. It automatically detects AI crawlers and allows you to protect and monetize your content in real-time.

Main features

• Real-time detection of AI crawlers (GPTBot, ClaudeBot, Gemini, etc.)
• Precise crawler control (blocking, authorization, monetization)
• Detailed analytics via Senthor dashboard
• Drop-in installation without modifying your existing code

Installation

Method 1: Via Bundler (recommended)

1. 1. Add the gem

   From your Rails project, run:

   bundle add senthor_rails

2. 2. Install dependencies

   If necessary, run `bundle install` to install the gem.

Method 2: Direct installation

1. 1. Install the gem

   If you don't manage dependencies with Bundler:

   gem install senthor_rails

Configuration

1. 1. Enable the middleware

   In `config/application.rb`, add the Senthor middleware:

   class Application < Rails::Application
     # ...
     config.middleware.use Senthor::Middleware
   end

2. 2. Configure your site on Senthor

   Log in to app.senthor.io, add your domain and select the "Rails Application" option. Detection will be automatic on next deployment.

3. 3. Restart your application

   Restart your Rails server for the middleware to take effect.

How it works

Once the middleware is enabled, Senthor:

• Intercepts all incoming GET requests
• Communicates with the Senthor API to identify AI crawlers
• Automatically detects AI scraping patterns
• Applies your rules (blocking, authorization, challenge, monetization)

If your site isn't configured on Senthor, all requests will pass through normally.

Technical requirements

• Ruby ≥ 3.2.0 for senthor_rails
• Ruby ≥ 2.3.0 for senthor_rails_legacy
• Ruby on Rails (all versions)

Source: official RubyGems documentation

Version for Ruby 2.3+ (Legacy)

If you are using Ruby 2.3 to 3.1, use the legacy version:

Via Bundler:

bundle add senthor_rails_legacy

Direct installation:

gem install senthor_rails_legacy

The configuration remains the same (config.middleware.use Senthor::Middleware)

More information on RubyGems: senthor_rails_legacy

That's it!

Your Rails application is now protected. You can track statistics and configure protection rules from your Senthor.io dashboard.

Support

For any questions about Rails integration, contact us at contact@senthor.io

More information

To view technical details and updates: