rodauth-become_account 0.2.1-jruby

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e88d2e9232d1f0f7cda79e3f9a96ce89161448db
+  data.tar.gz: f8e5b9a6a3cb66ca8d50cafef1796acf8fc63219
+SHA512:
+  metadata.gz: 676b3e29197247523bc9970cc8870701b241ce035dcbefedd8886f1065ce85dab34b70dbeaba35c68c7bdc2eb4b13c60895853ea37154126cacfd2253a2829ae
+  data.tar.gz: 8f31025150728da04577d459c08550b65786990786028274ca70699fa0eb20e6bdc666584b384823b05005e9bbe144a31c57df657a54dfa3b430c8cbfdc47800

data/README.md

@@ -0,0 +1,100 @@
+# Become Account feature for Rodauth
+
+This Rodauth feature allows you to easily switch into another Rodauth account,
+without requiring that specific accounts password.
+
+A nice bonus is that it remembers your original account, so when you log out of
+the temporary account, you're logged back in as you.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "rodauth-become_account"
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rodauth-become_account
+
+## Usage
+
+To use the become account feature requires two steps.
+
+The first is to enable the feature:
+
+```ruby
+class App < Roda
+  plugin :rodauth do
+    enable :become_account
+  end
+end
+```
+
+And the second is to setup a route to become an account:
+
+```ruby
+class App < Roda
+  plugin :rodauth do
+    enable :become_account
+  end
+
+  route do |r|
+    r.is "become", :id do |id|
+      # Authenticate the request to allow this action.
+      #
+      # Can be done multiple ways. For this example, we're just going to allow
+      # all become_account actions if running in development mode.
+      #
+      # You want to ensure you protect this route somehow.
+      if ENV["RACK_ENV"] != "development"
+        r.halt([401, { "Content-Type" => "text/html" }, ["Access denied"]])
+      end
+
+      # Perform your account lookup.
+      account = DB[:accounts][id: id.to_i]
+
+      # Optional.
+      flash[:notice] = "You've successfully became #{account[:email]}"
+
+      # Switch accounts using the become_account feature.
+      rodauth.become_account(account)
+    end
+  end
+end
+```
+
+## Edgecases
+
+It's possible that 2-factor authentication will cause issues becoming users who
+have that feature enabled. If you experience that issue, open a discussion so
+we can possibly work around it.
+
+## Where's my routes?
+
+Most of Rodauth's features enable routes by default, allowing you to get up and
+running immediately. I wanted to do that with this feature, but I didn't want to
+risk exposing a feature to become any-account without any forethought.
+
+So with that said, you need to implement your own route that allows an account
+to become another account.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/adam12/rodauth-become_account.
+
+I love pull requests! If you fork this project and modify it, please ping me to see
+if your changes can be incorporated back into this project.
+
+That said, if your feature idea is nontrivial, you should probably open an issue to
+[discuss it](http://www.igvita.com/2011/12/19/dont-push-your-pull-requests/)
+before attempting a pull request.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/rodauth/features/become_account.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+module Rodauth
+  Feature.define(:become_account) do
+    depends :login, :logout
+
+    auth_value_method :previous_session_key, :previous_account_id
+
+    def logout_redirect
+      return login_redirect if session[session_key]
+
+      super
+    end
+
+    def become_account(account)
+      session[previous_session_key] = session[session_key]
+      account_from_login(account[login_column])
+      update_session
+    end
+
+    def update_session
+      previous_session_value = session[previous_session_key]
+
+      super
+
+      session[previous_session_key] = previous_session_value if previous_session_value
+    end
+
+    def clear_session
+      previous_session_value = session[previous_session_key]
+
+      super
+
+      session[session_key] = previous_session_value if previous_session_value
+    end
+  end
+end

metadata

@@ -0,0 +1,213 @@
+--- !ruby/object:Gem::Specification
+name: rodauth-become_account
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: jruby
+authors:
+- Adam Daniels
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2017-04-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  name: rodauth
+  prerelease: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  name: roda
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  name: minitest
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  name: rake
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  name: rubygems-tasks
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  name: rack-test
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  name: tilt
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: rack_csrf
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: bcrypt
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: sequel
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: capybara
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: jdbc-sqlite3
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email: adam@mediadrive.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/rodauth/features/become_account.rb
+homepage: https://github.com/adam12/rodauth-become_account
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project:
+rubygems_version: 2.6.8
+signing_key:
+specification_version: 4
+summary: Easily switch Rodauth accounts
+test_files: []