rodauth-become_account 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ef061930c514ec2c3167f3f26b28d386a07437d1
+  data.tar.gz: becf01ebb577357461afdc85989b245ab70973f7
+SHA512:
+  metadata.gz: 9f53f92a0a22c12f906eb8f858e4557c30a053e68f6cbcbad05d9a3670b396968f6c7e515296742fe92b50f51abbc8545a3da5236bd1d49fb28643cf9fa49a89
+  data.tar.gz: 56fba42a83c1385ea171634986e16984c3299456ce98ee1f2b2c16cfb39427bcbe2cebe174c4e3299278992c14581d62f35909099a6d2d3423ebc29c48218905

data/README.md

@@ -0,0 +1,87 @@
+# 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|
+      # Perform your account lookup
+      account = DB[:accounts][id: id.to_i]
+      # Optionally
+      flash[:notice] = "You've successfully became #{account[:email]}"
+      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.1.0
+platform: ruby
+authors:
+- Adam Daniels
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-04-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rodauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: roda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rack_csrf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bcrypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  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: []