Middlewares are useful features. They will help your development. It’s possible to use Rack middlewares easily through middlewares.rb.

Configuring Rack Middlewares

There is a file called middlewares.rb under your preference directory. That file is a Ruby file. It’s used to configure Rack middlewares.

The configuration for some middlewares are already listed in middlewares.rb. In order to disable or enable middlewares you must edit middlewares.rb.

You are supposed to configure Rack middlewares in middlewares.rb.

The following are middlewares which listed in middlewares.rb after installing Nekonote Framework.

Rack::Reloader

Rack::Reloader reloads modified files without restarting nor reloading the web server.

It’s enabled by default.

preference/your_environment/middlewares.rb

# configuring Rack::Reloader
_cooldown = 10
use Rack::Reloader, _cooldown

ShowExceptions

ShowExceptions is a GUI based debugger. When some exception raised, you can see that exception details on your web browser. It’s enabled by default.

When fatal route is set in route_error.yml, ShowExceptions won't work.
In that case you'd better to set the logger enabled for tracking exceptions.

IMPORTANT: You are supposed to disable this function on production environment for security reason.

Auth::Basic

Auth::Basic provides Basic access authentication.

It’s disabled by defualt.

preference/your_environment/middlewares.rb

# configuring Basic access authentication
_realm    = 'Here is secret zone'
_username = 'username_here'
_passwd   = 'password_here'
use Rack::Auth::Basic, _realm do |username, passwd|
    username == _username && passwd == _passwd
end

Auth::Digest::MD5

Auth::Digest::MD5 provides Digest access authentication.

It’s disabled by defualt.

Passed password is hashed by the MD5 algorithm.

preference/your_environment/middlewares.rb

# configuring Digest access authentication
_realm    = 'Here is secret zone'
_opaque   = 'replace_me' # this is supposed to be set to a long random string
_username = 'username_here'
_passwd   = 'password_here'
_pw = {_username => _passwd}
use Rack::Auth::Digest::MD5, _realm, _opaque do |username|
    _pw[username]
end

Rack::Access

Rack::Access provides access restrcition based on IP addresses.

It’s not installed automatically. You must add 'rack-contrib' to your Gemefile and typing bundle install to use it.

preference/your_environment/middlewares.rb

# access restriction by IP addresses
_rules = {
    # You may append a subnet mask to IP address.
    # You may add any number of IP addresses by comma which allowed accessing the server.
    # '/location' => [ipmasks ,...]
    '/' => ['127.0.0.1/32', '172.16.254.1']
}
require 'rack/contrib'
use Rack::Access, _rules