Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

SSL Requirement plugin. This fork implements ssl_required_exceptions and ssl_allowed_exceptions. If a majority of your actions can or must be called under ssl, using these methods makes it easier. You only specify which actions you don't want to be accessed under ssl.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 README
README
SSL Requirement
===============

SSL requirement adds a declarative way of specifying that certain actions
should only be allowed to run under SSL, and if they're accessed without it,
they should be redirected.

Example:

  class ApplicationController < ActiveRecord::Base
    include SslRequirement
  end

  class AccountController < ApplicationController
    ssl_required :signup, :payment 
    ssl_allowed :index
    
    def signup
      # Non-SSL access will be redirected to SSL
    end
    
    def payment
      # Non-SSL access will be redirected to SSL
    end

    def index
      # This action will work either with or without SSL
    end

    def other
      # SSL access will be redirected to non-SSL
    end
  end
  
If a majority (or all) of your actions require SSL, then use ssl_required_exceptions instead of ssl_required.
You can list out the actions that you do NOT want to be SSL protected. Calling ssl_required without 
any actions listed will make ALL actions SSL protected. 

Similarly, if you want all, or a majority of your actions to be allowed to access under SSL,
you can call ssl_allowed_exceptions. The parameters are actions that you do NOT want to be accessed 
under ssl. Leave it empty if you want all actions to be accessible under SSL.
 
You can overwrite the protected method ssl_required? to rely on other things
than just the declarative specification. Say, only premium accounts get SSL.

P.S.: Beware when you include the SslRequirement module. At the time of
inclusion, it'll add the before_filter that validates the declarations. Some
times you'll want to run other before_filters before that. They should then be
declared ahead of including this module.

Copyright (c) 2005 David Heinemeier Hansson, released under the MIT license
Something went wrong with that request. Please try again.