thincloud-authentication 0.5.1 → 0.6.0

data/README.md

@@ -82,6 +82,16 @@ Thincloud::Authentication.configure do |config|
 end
 ```
 
+### Cookies
+
+Set the `cookie_options` option to customize the options that get passed to the authentication cookies:
+
+```ruby
+Thincloud::Authentication.configure do |config|
+  config.cookie_options = { secure: true, domain: :all }
+end
+```
+
 
 ### Additional provider strategies
 
@@ -146,10 +156,20 @@ You can customize the paths used to redirect users after login, logout, registra
 * `after_logout_path` is used after the user logs out.
 * `after_registration_path` is used after the user registers.
 * `after_verification_path` is used after the user verifies their email.
+* `after_password_update_path` is used after the user updates their password.
+
+### Working with Identities
+
+Thincloud Authentication provides a few service objects to assist with creating and updating Identities:
+
+* `CreateInvitationForUser.call(user, name: "Test Name", email: "test@test.com")` is used to create a new Identity for a user and send an email with an invitation URL which allows the user to choose a password.
+* `UpdateIdentityPassword.call(identity, password: "s3kr1tz!", password_confirmation: "s3kr1tz!")` is used to update the password for an existing Identity.
+
+Both of the methods above will return `true` or `false`.
+
 
 ## TODO
 
-* Add "forgot password" functionality
 * Add multiple, configurable strategy options
 * Add a configuration option to customize the mailers
 

data/app/mailers/thincloud/authentication/invitations_mailer.rb

@@ -0,0 +1,12 @@
+module Thincloud::Authentication
+  # Public: Email methods for sending invitations
+  class InvitationsMailer < ActionMailer::Base
+    default from: Thincloud::Authentication.configuration.mailer_sender
+
+    # New invitation notification
+    def new_invitation(identity_id)
+      @identity = Identity.find(identity_id)
+      mail to: @identity.email, subject: "New account invitation"
+    end
+  end
+end

data/app/services/thincloud/authentication/create_invitation_for_user.rb

@@ -0,0 +1,18 @@
+module Thincloud::Authentication
+  # Public: Execute the workflow steps to create and identity and send an
+  # invitation email
+  class CreateInvitationForUser
+
+    def self.call(user, params)
+      identity = Identity.create!(user: user, name: params[:name],
+                                  email: params[:email], password_digest: 0)
+      Identity.verify!(identity.verification_token)
+      identity.generate_password_token!
+      InvitationsMailer.new_invitation(identity.id).deliver
+      true
+    rescue ActiveRecord::RecordInvalid
+      false
+    end
+
+  end
+end

data/app/views/thincloud/authentication/invitations_mailer/new_invitation.html.erb

@@ -0,0 +1,3 @@
+To accept the invitation and choose a password, click the URL below.
+
+<%= invitation_url(@identity.password_reset_token) %>

data/config/routes.rb

@@ -11,6 +11,7 @@ Thincloud::Authentication::Engine.routes.draw do
   get "verify/:token", to: "registrations#verify", as: "verify_token"
 
   resources :passwords, only: [:new, :edit, :create, :update]
+  get "invitations/:id", to: "passwords#edit", as: "invitation"
 
   root to: "sessions#new"
 end

data/lib/thincloud/authentication/authenticatable_controller.rb

@@ -52,7 +52,7 @@ module Thincloud
           value: user.id,
           secure: request.ssl?,
           httponly: true
-        }
+        }.merge(Thincloud::Authentication.configuration.cookie_options)
       end
 
       # Protected: Clear the session of an authenticated user.

data/lib/thincloud/authentication/configuration.rb

@@ -11,12 +11,13 @@ module Thincloud
 
     # Public: Configuration options for the Thincloud::Authentication module
     class Configuration
-      attr_accessor :layout, :providers, :mailer_sender
+      attr_accessor :layout, :providers, :mailer_sender, :cookie_options
 
       def initialize
         @layout = "application"
         @providers = {}
         @mailer_sender = "app@example.com"
+        @cookie_options = {}
       end
     end
   end

data/lib/thincloud/authentication/version.rb

@@ -1,5 +1,5 @@
 module Thincloud
   module Authentication
-    VERSION = "0.5.1"
+    VERSION = "0.6.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: thincloud-authentication
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-06 00:00:00.000000000 Z
+date: 2013-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -106,11 +106,14 @@ files:
 - app/controllers/thincloud/authentication/registrations_controller.rb
 - app/controllers/thincloud/authentication/sessions_controller.rb
 - app/helpers/thincloud/authentication/registrations_helper.rb
+- app/mailers/thincloud/authentication/invitations_mailer.rb
 - app/mailers/thincloud/authentication/passwords_mailer.rb
 - app/mailers/thincloud/authentication/registrations_mailer.rb
 - app/models/thincloud/authentication/identity.rb
+- app/services/thincloud/authentication/create_invitation_for_user.rb
 - app/services/thincloud/authentication/password_reset_workflow.rb
 - app/services/thincloud/authentication/update_identity_password.rb
+- app/views/thincloud/authentication/invitations_mailer/new_invitation.html.erb
 - app/views/thincloud/authentication/layouts/application.html.erb
 - app/views/thincloud/authentication/passwords/edit.html.erb
 - app/views/thincloud/authentication/passwords/new.html.erb
@@ -147,7 +150,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3741516582425724511
+      hash: 2368003791290441844
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -156,7 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3741516582425724511
+      hash: 2368003791290441844
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23