authlogic_rpx 1.0.2

data/CHANGELOG.rdoc

@@ -0,0 +1,13 @@
+== 1.0.2 released 2009-09-27
+
+* Fixed issue with rpx_popup that was causing an error on some webkit-based browsers (incl chrome)
+
+== 1.0.1 released 2009-09-26
+
+* Initial public release
+* RPX profile mappings switched to use indirect Authlogic field naming
+* Documentation updated
+
+== 1.0.0 released 2009-09-25
+
+* Initial release

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Paul Gallagher (tardate.com)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest

@@ -0,0 +1,20 @@
+CHANGELOG.rdoc
+MIT-LICENSE
+Manifest
+README.rdoc
+Rakefile
+authlogic_rpx.gemspec
+init.rb
+lib/authlogic_rpx.rb
+lib/authlogic_rpx/acts_as_authentic.rb
+lib/authlogic_rpx/helper.rb
+lib/authlogic_rpx/session.rb
+lib/authlogic_rpx/version.rb
+rails/init.rb
+test/acts_as_authentic_test.rb
+test/fixtures/users.yml
+test/libs/rails_trickery.rb
+test/libs/user.rb
+test/libs/user_session.rb
+test/session_test.rb
+test/test_helper.rb

data/README.rdoc

@@ -0,0 +1,436 @@
+= Authlogic RPX
+
+== Purpose
+
+Authlogic RPX is an Authlogic extension library that provides support for authentication using the RPX multi-authentication service offered by JanRain. To use RPX, you must first register your application at {RPX}[http://rpxnow.com/]. A free "Basic" account is available, in addition to paid enhanced versions. All work with Authlogic_RPX.  
+
+Key features and capabilities:
+* Auto-registration by default following RPX authentication (can be disabled if required)
+* Can allow users to enable RPX authentication for their existing password-enabled accounts
+* View helpers to assist with inserting login fragments in pages
+* Can co-exist with standard password authentication
+
+
+== Authlogic_RPX References
+
+*	<b>Authlogic_RPX gem repo:</b> [http://github.com/tardate/authlogic_rpx]
+*	<b>Authlogic_RPX issues and feedback:</b> [http://github.com/tardate/authlogic_rpx/issues]
+
+The demonstration Rails application is where you can see Authlogic_RPX in action:
+* <b>Live Demonstration Site:</b> [http://rails-authlogic-rpx-sample.heroku.com]
+* <b>Demonstration site source repository:</b> [http://github.com/tardate/rails-authlogic-rpx-sample]
+
+== Authlogic and RPX References
+
+*	<b>Authlogic documentation:</b> [http://rdoc.info/projects/binarylogic/authlogic]
+*	<b>Authlogic repo:</b> [http://github.com/binarylogic/authlogic]
+*	<b>RPX documentation:</b> [https://rpxnow.com/docs]
+*	<b>RPX_now gem repo:</b> [http://github.com/grosser/rpx_now]
+
+
+== Installing Authlogic RPX gem
+
+Three gems are required: authlogic, grosser-rpx_now, and tardate-authlogic_rpx. Install these as appropriate to your environment and preferences.
+
+Currently tested versions:
+* authlogic 2.1.1
+* grosser-rpx_now 0.5.10
+* tardate-authlogic_rpx 1.0.2
+
+
+=== 1. Direct gem installation
+
+  sudo gem install authlogic
+  sudo gem install grosser-rpx_now --source http://gems.github.com
+  sudo gem install tardate-authlogic_rpx --source http://gems.github.com
+
+
+=== 2. Using Rails config.gems
+
+Include in config/environment.rb:
+  
+  config.gem "authlogic"
+  config.gem "grosser-rpx_now", :lib => "rpx_now", :source => 'http://gems.github.com'
+  config.gem "tardate-authlogic_rpx", :lib => "authlogic_rpx", :source => 'http://gems.github.com'
+
+Then to install, run from the command line:
+
+  sudo rake gems:install
+
+
+=== 3. Using .gems file (e.g for heroku.com deployments)
+
+Include in RAILS_ROOT/.gems:
+  
+  authlogic
+  grosser-rpx_now --source gems.github.com
+  tardate-authlogic_rpx --source gems.github.com
+
+
+== Using Authlogic RPX
+
+<i>Note: in what follows, the user model is called User and the session controller takes the name UserSession (the authlogic convention). You are not restricted to these names - could be Member and MemberSession for example - but for simplicity, this documentation will stick to using the "User" convention.</i>
+
+Using Authlogic RPX is very similar to using standard authlogic, with the addition of just a few configuration options. So if you already have a project setup with authlogic, adding RPX support will be trivial.
+
+An important capability to be aware of is "auto registration". This means that when a user has logged in with RPX, if an account does not already exist in your application, it will be automatically created. That is, there is no separate/special "register" step for users to go through before just signing in. You can disable this if you need, but for most sites that use RPX as a primary authentication mechanism, this is probably what you want to happen.
+
+The main steps for enabling Authlogic RPX: 
+* 1. Enable RPX for your user model
+* 2. Add RPX configuration for the Authlogic session model
+* 3 Add custom user profile mapping (optional)
+* 4. Add application controller helpers: current_user, current_user_session
+* 5. Setup the Authlogic session controller
+* 6. Setup the Authlogic user controller
+* 7. Use view helpers to provide login links
+* 8. Allow users to "Add RPX" to existing accounts (optional)
+
+
+=== 1. Enable RPX for your user model
+
+The user model requires an additional field called "rpx_identifier". Creat a migration to add this. 
+You may need to remove database constraints on other fields if they will be unused in the RPX case (e.g. crypted_password and password_salt to make password authentication optional)
+
+  class AddUsersRpxIdentifier < ActiveRecord::Migration
+    def self.up
+      add_column :users, :rpx_identifier, :string
+      add_index :users, :rpx_identifier
+
+      change_column :users, :crypted_password, :string, :default => nil, :null => true
+      change_column :users, :password_salt, :string, :default => nil, :null => true
+      
+    end
+
+    def self.down
+      remove_column :users, :openid_identifier
+
+      [:crypted_password, :password_salt].each do |field|
+        User.all(:conditions => "#{field} is NULL").each { |user| user.update_attribute(field, "") if user.send(field).nil? }
+        change_column :users, field, :string, :default => "", :null => false
+      end
+    end
+  end
+
+The user model then needs to be tagged with "acts_as_authentic", and you must add rpx_identifier to the attr_accessible configuration (if you are using it)
+
+  class User < ActiveRecord::Base
+  	acts_as_authentic do |c|
+      c.my_config_option = my_value # for available options see documentation in: Authlogic::ActsAsAuthentic
+    end # block optional
+  	attr_accessible :username, :email, :password, :password_confirmation, :rpx_identifier
+  end
+
+{See the source for the sample user.rb}[http://github.com/tardate/rails-authlogic-rpx-sample/blob/master/app/models/user.rb].
+
+
+=== 2. Add RPX configuration for the Authlogic session model
+
+Authlogic provides a helper to create the session model:
+  
+  script/generate session user_session
+
+The minimum configuration required is to add your RPX_API_KEY:  
+
+  class UserSession < Authlogic::Session::Base
+  	rpx_key RPX_API_KEY
+  end
+
+Get an API key by registering your application at {RPX}[http://rpxnow.com/]. A free "Basic" account is available, in addition to paid enhanced versions. All work with Authlogic_RPX.
+
+You probably don't want to put your API key in directly. A recommended approach is to set the key as an environment variable, and then set it as a constant in config/environment.rb:
+  
+  RPX_API_KEY = ENV['RPX_API_KEY']
+
+Two additional RPX-specific session configuration options are available.
+* auto_register: enable/disable user auto-registration (enabled by default)
+* rpx_extended_info: enable/disable extended profile information in the RPX authentication (disabled by default)
+
+For example, to disable auto-registration and enable extended info:
+  
+  class UserSession < Authlogic::Session::Base
+  	rpx_key RPX_API_KEY
+  	auto_register false
+  	rpx_extended_info
+  end
+
+{See the source for the sample user_session.rb}[http://github.com/tardate/rails-authlogic-rpx-sample/blob/master/app/models/user_session.rb].
+
+=== 3. Add custom user profile mapping (optional)
+When users auto-register, profile data from RPX is available to be inserted in the user's record on your site. By default, authlogic_rpx will map the username and email fields.
+
+If you have other fields you want to map, you can provide your own implementation of the map_rpx_data method in the UserSession model. In that method, you will be updating the "self.attempted_record" object, with information from the "@rpx_data" object. See the {RPX documentation}[https://rpxnow.com/docs#profile_data] to find out about the set of information that is available. 
+
+  class UserSession < Authlogic::Session::Base
+  	rpx_key RPX_API_KEY
+  	rpx_extended_info
+  	
+  private
+  
+  	# map_rpx_data maps additional fields from the RPX response into the user object
+  	# override this in your session controller to change the field mapping
+  	# see https://rpxnow.com/docs#profile_data for the definition of available attributes
+  	#
+      def map_rpx_data
+		# map core profile data using authlogic indirect column names
+		self.attempted_record.send("#{klass.login_field}=", @rpx_data['profile']['preferredUsername'] ) if attempted_record.send(klass.login_field).blank?
+		self.attempted_record.send("#{klass.email_field}=", @rpx_data['profile']['email'] ) if attempted_record.send(klass.email_field).blank?
+
+		# map some other columns explicityl
+		self.attempted_record.fullname = @rpx_data['profile']['displayName'] if attempted_record.fullname.blank?
+  
+  		if rpx_extended_info?
+  			# map some extended attributes
+  		end
+  	end
+  	
+  end
+
+=== 4. Add application controller helpers: current_user, current_user_session
+
+We'll add current_user and current_user_session helpers. These can then be used in controllers and views to get a handle on the "current" logged in user.
+
+  class ApplicationController < ActionController::Base
+    helper :all # include all helpers, all the time
+    protect_from_forgery # See ActionController::RequestForgeryProtection for details
+  
+    # Scrub sensitive parameters from your log
+    filter_parameter_logging :password, :password_confirmation
+    
+    helper_method :current_user, :current_user_session
+    
+    private
+    
+  	def current_user_session
+  		return @current_user_session if defined?(@current_user_session)
+  		@current_user_session = UserSession.find
+  	end
+  
+  	def current_user
+  		return @current_user if defined?(@current_user)
+  		@current_user = current_user_session && current_user_session.record
+  	end
+  end
+
+{See the source for the sample user_session_controller.rb}[http://github.com/tardate/rails-authlogic-rpx-sample/blob/master/app/controllers/application_controller.rb].
+
+
+=== 5. Setup the Authlogic session controller
+
+If you don't already have a user session controller, create one. There are four actions of significance for authlogic_rpx:
+  
+  $ script/generate controller user_sessions index new create destroy
+
+{See the source for the sample user_session_controller.rb}[http://github.com/tardate/rails-authlogic-rpx-sample/blob/master/app/controllers/user_sessions_controller.rb].
+
+In config/routes.rb we can define the standard routes for this controller and two named routes for the main login/out (or singin/out if you prefer that terminology):
+
+  map.signin "signin", :controller => "user_sessions", :action => "new"
+  map.signout "signout", :controller => "user_sessions", :action => "destroy"
+  map.resources :user_sessions
+
+==== index
+This is where RPX will return to if the user cancelled the login process, so it needs to be handled. You probably just want to redirect the user to an appropriate alternative:
+  
+	def index
+		redirect_to current_user ? root_url : new_user_session_url
+	end
+
+==== new
+Typically used to render a login form
+
+	def new
+		@user_session = UserSession.new
+	end
+
+==== create
+This is where the magic happens for authentication. Authlogic hides all the underlying wiring, and you just need to "save" the session!
+
+Authlogic_rpx provides two additional methods that you might want to use to tailor you application behaviour:
+* new_registration? - if a new registration, e.g. force them to go via a registration follow-up page
+* registration_complete? - if registration details not complete, e.g. bounce the user over the profile editing page
+
+	def create
+		@user_session = UserSession.new(params[:user_session])
+		if @user_session.save
+			if @user_session.new_registration?
+				flash[:notice] = "Welcome! As a new user, please review your registration details before continuing.."
+				redirect_to edit_user_path( :current )
+			else
+				if @user_session.registration_complete?
+					flash[:notice] = "Successfully signed in."
+					redirect_back_or_default articles_path
+				else
+					flash[:notice] = "Welcome back! Please complete required registration details before continuing.."
+					redirect_to edit_user_path( :current )
+				end
+			end
+		else
+			flash[:error] = "Failed to login or register."
+			redirect_to new_user_session_path
+		end
+	end
+
+==== destroy
+The logout action..
+
+	def destroy
+		@user_session = current_user_session
+		@user_session.destroy if @user_session
+		flash[:notice] = "Successfully signed out."
+		redirect_to articles_path
+	end
+
+
+=== 6. Setup the Authlogic user controller
+
+The users controller handles the actual user creation and editing actions. In it's standard form, it looks like any other controller with an underlying ActiveRecord model.
+
+There are five basic actions to consider. If you don't already have a controller, create it:
+  
+  $ script/generate controller users new create edit show update
+
+{See the source for the sample users_controller.rb}[http://github.com/tardate/rails-authlogic-rpx-sample/blob/master/app/controllers/users_controller.rb].
+
+The users controller just needs standard routes defined in config/routes.rb:
+
+  map.resources :users
+  
+==== new
+Stock standard form for a user to register on the site. Only required if you will allow users to register without using RPX auto-registration (using standard password authentication).
+
+	def new
+		@user = User.new
+	end
+	
+==== create
+As for new, stock standard and only required if you will allow users to register without using RPX auto-registration.
+
+	def create
+		@user = User.new(params[:user])
+		if @user.save
+			flash[:notice] = "Successfully registered user."
+			redirect_to articles_path
+		else
+			render :action => 'new'
+		end
+	end
+	
+==== show
+Display's the user's profile. Uses the current_user helper that we'll include in the application controller.
+
+	def show
+		@user = current_user
+	end
+	
+==== edit
+Allows the user to edit their profile. Calling valid? will ensure any validation errors are highlighted. This can be relevant with RPX since auto-registration may not include all the profile data you want to make "mandatory" for normal users.
+
+	def edit
+		@user = current_user
+		@user.valid?
+	end
+
+==== update
+Handles the submission of the edit form. Again, uses the current_user helper that we'll include in the application controller.
+
+	def update
+		@user = current_user
+		@user.attributes = params[:user]
+		if @user.save
+			flash[:notice] = "Successfully updated user."
+			redirect_back_or_default articles_path
+		else
+			render :action => 'edit'
+		end
+	end
+
+
+=== 7. Use view helpers to provide login links
+
+So how to put a "login" link on your page? Two helper methods are provided:
+* <b>rpx_popup</b> helper to insert a link to pop-up RPX login
+* <b>rpx_embed</b> helper to insert an embedded iframe RPX login form
+
+Each takes an options hash:
+* <tt>link_text:</tt> text to use in the link (only used by rpx_popup)
+* <tt>app_name:</tt> name of the application (will be prepended to RPX domain and used in RPX dialogues)
+* <tt>return_url:</tt> url for the RPX callback (e.g. user_sessions_url)
+* <tt>add_rpx:</tt> Optional. If true, requests RPX callback to add to current session. Else runs normal authentication process (default). See "7. Allow users to "Add RPX" to existing accounts"
+
+For example, to insert a login link in a navigation bar is as simple as this:
+
+		&lt;div id="user_nav"&gt;
+			&lt;%= link_to "Home", root_path %&gt; |
+			&lt;% if current_user %&gt;
+				&lt;%= link_to "Profile", user_path(:current) %&gt; |
+				&lt;%= link_to "Sign out", signout_path %&gt;
+			&lt;% else %&gt;
+				&lt;%= rpx_popup( :link_text => "Register/Sign in with RPX..", :app_name => "rails-authlogic-rpx-sample", :return_url => user_sessions_url ) %>&gt;
+			&lt;% end %&gt;
+		&lt;/div&gt;
+
+=== 8. Allow users to "Add RPX" to existing accounts (optional)
+
+If you got this far and have a working application, you are ready to go, especially if you only plan to support RPX authentication.
+
+However, if you support other authentication methods (e.g. by password), you probably want the ability to let user's add RPX to an existing account. This is not possible by default, however adding it is simply a matter of providing another method on your user controller.
+
+The route may be called anything you like. Let's use "addrpxauth" for example. 
+
+	# This action has the special purpose of receiving an update of the RPX identity information
+	# for current user - to add RPX authentication to an existing non-RPX account.
+	# RPX only supports :post, so this cannot simply go to update method (:put)
+	def addrpxauth
+		@user = current_user
+		if @user.save
+			flash[:notice] = "Successfully added RPX authentication for this account."
+			render :action => 'show'
+		else
+			render :action => 'edit'
+		end
+	end
+
+{This is demonstrated in the sample users_controller.rb}[http://github.com/tardate/rails-authlogic-rpx-sample/blob/master/app/controllers/users_controller.rb].
+
+You'll note this is almost identical to the "update". The main difference is that it needs to be enabled for :post by RPX. In config/routes.rb:
+
+  map.addrpxauth "addrpxauth", :controller => "users", :action => "addrpxauth", :method => :post
+
+=== 9. There is no 9
+
+That's all there is. To see Authlogic_RPX in action, check out the demonstration Rails application:
+* <b>Live Demonstration Site:</b> [http://rails-authlogic-rpx-sample.heroku.com]
+* <b>Demonstration site source repository:</b> [http://github.com/tardate/rails-authlogic-rpx-sample]
+
+
+== Improving Authlogic_RPX: next steps; how to help
+
+Authlogic_RPX is open source and hosted on {github}[http://github.com/tardate/authlogic_rpx]. Developer's are welcome to fork and play - if you have improvements or bug fixes, just send a request to pull from your fork.
+
+If you have issues or feedback, please log them in the {issues list on github}[http://github.com/tardate/authlogic_rpx/issues]
+
+Some of the improvements currently on the radar:
+* Still figuring out how to write some good automated tests
+* Implement/verify support for RPX "paid" service features of their "Plus" and "Pro" accounts (to date, only tested with free RPX "Basic" account)
+* Add support for proxy/direct authentication (i.e. so you can programmatically "authenticate" as an existing user based on the RPX id)
+
+
+
+== Internals
+
+Some design principles:
+* Attempted to stay as close to binarylogic's "unobtrusive authentication" sensibility in Authlogic design
+* All direct RPX processing is handled in the AuthlogicRpx::Session class (not in the ActiveRecord model)
+* It uses the plug-in architecture introduced in Authlogic v2.0.
+
+
+
+== Kudos and Kopywrite
+
+Thanks to {binarylogic}[http://github.com/binarylogic] for cleaning up authentication in rails by creating Authlogic in the first place and offering it to the community.
+
+The idea of adding RPX support to authlogic is not new. Some early ideas were found in the following projects, although it was decided not to base this implementation on a fork of these, since the approaches varied considerably: 
+*	<b>http://github.com/hunter/authlogic_rpx</b> an initial start, based on authlogic_openid and using rpx_now
+*	<b>http://github.com/gampleman/authlogic_rpx/</b> similar, but including an implementation of the RPX api
+
+authlogic_rpx was created by Paul Gallagher (tardate.com) and released under the MIT license.

data/Rakefile

@@ -0,0 +1,20 @@
+ENV['RDOCOPT'] = "-S -f html -T hanna"
+
+require "rubygems"
+require "echoe"
+require File.dirname(__FILE__) << "/lib/authlogic_rpx/version"
+
+Echoe.new("authlogic_rpx") do |p|
+  p.version = AuthlogicRpx::Version::STRING
+  p.url = "http://github.com/tardate/authlogic_rpx"
+  p.summary = "Authlogic plug-in for RPX support"
+  p.description = "Authlogic extension/plugin that provides RPX (rpxnow.com) authentication support"
+
+  p.runtime_dependencies = ["authlogic >=2.1.1", "grosser-rpx_now >=0.5.10" ]
+  p.development_dependencies = []
+
+  p.author = "Paul Gallagher / tardate"
+  p.email  = 'gallagher.paul@gmail.com'
+
+  p.extra_deps = %w(authlogic >= 0)
+end

data/authlogic_rpx.gemspec

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{authlogic_rpx}
+  s.version = "1.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Paul Gallagher / tardate"]
+  s.date = %q{2009-10-02}
+  s.description = %q{Authlogic extension/plugin that provides RPX (rpxnow.com) authentication support}
+  s.email = %q{gallagher.paul@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "README.rdoc", "lib/authlogic_rpx.rb", "lib/authlogic_rpx/acts_as_authentic.rb", "lib/authlogic_rpx/helper.rb", "lib/authlogic_rpx/session.rb", "lib/authlogic_rpx/version.rb"]
+  s.files = ["CHANGELOG.rdoc", "MIT-LICENSE", "Manifest", "README.rdoc", "Rakefile", "authlogic_rpx.gemspec", "init.rb", "lib/authlogic_rpx.rb", "lib/authlogic_rpx/acts_as_authentic.rb", "lib/authlogic_rpx/helper.rb", "lib/authlogic_rpx/session.rb", "lib/authlogic_rpx/version.rb", "rails/init.rb", "test/acts_as_authentic_test.rb", "test/fixtures/users.yml", "test/libs/rails_trickery.rb", "test/libs/user.rb", "test/libs/user_session.rb", "test/session_test.rb", "test/test_helper.rb"]
+  s.homepage = %q{http://github.com/tardate/authlogic_rpx}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Authlogic_rpx", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{authlogic_rpx}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Authlogic plug-in for RPX support}
+  s.test_files = ["test/acts_as_authentic_test.rb", "test/session_test.rb", "test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<authlogic>, [">= 2.1.1"])
+      s.add_runtime_dependency(%q<grosser-rpx_now>, [">= 0.5.10"])
+    else
+      s.add_dependency(%q<authlogic>, [">= 2.1.1"])
+      s.add_dependency(%q<grosser-rpx_now>, [">= 0.5.10"])
+    end
+  else
+    s.add_dependency(%q<authlogic>, [">= 2.1.1"])
+    s.add_dependency(%q<grosser-rpx_now>, [">= 0.5.10"])
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + "/rails/init.rb"

data/lib/authlogic_rpx.rb

@@ -0,0 +1,8 @@
+require "authlogic_rpx/version"
+require "authlogic_rpx/acts_as_authentic"
+require "authlogic_rpx/session"
+require "authlogic_rpx/helper"
+
+ActiveRecord::Base.send(:include, AuthlogicRpx::ActsAsAuthentic)
+Authlogic::Session::Base.send(:include, AuthlogicRpx::Session)
+ActionController::Base.helper AuthlogicRpx::Helper

data/lib/authlogic_rpx/acts_as_authentic.rb

@@ -0,0 +1,94 @@
+# This module is responsible for adding RPX functionality to Authlogic. Checkout the README for more info and please
+# see the sub modules for detailed documentation.
+module AuthlogicRpx
+	# This module is responsible for adding in the RPX functionality to your models. It hooks itself into the
+	# acts_as_authentic method provided by Authlogic.
+	module ActsAsAuthentic
+		# Adds in the neccesary modules for acts_as_authentic to include and also disabled password validation if
+		# RPX is being used.
+		def self.included(klass)
+		  klass.class_eval do
+			extend Config
+			add_acts_as_authentic_module(Methods, :prepend)
+		  end
+		end
+
+		module Config
+		
+			# map_id is used to enable RPX identity mapping
+			# experimental - a feature of RPX paid accounts and not properly developed/tested yet
+			#
+			# * <tt>Default:</tt> false
+			# * <tt>Accepts:</tt> boolean
+			def map_id(value = false)
+				rw_config(:map_id, value, false)
+			end
+			alias_method :map_id=, :map_id
+
+		end
+		
+		module Methods
+		
+			# Set up some simple validations
+			def self.included(klass)
+				klass.class_eval do
+					validates_uniqueness_of :rpx_identifier, :scope => validations_scope, :if => :using_rpx?
+					validates_length_of_password_field_options validates_length_of_password_field_options.merge(:if => :validate_password_with_rpx?)
+					validates_confirmation_of_password_field_options validates_confirmation_of_password_field_options.merge(:if => :validate_password_with_rpx?)
+					validates_length_of_password_confirmation_field_options validates_length_of_password_confirmation_field_options.merge(:if => :validate_password_with_rpx?)
+					before_validation :adding_rpx_identifier
+					after_create :map_rpx_identifier
+				end
+			end
+
+			# support a block given to the save
+			def save(perform_validation = true, &block)
+				result = super perform_validation
+				yield(result) if block_given?
+				result
+			end
+
+			# test if account it using RPX authentication
+			def using_rpx?
+				!rpx_identifier.blank?
+			end
+
+			# test if account it using normal password authentication
+			def using_password?
+				!send(crypted_password_field).blank?
+			end
+
+		private
+			
+			def validate_password_with_rpx?
+				!using_rpx? && require_password?
+			end
+			
+			def adding_rpx_identifier
+				return true unless session_class && session_class.controller
+				new_rpx_id = session_class.controller.session['added_rpx_identifier']	
+				unless new_rpx_id.blank?
+					session_class.controller.session['added_rpx_identifier'] = nil		
+					self.rpx_identifier = new_rpx_id 
+				end
+				return true
+			end
+			
+			# experimental - a feature of RPX paid accounts and not properly developed/tested yet
+			def map_id?
+				self.class.map_id
+			end
+				
+			# experimental - a feature of RPX paid accounts and not properly developed/tested yet
+			def map_rpx_identifier
+				RPXNow.map(rpx_identifier, id) if using_rpx? && map_id?
+			end
+			
+			# experimental - a feature of RPX paid accounts and not properly developed/tested yet
+			def unmap_rpx_identifer
+				RPXNow.unmap(rpx_identifier, id) if using_rpx? && map_id?
+			end
+			
+		end
+	end
+end

data/lib/authlogic_rpx/helper.rb

@@ -0,0 +1,36 @@
+module AuthlogicRpx
+	module Helper
+
+		# helper to insert an embedded iframe RPX login
+		# takes options hash:
+		#   * <tt>app_name:</tt> name of the application (will be prepended to RPX domain and used in RPX dialogues)
+		#   * <tt>return_url:</tt> url for the RPX callback (e.g. user_sessions_url)
+		#   * <tt>add_rpx:</tt> if true, requests RPX callback to add to current session. Else runs normal authentication process (default)
+		def rpx_embed(options = {})
+			params = (
+				{ :authenticity_token => form_authenticity_token, :add_rpx => options[:add_rpx] }.collect { |n| "#{n[0]}=#{ u(n[1]) }" if n[1] }
+			).compact.join('&')
+			RPXNow.embed_code(options[:app_name], u( options[:return_url] + '?' + params ) )
+		end
+
+		# helper to insert a link to pop-up RPX login
+		# takes options hash:
+		#   * <tt>link_text:</tt> text to use in the link
+		#   * <tt>app_name:</tt> name of the application (will be prepended to RPX domain and used in RPX dialogues)
+		#   * <tt>return_url:</tt> url for the RPX callback (e.g. user_sessions_url)
+		#   * <tt>add_rpx:</tt> if true, requests RPX callback to add to current session. Else runs normal authentication process (default)
+		def rpx_popup(options = {})
+			params = (
+				{ :authenticity_token => form_authenticity_token, :add_rpx => options[:add_rpx] }.collect { |n| "#{n[0]}=#{ u(n[1]) }" if n[1] }
+			).compact.join('&')
+			RPXNow.popup_code(
+				options[:link_text], 
+				options[:app_name],
+				u( options[:return_url] + '?' + params ),
+				:unobtrusive=>true
+				) 
+				# NB: i18n considerations? supports a :language parameter (not tested)
+		end
+
+	end
+end

data/lib/authlogic_rpx/session.rb

@@ -0,0 +1,177 @@
+module AuthlogicRpx
+	# This module is responsible for adding all of the RPX goodness to the Authlogic::Session::Base class.
+	module Session
+		# Add a simple rpx_identifier attribute and some validations for the field.
+		def self.included(klass)
+			klass.class_eval do
+				extend Config
+				include Methods
+			end
+		end
+		
+		module Config
+		  
+			def find_by_rpx_identifier_method(value = nil)
+				rw_config(:find_by_rpx_identifier_method, value, :find_by_rpx_identifier)
+			end
+			alias_method :find_by_rpx_identifier_method=, :find_by_rpx_identifier_method
+
+			# Auto Register is enabled by default. 
+			# Add this in your Session object if you need to disable auto-registration via rpx
+			#
+			def auto_register(value=true)
+				auto_register_value(value)
+			end
+			def auto_register_value(value=nil)
+				rw_config(:auto_register,value,true)
+			end      
+			alias_method :auto_register=,:auto_register
+
+			# Add this in your Session object to set the RPX API key 
+			# RPX won't work without the API key. Set it here if not already set in your app configuration.
+			#
+			def rpx_key(value=nil)
+				rpx_key_value(value)
+			end
+			def rpx_key_value(value=nil)
+				if ! inheritable_attributes.include?(:rpx_key) 
+					RPXNow.api_key = value 
+				end
+				rw_config(:rpx_key,value,false)
+			end
+			alias_method :rpx_key=,:rpx_key
+
+			# Add this in your Session object to set whether RPX returns extended user info 
+			# By default, it will not, which is enough to get username, name, email and the rpx identified
+			# if you want to map additional information into your user details, you can request extended
+			# attributes (though not all providers give them - see the RPX docs)
+			#
+			def rpx_extended_info(value=true)
+				rpx_extended_info_value(value)
+			end
+			def rpx_extended_info_value(value=nil)
+				rw_config(:rpx_extended_info,value,false)
+			end
+			alias_method :rpx_extended_info=,:rpx_extended_info
+
+		end
+		
+		module Methods
+		  
+			def self.included(klass)
+				klass.class_eval do
+					attr_accessor :new_registration
+					attr_accessor :rpx_identifier
+					attr_accessor :rpx_data
+					after_persisting :add_rpx_identifier, :if => :adding_rpx_identifier?
+					validate :validate_by_rpx, :if => :authenticating_with_rpx?
+				end
+			end
+		  
+			# Determines if the authenticated user is also a new registration.
+			# For use in the session controller to help direct the most appropriate action to follow.
+			# 
+			def new_registration?
+				new_registration
+			end
+			
+			# Determines if the authenticated user has a complete registration (no validation errors)
+			# For use in the session controller to help direct the most appropriate action to follow.
+			# 
+			def registration_complete?
+				attempted_record && attempted_record.valid?
+			end
+
+		private
+			def authenticating_with_rpx?
+				controller.params[:token] && !controller.params[:add_rpx]
+			end
+
+			def find_by_rpx_identifier_method
+				self.class.find_by_rpx_identifier_method
+			end
+
+			# Tests if auto_registration is enabled (on by default)
+			#
+			def auto_register?
+				self.class.auto_register_value
+			end
+
+			# Tests if rpx_extended_info is enabled (off by default)
+			#
+			def rpx_extended_info?
+				self.class.rpx_extended_info_value
+			end
+
+			def adding_rpx_identifier?
+				controller.params[:token] && controller.params[:add_rpx]
+			end
+			
+			# the main RPX magic. At this pont, a session is being validated and we know RPX identifier
+			# has been provided. We'll callback to RPX to verify the token, and authenticate the matching 
+			# user. 
+			# If no user is found, and we have auto_register enabled (default) this method will also 
+			# create the user registration stub.
+			#
+			# On return to the controller, you can test for new_registration? and registration_complete?
+			# to determine the most appropriate action
+			#
+			def add_rpx_identifier
+				data = RPXNow.user_data(controller.params[:token])
+				controller.session['added_rpx_identifier'] = data[:identifier] if data
+			end
+			
+			# the main RPX magic. At this pont, a session is being validated and we know RPX identifier
+			# has been provided. We'll callback to RPX to verify the token, and authenticate the matching 
+			# user. 
+			# If no user is found, and we have auto_register enabled (default) this method will also 
+			# create the user registration stub.
+			#
+			# On return to the controller, you can test for new_registration? and registration_complete?
+			# to determine the most appropriate action
+			#
+			def validate_by_rpx
+				@rpx_data = RPXNow.user_data(controller.params[:token], :extended=> rpx_extended_info? ) {|raw| raw }
+				# If we don't have a valid sign-in, give-up at this point
+				if @rpx_data.nil?
+					errors.add_to_base("Authentication failed. Please try again.")
+					return false
+				end
+				rpx_id = @rpx_data['profile']['identifier']
+				if rpx_id.blank?
+					errors.add_to_base("Authentication failed. Please try again.")
+					return false
+				end		
+				
+				self.attempted_record = klass.send(find_by_rpx_identifier_method, rpx_id)
+				
+				# so what do we do if we can't find an existing user matching the RPX authentication..
+				if !attempted_record
+					if auto_register?   
+						self.attempted_record = klass.new( :rpx_identifier=> rpx_id )     
+						map_rpx_data
+						# save the new user record - without session maintenance else we get caught in a self-referential hell,
+						# since both session and user objects invoke each other upon save
+						self.new_registration=true
+						self.attempted_record.save_without_session_maintenance
+					else
+						errors.add_to_base("We did not find any accounts with that login. Enter your details and create an account.")
+						return false
+					end
+				end
+				
+			end
+
+			# map_rpx_data maps additional fields from the RPX response into the user object
+			# override this in your session controller to change the field mapping
+			# see https://rpxnow.com/docs#profile_data for the definition of available attributes
+			#
+			def map_rpx_data
+				self.attempted_record.send("#{klass.login_field}=", @rpx_data['profile']['preferredUsername'] ) if attempted_record.send(klass.login_field).blank?
+				self.attempted_record.send("#{klass.email_field}=", @rpx_data['profile']['email'] ) if attempted_record.send(klass.email_field).blank?
+			end
+	
+		end
+		
+	end
+end

data/lib/authlogic_rpx/version.rb

@@ -0,0 +1,51 @@
+module AuthlogicRpx
+  # A class for describing the current version of a library. The version
+  # consists of three parts: the +major+ number, the +minor+ number, and the
+  # +tiny+ (or +patch+) number.
+  class Version
+    include Comparable
+  
+    # A convenience method for instantiating a new Version instance with the
+    # given +major+, +minor+, and +tiny+ components.
+    def self.[](major, minor, tiny)
+      new(major, minor, tiny)
+    end
+
+    attr_reader :major, :minor, :tiny
+
+    # Create a new Version object with the given components.
+    def initialize(major, minor, tiny)
+      @major, @minor, @tiny = major, minor, tiny
+    end
+
+    # Compare this version to the given +version+ object.
+    def <=>(version)
+      to_i <=> version.to_i
+    end
+
+    # Converts this version object to a string, where each of the three
+    # version components are joined by the '.' character. E.g., 2.0.0.
+    def to_s
+      @to_s ||= [@major, @minor, @tiny].join(".")
+    end
+
+    # Converts this version to a canonical integer that may be compared
+    # against other version objects.
+    def to_i
+      @to_i ||= @major * 1_000_000 + @minor * 1_000 + @tiny
+    end
+    
+    def to_a
+      [@major, @minor, @tiny]
+    end
+
+    MAJOR = 1
+    MINOR = 0
+    TINY  = 2
+
+    # The current version as a Version instance
+    CURRENT = new(MAJOR, MINOR, TINY)
+    # The current version as a String
+    STRING = CURRENT.to_s
+  end
+end

data/rails/init.rb

@@ -0,0 +1 @@
+require "authlogic_rpx"

data/test/acts_as_authentic_test.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class ActsAsAuthenticTest < ActiveSupport::TestCase
+
+end

data/test/libs/rails_trickery.rb

@@ -0,0 +1,41 @@
+# The only reason I am doing all of this non sense is becuase the openid_authentication requires that
+# these constants be present. The only other alternative is to use an entire rails application for testing
+# which is a little too overboard for this, I think.
+
+RAILS_ROOT = ''
+
+class ActionController < Authlogic::TestCase::MockController
+  class Request < Authlogic::TestCase::MockRequest
+    def request_method
+      ""
+    end
+  end
+  
+  def root_url
+    ''
+  end
+  
+  def request
+    return @request if defined?(@request)
+    super
+    # Rails does some crazy s#!t with the "method" method. If I don't do this I get a "wrong arguments (0 for 1) error"
+    @request.class.class_eval do
+      def method
+        nil
+      end
+    end
+    @request
+  end
+  
+  def url_for(*args)
+    ''
+  end
+  
+  def redirecting_to
+    @redirect_to
+  end
+  
+  def redirect_to(*args)
+    @redirect_to = args
+  end
+end

data/test/libs/user.rb

@@ -0,0 +1,3 @@
+class User < ActiveRecord::Base
+  acts_as_authentic
+end

data/test/libs/user_session.rb

@@ -0,0 +1,2 @@
+class UserSession < Authlogic::Session::Base
+end

data/test/session_test.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class SessionTest < ActiveSupport::TestCase
+
+end

data/test/test_helper.rb

@@ -0,0 +1,61 @@
+require "test/unit"
+require "rubygems"
+require "ruby-debug"
+require "active_record"
+
+ActiveRecord::Schema.verbose = false
+ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :dbfile => ":memory:")
+ActiveRecord::Base.configurations = true
+ActiveRecord::Schema.define(:version => 1) do
+  
+  create_table :users do |t|
+    t.datetime  :created_at
+    t.datetime  :updated_at
+    t.integer   :lock_version, :default => 0
+    t.string    :login
+    t.string    :crypted_password
+    t.string    :password_salt
+    t.string    :persistence_token
+    t.string    :single_access_token
+    t.string    :perishable_token
+    t.string    :rpx_identifier
+    t.string    :email
+    t.string    :first_name
+    t.string    :last_name
+    t.integer   :login_count, :default => 0, :null => false
+    t.integer   :failed_login_count, :default => 0, :null => false
+    t.datetime  :last_request_at
+    t.datetime  :current_login_at
+    t.datetime  :last_login_at
+    t.string    :current_login_ip
+    t.string    :last_login_ip
+  end
+end
+
+require "active_record/fixtures"
+require "openid"
+require File.dirname(__FILE__) + "/../../authlogic/lib/authlogic"
+require File.dirname(__FILE__) + "/../../authlogic/lib/authlogic/test_case"
+require File.dirname(__FILE__) + "/libs/rails_trickery"
+require File.dirname(__FILE__) + '/libs/user'
+require File.dirname(__FILE__) + '/libs/user_session'
+
+class ActiveSupport::TestCase
+  include ActiveRecord::TestFixtures
+  self.fixture_path = File.dirname(__FILE__) + "/fixtures"
+  self.use_transactional_fixtures = false
+  self.use_instantiated_fixtures  = false
+  self.pre_loaded_fixtures = false
+  fixtures :all
+  setup :activate_authlogic
+  
+  private
+    def activate_authlogic
+      Authlogic::Session::Base.controller = controller
+    end
+    
+    def controller
+      @controller ||= Authlogic::TestCase::ControllerAdapter.new(ActionController.new)
+    end
+    
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification 
+name: authlogic_rpx
+version: !ruby/object:Gem::Version 
+  version: 1.0.2
+platform: ruby
+authors: 
+- Paul Gallagher / tardate
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-02 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: authlogic
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.1.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: grosser-rpx_now
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.10
+    version: 
+description: Authlogic extension/plugin that provides RPX (rpxnow.com) authentication support
+email: gallagher.paul@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- README.rdoc
+- lib/authlogic_rpx.rb
+- lib/authlogic_rpx/acts_as_authentic.rb
+- lib/authlogic_rpx/helper.rb
+- lib/authlogic_rpx/session.rb
+- lib/authlogic_rpx/version.rb
+files: 
+- CHANGELOG.rdoc
+- MIT-LICENSE
+- Manifest
+- README.rdoc
+- Rakefile
+- authlogic_rpx.gemspec
+- init.rb
+- lib/authlogic_rpx.rb
+- lib/authlogic_rpx/acts_as_authentic.rb
+- lib/authlogic_rpx/helper.rb
+- lib/authlogic_rpx/session.rb
+- lib/authlogic_rpx/version.rb
+- rails/init.rb
+- test/acts_as_authentic_test.rb
+- test/fixtures/users.yml
+- test/libs/rails_trickery.rb
+- test/libs/user.rb
+- test/libs/user_session.rb
+- test/session_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/tardate/authlogic_rpx
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Authlogic_rpx
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: authlogic_rpx
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Authlogic plug-in for RPX support
+test_files: 
+- test/acts_as_authentic_test.rb
+- test/session_test.rb
+- test/test_helper.rb