AnyLogin Gem

Description

Demo available on: https://any-login.herokuapp.com (source code for demo https://github.com/igorkasyanchuk/any_login_test)

Video Demo: https://youtu.be/978DlHvufSY

AnyLogin is created to speedup development process and allow developer's quickly login as any user in DB.

Give it a try and if you like it share with friends. In case you have any suggestions please feel free to contact me.

Requirements

Ruby: 1.9.3, 2.X, Rails: >= 4.0. Works in pair with Devise, Authlogic, Clearance or Sorcery gems.

Installation

List Add to your Gemfile:
```
gem 'any_login'
```
Execute in console:
```
bundle install
```
In application layout (for example app/views/layouts/application.html.erb) add in the bottom of the page:
```
<%= any_login_here %>
```
Open your app and on the bottom left corner you will see semi-transparent user icon. Click on it and now you can select any user to login without password.

Integrations

Devise

By default doesn't require any additional steps to make it works with Devise gem. If you have model User everything should works fine. In case you have other model you need to set it in options (see Customization section).

Authlogic

By default doesn't require any additional steps to make it works with Authlogic gem. If you have model User and you have current_user method in application controller everything should works fine. In case you have other model you need to set it in options (see Customization section).

Clearance

By default doesn't require any additional steps to make it works with Clearance gem. If you have model User everything should works fine. In case you have other model you need to set it in options (see Customization section).

Sorcery

By default doesn't require any additional steps to make it works with Sorcery gem. If you have model User everything should works fine. In case you have other model you need to set it in options (see Customization section).

Customization

If you want to customize gem run in console:

rails g any_login initializer

If will create file config/initializers/any_login.rb.

Options

enabled - enable of disable gem (by default this gem is enabled only in development mode).
klass_name - class name for "User" object. Default to User.
collection_method - method which returns collection of users. Sample: .all, .active, .admins, .groupped_users. Value is a simple. Default to :all.
name_method - default value is proc { |e| [e.email, e.id] }. You can change label for select in dropdown. For example you can add roles, permissions and any other important information.
limit - limit number of records in dropdown. Default 10. You can put :none if you don't want to limit number of users for select.
redirect_path_after_login - redirect user to path. Default is :root_path.
login_on - you can enable login with select field, ID input or both. Default: :both.
position - position of any_login box on page. Possible values: top_left, top_right, bottom_left, bottom_right. Default: bottom_left.
login_button_label - login button label.
select_prompt - select prompt message.
auto_show - automatically show any_login box.
http_basic_authentication_enabled - Enable HTTP_BASIC authentication.
http_basic_authentication_user_name - HTTP_BASIC authentication user name.
http_basic_authentication_password - HTTP_BASIC authentication password.
verify_access_proc - controller based access (condition on request.remote_ip, current_user, etc.)

Advanced Options

If you want to add collection grouped for example by role you can do it with:

    def self.groped_collection_by_role
      {
        'admin' => User.limit(10),
        'moderator' => User.limit(10),
        'user' => User.limit(10)
      }
    end

Or another sample:

    # Initializer
    config.collection_method = :grouped_users
    # # to format user name in dropdown list
    config.name_method = :any_login_name    
 
    # User class
    def any_login_name
      [full_name + ' - ' + email + " Domains: #{domains.collect(&:short_code).join(',').presence || 'none'}; Role: #{role}; ID: #{id}", id]
    end
  
    def self.grouped_users
      Organization.ordered.includes(:employees).inject({}) do |res, org|
        res[org.name] = org.employees.ordered.includes([:domains, :organization])
        res
      end
    end

And in config/initializers/any_login.rb add config.collection_method = :groped_collection_by_role.

Production

If you want to completely disable gem in production add following code in your config/environments/production.rb file.

AnyLogin.setup do |config|
   config.enabled = false
end

You can also try to debug you application in production and secure any_login with HTTP_BASIC authentication. See Options sections for more details.

Future Plans

Add tests
Add support for more authentication gems like Devise, Authlogic, Clearance (restful_authentication, monban, letmein)

alextakitani/any_login