gitlab-org--gitlab-foss/doc/security/rack_attack.md
Stan Hu 82c31a9add Support CIDR notation in IP rate limiter
This will make it possible to whitelist multiple IP addresses
(e.g. 192.168.0.1/24).
2019-06-27 23:16:11 -07:00

5.2 KiB

type
reference, howto

Rack Attack

Rack Attack, also known as Rack::Attack, is a Ruby gem that is meant to protect GitLab with the ability to customize throttling and to block user IP addresses.

You can prevent brute-force passwords attacks, scrapers, or any other offenders by throttling requests from IP addresses that are making large volumes of requests. If you find throttling is not enough to protect you against abusive clients, Rack Attack offers IP whitelisting, blacklisting, Fail2ban style filtering, and tracking.

Note: Starting with 11.2, Rack Attack is disabled by default. To continue using Rack Attack, please enable it by configuring gitlab.rb as described in Settings.

By default, user sign-in, user sign-up (if enabled), and user password reset is limited to 6 requests per minute. After trying for 6 times, the client will have to wait for the next minute to be able to try again.

If you installed or upgraded GitLab by following the official guides, Rack Attack should be disabled by default. If your instance is not exposed to any incoming connections, it is recommended that you leave Rack Attack disabled.

For more information on how to use these options check out rack-attack README.

Settings

Omnibus GitLab

  1. Open /etc/gitlab/gitlab.rb with your editor

  2. Add the following:

    gitlab_rails['rack_attack_git_basic_auth'] = {
      'enabled' => true,
      'ip_whitelist' => ["127.0.0.1"],
      'maxretry' => 10, # Limit the number of Git HTTP authentication attempts per IP
      'findtime' => 60, # Reset the auth attempt counter per IP after 60 seconds
      'bantime' => 3600 # Ban an IP for one hour (3600s) after too many auth attempts
    }
    
  3. Reconfigure GitLab:

    sudo gitlab-ctl reconfigure
    

The following settings can be configured:

  • enabled: By default this is set to false. Set this to true to enable Rack Attack.
  • ip_whitelist: Whitelist any IPs from being blocked. They must be formatted as strings within a Ruby array. CIDR notation is supported in GitLab v12.1 and up. For example, ["127.0.0.1", "127.0.0.2", "127.0.0.3", "192.168.0.1/24"].
  • maxretry: The maximum amount of times a request can be made in the specified time.
  • findtime: The maximum amount of time that failed requests can count against an IP before it's blacklisted (in seconds).
  • bantime: The total amount of time that a blacklisted IP will be blocked (in seconds).

Installations from source

These settings can be found in config/initializers/rack_attack.rb. If you are missing config/initializers/rack_attack.rb, the following steps need to be taken in order to enable protection for your GitLab instance:

  1. In config/application.rb find and uncomment the following line:

    config.middleware.use Rack::Attack
    
  2. Copy config/initializers/rack_attack.rb.example to config/initializers/rack_attack.rb

  3. Open config/initializers/rack_attack.rb, review the paths_to_be_protected, and add any other path you need protecting

  4. Restart GitLab:

    sudo service gitlab restart
    

If you want more restrictive/relaxed throttle rules, edit config/initializers/rack_attack.rb and change the limit or period values. For example, more relaxed throttle rules will be if you set limit: 3 and period: 1.seconds (this will allow 3 requests per second). You can also add other paths to the protected list by adding to paths_to_be_protected variable. If you change any of these settings do not forget to restart your GitLab instance.

Remove blocked IPs from Rack Attack via Redis

In case you want to remove a blocked IP, follow these steps:

  1. Find the IPs that have been blocked in the production log:

    grep "Rack_Attack" /var/log/gitlab/gitlab-rails/auth.log
    
  2. Since the blacklist is stored in Redis, you need to open up redis-cli:

    /opt/gitlab/embedded/bin/redis-cli -s /var/opt/gitlab/redis/redis.socket
    
  3. You can remove the block using the following syntax, replacing <ip> with the actual IP that is blacklisted:

    del cache:gitlab:rack::attack:allow2ban:ban:<ip>
    
  4. Confirm that the key with the IP no longer shows up:

    keys *rack::attack*
    
  5. Optionally, add the IP to the whitelist to prevent it from being blacklisted again (see settings).

Troubleshooting

Rack attack is blacklisting the load balancer

Rack Attack may block your load balancer if all traffic appears to come from the load balancer. In that case, you will need to:

  1. Configure nginx[real_ip_trusted_addresses]. This will keep users' IPs from being listed as the load balancer IPs.

  2. Whitelist the load balancer's IP address(es) in the Rack Attack settings.

  3. Reconfigure GitLab:

    sudo gitlab-ctl reconfigure
    
  4. Remove the block via Redis.