authegy 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d07d7606ab2766ec64bdec8b4755b033c697bc5d6eccda20f39d8fc308c2489d
+  data.tar.gz: 51685f9e90d411e8514d14c795ef5a6a2b57a0e9234f339ebf591c0ebe03718e
+SHA512:
+  metadata.gz: 05a858a671eab9e43fc0c7bf49d77e8abe1ddf81f92c7f60ee71041d0c33e3e4ac0b12abb34ee6282192f16717b196858139583519f4ed1be06abd30dc129403
+  data.tar.gz: cc880a11cbaff90d3e037f6058e215f5cfbdf9880df258df0d0db6d0c1ffc1703bf86207e0a42fbdfc2f278e9aeab52ade142d0966b0c6d4d72575ea8f76fdc0

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Authegy Changelog
+
+## Version 0.0.1
+
+- Initial Implementation

data/README.md

@@ -0,0 +1,70 @@
+# Authegy
+
+The Authegy gem is a library that combines several useful ruby libraries to
+provide an opinionated authentication and role-based authorization models for
+your rails apps.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'authegy'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install authegy
+
+## Usage
+
+### Basic Use Case: The User & Role models
+
+- Use only a single "User" class, with several roles associated to it - instead
+  of having multiple "user" classes, which tend to have duplicated code &
+  functionality between them.
+- Roles can also be optionally associated to different "Resource" models, so we
+  can limit the authorization to certain objects. Examples:
+  - "User 2" is an "Administrator" of "Website 2" (so he/she can change the
+    Website 2's URL)
+  - "User 3" is a "Procurement Manager" of "Company 4" (so he/she can place
+    orders on behalf of the Company 4)
+
+![Base Use Case](docs/use-cases/base-use-case.svg)
+
+
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake spec` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and tags, and push the `.gem` file to
+[rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/vovimayhem/authegy. This project is intended to be a safe,
+welcoming space for collaboration, and contributors are expected to adhere to
+the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the A2 project’s codebases, issue trackers, chat rooms
+and mailing lists is expected to follow the
+[Code of Conduct](https://github.com/vovimayhem/authegy/blob/master/CODE_OF_CONDUCT.md).

data/app/assets/config/authegy_manifest.js

@@ -0,0 +1,2 @@
+//= link_directory ../javascripts/authegy .js
+//= link_directory ../stylesheets/authegy .css

data/app/assets/javascripts/authegy/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file. JavaScript code in this file should be added after the last require_* statement.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require rails-ujs
+//= require activestorage
+//= require_tree .

data/app/assets/stylesheets/authegy/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/authegy/application_controller.rb

@@ -0,0 +1,5 @@
+module Authegy
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception
+  end
+end

data/app/helpers/authegy/application_helper.rb

@@ -0,0 +1,4 @@
+module Authegy
+  module ApplicationHelper
+  end
+end

data/app/jobs/authegy/application_job.rb

@@ -0,0 +1,4 @@
+module Authegy
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/authegy/application_mailer.rb

@@ -0,0 +1,6 @@
+module Authegy
+  class ApplicationMailer < ActionMailer::Base
+    default from: 'from@example.com'
+    layout 'mailer'
+  end
+end

data/app/models/authegy/application_record.rb

@@ -0,0 +1,5 @@
+module Authegy
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/views/layouts/authegy/application.html.erb

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Authegy</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= stylesheet_link_tag    "authegy/application", media: "all" %>
+  <%= javascript_include_tag "authegy/application" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/lib/authegy.rb

@@ -0,0 +1,27 @@
+require 'active_support/dependencies'
+require 'devise'
+require 'authegy/engine'
+
+module Authegy
+  autoload :Authorizable,   'authegy/authorizable'
+
+  autoload :Person,         'authegy/models/person'
+  autoload :RoleAssignment, 'authegy/models/role_assignment'
+  autoload :Role,           'authegy/models/role'
+  autoload :User,           'authegy/models/user'
+
+  autoload :ControllerHelpers, 'authegy/controller_helpers'
+
+  def self.extract_resource_attributes(resource_type_or_instance)
+    return { resource_type: resource_type_or_instance } \
+      if resource_type_or_instance.is_a? String
+
+    return { resource_type: resource_type_or_instance.name } \
+      if resource_type_or_instance.is_a? Class
+
+    return {
+      resource_type: resource_type_or_instance.class.name,
+      resource_id: resource_type_or_instance.id
+    } if resource_type_or_instance.respond_to? :id
+  end
+end

data/lib/authegy/authorizable.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Authegy
+  module Authorizable
+    extend ActiveSupport::Concern
+
+    included do
+      has_many :role_assignments,
+               class_name: '::RoleAssignment',
+               inverse_of: :actor,
+               foreign_key: :actor_id
+
+      has_many :assigned_roles,
+               -> { distinct },
+               through: :role_assignments,
+               source: :role
+    end
+
+    def assign_role(role_name, resource_type_or_instance = nil)
+      assignment_attributes = {
+        role: ::Role.find_or_create_by(name: role_name)
+      }
+
+      if resource_type_or_instance.present?
+        assignment_attributes.merge! Authegy
+          .extract_resource_attributes(resource_type_or_instance)
+      end
+
+      role_assignments.find_or_create_by assignment_attributes
+    end
+
+    def has_role?(role_name, resource_type_or_instance = nil)
+      matching_attributes = { role: role_name.to_s }
+
+      return role_assignment_list.select do |assignment|
+        assignment[:role] == matching_attributes[:role]
+      end.any? if resource_type_or_instance.blank?
+
+      matching_attributes.merge! Authegy
+          .extract_resource_attributes(resource_type_or_instance)
+
+      role_assignment_list.select do |assignment|
+        assignment == matching_attributes
+      end.any?
+    end
+
+    private
+
+    def role_assignment_list
+      @role_assignment_list ||= role_assignments.includes(:role).map do |assgn|
+        assgn.attributes.slice('resource_type', 'resource_id').merge!(
+          role: assgn.role.name
+        ).symbolize_keys!
+      end
+    end
+  end
+end

data/lib/authegy/controller_helpers.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Authegy
+  # = AuthorizationHelper
+  #
+  # Methods that deal with defining access to resources by user roles
+  module ControllerHelpers
+    # authorize_action!
+    # Usage:
+    # ```
+    # class ThingsController < ApplicationController
+    #   before_action do
+    #     authorize_action! to: 'thing.owner'
+    #     authorize_action! :administrator, :manager, of: 'thing.other_thing'
+    #     authorize_action! :anyone, from: 'thing.company'
+    #   end, only: [:index, :show]
+    # end
+    # ```
+    def authorize_action!(*given_roles)
+      given_roles, options = AuthorizationHelper.parse_given_roles(given_roles)
+      auth_request_env['match_roles_on'] = options[:match_roles_on] if options.key?(:match_roles_on)
+
+      return auth_request_env['authorized_roles'] = Role.all if super_admin_user?
+      auth_request_env['authorized_roles'] = current_user_roles.where(name: given_roles)
+
+      # error if only general manager, plant managers can create
+
+      raise ActionErrors::Forbidden if authorized_roles.map(&:name).count == 1 && current_user_roles.first.name == 'manager' && current_user_roles.where(name: 'manager').where.not(target_id: nil).empty?
+      raise ActionErrors::Forbidden unless authorized_roles.any?
+    end
+
+    def authorize_action(*given_roles)
+      authorize_action!(*given_roles)
+    rescue
+      false
+    end
+
+    def super_admin_user?
+      auth_request_env['super_admin_user'] ||= current_user_roles
+        .where(name: :administrator, target_id: nil)
+        .any?
+    end
+
+    # :nodoc:
+    # Reek complains about multiple calls to `request.env` and/or not refering to object state...
+    define_method(:auth_request_env) { request.env }
+
+    define_method(:current_user_roles) { current_user.roles }
+    define_method(:authorized_roles) { auth_request_env['authorized_roles'] }
+    #
+    # def match_roles_on
+    #   auth_request_env['match_roles_on']
+    # end
+
+    def self.parse_given_roles(given_roles = [])
+      given_roles = [:administrator] unless given_roles.any?
+      options = given_roles.last.is_a?(Hash) ? given_roles.pop.with_indifferent_access : {}
+      [given_roles, options]
+    end
+  end
+
+end

data/lib/authegy/engine.rb

@@ -0,0 +1,5 @@
+module Authegy
+  class Engine < ::Rails::Engine
+    isolate_namespace Authegy
+  end
+end

data/lib/authegy/models/person.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Authegy
+  # Person holds the "Profile" for a given User, but we can also have just
+  # Person profiles without a user, as is the case for "Board Members"
+  class Person < ApplicationRecord
+    include Authegy::Authorizable
+
+    self.table_name = :people
+    self.abstract_class = true
+
+    # Validations from 'validatable':
+    validates_uniqueness_of :email,
+                            allow_blank: true,
+                            if: :will_save_change_to_email?
+
+    validates_format_of :email,
+                        with: Devise.email_regexp,
+                        allow_blank: true,
+                        if: :will_save_change_to_email?
+
+    has_one :user, class_name: '::User', inverse_of: :person, foreign_key: :id
+  end
+end

data/lib/authegy/models/role.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Authegy
+  #= Authegy::Role
+  # A `Role`
+  class Role < ApplicationRecord
+    self.table_name = :roles
+    self.abstract_class = true
+
+    validates :name, format: {
+      with: /\A[a-z_]+\z/,
+      message: 'only allows letters and underscores'
+    }
+
+    has_many :assignments, class_name: '::RoleAssignment', inverse_of: :role
+    has_many :actors, -> { distinct }, through: :assignments, source: :actor
+  end
+end

data/lib/authegy/models/role_assignment.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Authegy
+  # A `RoleAssignment` associates a `Person` to an optional "resource", and
+  # assigns a particular roleholds the "Profile" for a given User, but we can
+  # also have just Person profiles without a user, as is the case for
+  # "Board Members"
+  class RoleAssignment < ApplicationRecord
+    self.table_name = :role_assignments
+    self.abstract_class = true
+
+    belongs_to :actor, class_name: '::Person', foreign_key: :actor_id
+    belongs_to :role
+    belongs_to :resource, optional: true, polymorphic: true
+  end
+end

data/lib/authegy/models/user.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'devise/models/validatable_with_person_email'
+require 'devise/models/database_authenticatable_with_person_email'
+
+module Authegy
+  #= User
+  #
+  # Represents a person which is able to sign-in to the application.
+  # Users are intended for authentification, the actual profile sits in Person.
+  class User < ApplicationRecord
+    self.table_name = :users
+    self.abstract_class = true
+
+    devise :database_authenticatable_with_person_email,
+           :validatable_with_person_email
+
+    belongs_to :person, inverse_of: :user, foreign_key: :id
+    delegate :email, :email=, :name, to: :person, allow_nil: true
+
+    delegate :assigned_roles, :assign_role, :has_role?, :has_any_role?,
+             :remove_role, :role_assignments, to: :person
+  end
+end

data/lib/authegy/version.rb

@@ -0,0 +1,3 @@
+module Authegy
+  VERSION = '0.0.1'.freeze
+end

data/lib/devise/models/database_authenticatable_with_person_email.rb

@@ -0,0 +1,30 @@
+module Devise
+  module Models
+    #= DatabaseAuthenticatableWithPersonEmail
+    #
+    # Overrides Devise::Models::DatabaseAuthenticatable, so but instead of
+    # expecting the `email` field to be in the authenticatable model, is located
+    # instead in the associated `Person` model
+    module DatabaseAuthenticatableWithPersonEmail
+      extend ActiveSupport::Concern
+
+      included do
+        # Include the original module:
+        devise :database_authenticatable
+      end
+
+      module ClassMethods
+        Devise::Models.config self
+
+        # Override of
+        # Devise::Models::Authenticatable.find_first_by_auth_conditions:
+        def find_first_by_auth_conditions(tainted_conditions, opts={})
+          filter = devise_parameter_filter.filter(tainted_conditions).merge opts
+          person_filter = filter.extract! :email
+          matching_person_scope = Person.where person_filter
+          User.where(filter).joins(:person).merge(matching_person_scope).first
+        end
+      end
+    end
+  end
+end

data/lib/devise/models/validatable_with_person_email.rb

@@ -0,0 +1,41 @@
+module Devise
+  module Models
+    #= ValidatableWithPersonEmail
+    #
+    # A re-implementation of Devise::Models::Validatable, but instead of
+    # expecting the `email` field to be in the authenticatable model, is located
+    # instead in the `Person` associated model
+    module ValidatableWithPersonEmail
+      extend ActiveSupport::Concern
+
+      included do
+        validates_presence_of :password, if: :password_required?
+        validates_confirmation_of :password, if: :password_required?
+
+        validates_length_of :password,
+                            within: password_length,
+                            allow_blank: true
+
+        validate :person_email_must_be_present
+      end
+
+      module ClassMethods
+        Devise::Models.config self, :email_regexp, :password_length
+      end
+
+      protected
+
+      # Checks whether a password is needed or not. For validations only.
+      # Passwords are always required if it's a new record, or if the password
+      # or confirmation are being set somewhere.
+      def password_required?
+        !persisted? || !password.nil? || !password_confirmation.nil?
+      end
+
+      def person_email_must_be_present
+        return if person&.email.present?
+        errors.add :base, 'Person email must be present'
+      end
+    end
+  end
+end

data/lib/generators/authegy/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Explain the generator
+
+Example:
+    rails generate authegy Thing
+
+    This will create:
+        what/will/it/create

data/lib/generators/authegy/install_generator.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'rails/generators/base'
+
+class InstallGenerator < Rails::Generators::Base
+  namespace 'authegy:install'
+  source_root File.expand_path('templates', __dir__)
+
+
+  def generate_customized_devise_install
+    generate 'devise:install'
+
+    gsub_file 'config/initializers/devise.rb',
+              'config.sign_out_via = :delete',
+              'config.sign_out_via = %i[get delete]'
+  end
+
+  def generate_authegy_install
+    generate 'authegy:models People'
+  end
+
+  def add_devise_routes
+    route <<~STRING
+      devise_for :users,
+                 path: '/',
+                 path_names: { sign_in: 'sign-in', sign_out: 'sign-out' }
+    STRING
+  end
+end

data/lib/generators/authegy/models_generator.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'rails/generators/active_record'
+require 'generators/authegy/orm_helpers'
+
+class ModelsGenerator < ActiveRecord::Generators::Base
+  namespace 'authegy:models'
+  include Authegy::Generators::OrmHelpers
+  source_root File.expand_path('templates', __dir__)
+
+  argument :attributes,
+           type: :array,
+           default: [],
+           banner: 'field:type field:type'
+
+  # class_option :primary_key_type, type: :string, desc: 'The type for primary key'
+
+  def copy_authegy_migration
+    # if (behavior == :invoke && model_exists?) || (behavior == :revoke && migration_exists?(table_name))
+    #   migration_template "migration_existing.rb", "#{migration_path}/add_devise_to_#{table_name}.rb", migration_version: migration_version
+    # else
+      migration_template(
+        'models_migration.erb',
+        "#{migration_path}/create_authegy_model_tables.rb",
+        migration_version: migration_version
+      )
+    # end
+  end
+
+  def generate_app_models
+    copy_file 'person_model.rb',          'app/models/person.rb'
+    copy_file 'role_model.rb',            'app/models/role.rb'
+    copy_file 'user_model.rb',            'app/models/user.rb'
+    copy_file 'role_assignment_model.rb', 'app/models/role_assignment.rb'
+  end
+
+  def rails5_and_up?
+    Rails::VERSION::MAJOR >= 5
+  end
+
+  def migration_version
+    if rails5_and_up?
+      "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]"
+    end
+  end
+end

data/lib/generators/authegy/orm_helpers.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Authegy
+  module Generators
+    module OrmHelpers
+      def model_contents
+        buffer = <<-CONTENT
+  # Include default devise modules. Others available are:
+  # :confirmable, :lockable, :timeoutable, :trackable and :omniauthable
+  devise :database_authenticatable, :registerable,
+         :recoverable, :rememberable, :validatable
+CONTENT
+        buffer
+      end
+
+      private
+
+      def model_exists?
+        File.exist?(File.join(destination_root, model_path))
+      end
+
+      def migration_exists?(table_name)
+        Dir.glob("#{File.join(destination_root, migration_path)}/[0-9]*_*.rb").grep(/\d+_add_devise_to_#{table_name}.rb$/).first
+      end
+
+      def migration_path
+        if Rails.version >= '5.0.3'
+          db_migrate_path
+        else
+          @migration_path ||= File.join("db", "migrate")
+        end
+      end
+
+      def model_path
+        @model_path ||= File.join("app", "models", "#{file_path}.rb")
+      end
+    end
+  end
+end

data/lib/generators/authegy/templates/models_migration.erb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+class CreateAuthegyModelTables < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_people_table
+    create_users_table
+    create_roles_table
+    create_role_assignments_table
+  end
+
+  def create_people_table
+    create_table :people do |t|
+      t.string :first_name, null: false
+      t.string :last_name, null: false
+      t.string :email, index: { unique: true }
+
+      # Feel free to add additional fields, such as 'nickname', etc:
+      # t.string :phone
+
+      t.timestamps null: false
+    end
+  end
+
+  def create_users_table
+    create_table :users do |t|
+      ## Database authenticatable
+      t.string :encrypted_password, null: false, default: ''
+
+      ## Recoverable
+      t.string   :reset_password_token, index: { unique: true }
+      t.datetime :reset_password_sent_at
+
+      ## Rememberable
+      t.datetime :remember_created_at
+
+      ## Trackable
+      # t.integer  :sign_in_count, default: 0, null: false
+      # t.datetime :current_sign_in_at
+      # t.datetime :last_sign_in_at
+      # t.inet     :current_sign_in_ip
+      # t.inet     :last_sign_in_ip
+
+      ## Confirmable
+      # t.string   :confirmation_token, index: { unique: true }
+      # t.datetime :confirmed_at
+      # t.datetime :confirmation_sent_at
+      # t.string   :unconfirmed_email # Only if using reconfirmable
+
+      ## Lockable
+      # # Only if lock strategy is :failed_attempts:
+      # t.integer  :failed_attempts, default: 0, null: false
+      # # Only if unlock strategy is :email or :both:
+      # t.string   :unlock_token, index: { unique: true }
+      # t.datetime :locked_at
+
+      t.timestamps null: false
+    end
+
+    # The `users.id` column is actually a foreign key to the `people` table:
+    add_foreign_key :users, :people, column: :id
+  end
+
+  def create_roles_table
+    create_table :roles do |t|
+      t.string :name, null: false, comment: 'Name of the role'
+      t.text :description, comment: 'Description of the role'
+
+      t.timestamps null: false
+    end
+  end
+
+  def create_role_assignments_table
+    create_table :role_assignments do |t|
+      t.references :actor, foreign_key: { to_table: :people }
+
+      t.references :role,
+                   foreign_key: { to_table: :roles },
+                   comment: 'The role assigned to the actor'
+
+      t.references :resource, polymorphic: true
+    end
+  end
+end

data/lib/generators/authegy/templates/person_model.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Person holds the "Profile" for a given User, but we can also have just Person
+# profiles without a user, as is the case for "Board Members"
+class Person < Authegy::Person
+  # Authegy::Person already includes validations for the email field, and
+  # associations for :user, :role_assignments, :assigned_roles, and methods
+  # for authorization, such as :assign_role, :has_role?, etc.
+end

data/lib/generators/authegy/templates/role_assignment_model.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+class RoleAssignment < Authegy::RoleAssignment
+  # Authegy::RoleAssignment already defines associations to :actor, :role and
+  # :resource
+end

data/lib/generators/authegy/templates/role_model.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+#= Role
+class Role < Authegy::Role
+  # Authegy::Role already defines associations to :assignments and :actors
+end

data/lib/generators/authegy/templates/user_model.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+#= User
+#
+# Represents a person which is able to sign-in to the application.
+# Users are intended for authentification, the actual profile sits in Person.
+class User < Authegy::User
+  # Authegy::User class already includes associations to :person,
+  # and delegations to :person such as :email, :has_role?, etc.
+
+  # Include devise modules. Others available are:
+  # :confirmable, :lockable, :timeoutable, :trackable and :omniauthable
+  devise :database_authenticatable_with_person_email, :registerable,
+         :recoverable, :rememberable, :validatable_with_person_email
+end

data/lib/tasks/authegy_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :authegy do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: authegy
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Roberto Quintanilla
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-03-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: devise
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.6.1
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.6
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  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: Opinionated app strategy used for authentication & role-based authorization.
+email:
+- vov@icalialabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- app/assets/config/authegy_manifest.js
+- app/assets/javascripts/authegy/application.js
+- app/assets/stylesheets/authegy/application.css
+- app/controllers/authegy/application_controller.rb
+- app/helpers/authegy/application_helper.rb
+- app/jobs/authegy/application_job.rb
+- app/mailers/authegy/application_mailer.rb
+- app/models/authegy/application_record.rb
+- app/views/layouts/authegy/application.html.erb
+- lib/authegy.rb
+- lib/authegy/authorizable.rb
+- lib/authegy/controller_helpers.rb
+- lib/authegy/engine.rb
+- lib/authegy/models/person.rb
+- lib/authegy/models/role.rb
+- lib/authegy/models/role_assignment.rb
+- lib/authegy/models/user.rb
+- lib/authegy/version.rb
+- lib/devise/models/database_authenticatable_with_person_email.rb
+- lib/devise/models/validatable_with_person_email.rb
+- lib/generators/authegy/USAGE
+- lib/generators/authegy/install_generator.rb
+- lib/generators/authegy/models_generator.rb
+- lib/generators/authegy/orm_helpers.rb
+- lib/generators/authegy/templates/models_migration.erb
+- lib/generators/authegy/templates/person_model.rb
+- lib/generators/authegy/templates/role_assignment_model.rb
+- lib/generators/authegy/templates/role_model.rb
+- lib/generators/authegy/templates/user_model.rb
+- lib/tasks/authegy_tasks.rake
+homepage: https://github.com/vovimayhem/authegy-gem
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/vovimayhem/authegy-gem
+  source_code_uri: https://github.com/vovimayhem/authegy
+  changelog_uri: https://github.com/vovimayhem/authegy/blob/master/CHANGELOG.md
+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: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Opinionated app strategy used for authentication & role-based authorization.
+test_files: []