heimdall_auth 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 29cb7098164d961235da49ead51d3b78af737ffbef7f725bb8b717cfc65b9331
+  data.tar.gz: ae7679f72682edfc40064e8f6693a5dff0aaac36b74bc0810896647852583684
+SHA512:
+  metadata.gz: 1f2f332262c78e6a77e0da0c87c8b1d66764ccf8fefcecc776e03be2d5a76c68105dcf6667e67dd1273234a810fdac9dc7e3b39552dde174c753da5efcc384cb
+  data.tar.gz: 0cf6641c87c3605eedb0782b4e8f7a2322067ff9d1a978537e6a60cfce5e06025b49b76e45c9b64cad33e4e7fbbcc97a0955c1b624a220de22195efc61e760ca

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2019 René Meye
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+# HeimdallAuth
+This makes it easy to equip an empty rails application with our Heimdall Auth features.
+
+## Installation and Usage
+0) Commit the empty rails application (and mention the command you used for generating the app)
+
+1) Add this line to your application's Gemfile:
+
+```ruby
+gem 'heimdall_auth'
+```
+
+2) and afterwards do theses commands (yes... second bundle install ist needed, because the install script adds dotenv gem)
+```bash
+bundle install
+rails puma_dev:link
+rails generate heimdall_auth:install
+rails heimdall:register -- -u"rene@vesputi.com" -p"HeimdallPassword" >> .env
+bundle install
+```
+
+3) And please commit directly after executing the lines above so you have clean history
+
+
+## Linking puma_dev
+
+This executes a very simple `ln -s` command in order to link our application with appropriate naming to the local puma_dev server.
+```bash
+rails puma_dev:link
+```
+
+## Heimdall-Auth install scripts
+This makes a few steps in order to install heimdall stuff to your app.
+```bash
+rails generate heimdall_auth:install
+```
+executes the following generators
+1. `rails generate heimdall_auth:cancan`
+2. `rails generate heimdall_auth:sessions`
+3. `rails generate heimdall_auth:standard_pages`
+4. `rails generate heimdall_auth:dotenv`
+
+### generate heimdall_auth:cancan
+This adds the ability.rb file of the cancancan gem with default heimdall roles and adds `check_authorization` to the application controller. (For details see the [cancancan gem](https://github.com/CanCanCommunity/cancancan))
+
+### generate heimdall_auth:sessions
+This adds the default heimdall_auth routes for session generation to the routes file, switches the application to https only and lowers the log level.
+
+### generate heimdall_auth:standard_pages
+This adds the default admin page `/admin` and two error pages: for invalid_user_data and not_enough_rights.
+
+### generate heimdall_auth:dotenv
+This adds a default .env.example file (for documentation purposes) to the application and adds the dotenv gem to the gemfile which loads enviroment variables from .env file.
+
+## Register at local heimdall
+
+The following command Registeres the service at Heimdall and puts credentials at the end of the `.env` file
+
+```bash
+rails heimdall:register -- -u"rene@vesputi.com" -p"12345678" >> .env
+```
+Parameters:
+```
+-u"rene@vesputi.com" # Username in Heimdall (Needs Admin rights)
+-p"12345678" # Password in Heimdall
+-h"https://heimdall.vesp" (Optional) - Protocol and Domain the heimdall is found at
+-s"https://foo.vesputi-abc.de" # (Optional) - Protocol and Domain the Service is found at
+```

data/Rakefile

@@ -0,0 +1,27 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'HeimdallAuth'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/app/controllers/heimdall_auth/sessions_controller.rb

@@ -0,0 +1,36 @@
+class HeimdallAuth::SessionsController < ApplicationController
+  skip_authorization_check
+
+  def new
+    user_token = params[:user_token].presence
+    heimdall_auth_url = auth_provider_url(provider: "heimdall")
+
+    if user_token
+      do_a_signin_precall(user_token, heimdall_auth_url)
+    else
+      redirect_to heimdall_auth_url
+    end
+  end
+
+  def create
+    auth = request.env["omniauth.auth"]
+    session[:access_token] = auth.credentials.token
+    redirect_to session[:last_url] || root_url
+  end
+
+  def destroy
+    last_url = session[:last_url]
+    reset_session
+    redirect_to "#{ENV['HEIMDALL_SERVER_URL']}/signout?redirect_to=#{last_url || passenger_url}", :notice => 'Signed out!'
+  end
+
+  def failure
+    redirect_to root_url, :alert => "Authentication error: #{params[:message].humanize}"
+  end
+
+  private
+  def do_a_signin_precall(user_token, heimdall_auth_url)
+    redirect_to "#{ENV['HEIMDALL_SERVER_URL']}/?user_token=#{user_token}&redirect_to=#{heimdall_auth_url}"
+  end
+
+end

data/lib/generators/heimdall_auth/cancan/cancan_generator.rb

@@ -0,0 +1,19 @@
+module HeimdallAuth
+  module Generators
+    class CancanGenerator < ::Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      def add_ability_file
+        copy_file "ability.rb", "app/models/ability.rb"
+      end
+
+      def add_check_authorization_method
+        inject_into_file 'app/controllers/application_controller.rb', after: "class ApplicationController < ActionController::Base\n" do
+<<-'RUBY'
+  check_authorization
+RUBY
+        end
+      end
+    end
+  end
+end

data/lib/generators/heimdall_auth/cancan/templates/ability.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+class Ability
+  include CanCan::Ability
+
+  def initialize(user)
+    if user && not(user.is_invalid)
+      can :index, :admin_page
+      # if user.is_editor
+      #   can :manage, :all
+      # end
+      # if user.is_operator
+      # end
+      # if user.is_admin
+      # end
+      # if user.is_user_admin
+      # end
+    end
+
+    #
+    # The first argument to `can` is the action you are giving the user
+    # permission to do.
+    # If you pass :manage it will apply to every action. Other common actions
+    # here are :read, :create, :update and :destroy.
+    #
+    # The second argument is the resource the user can perform the action on.
+    # If you pass :all it will apply to every resource. Otherwise pass a Ruby
+    # class of the resource.
+    #
+    # The third argument is an optional hash of conditions to further filter the
+    # objects.
+    # For example, here the user can only update published articles.
+    #
+    #   can :update, Article, :published => true
+    #
+    # See the wiki for details:
+    # https://github.com/CanCanCommunity/cancancan/wiki/Defining-Abilities
+  end
+end

data/lib/generators/heimdall_auth/dotenv/dotenv_generator.rb

@@ -0,0 +1,16 @@
+module HeimdallAuth
+  module Generators
+    class DotenvGenerator < ::Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      def add_dot_env_support
+        gem_group :development, :test do
+          # Load ENV variables from .env file development and test
+          gem 'dotenv-rails'
+        end
+
+        copy_file ".env.example", ".env.example"
+      end
+    end
+  end
+end

data/lib/generators/heimdall_auth/install/install_generator.rb

@@ -0,0 +1,12 @@
+module HeimdallAuth
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      def install
+        generate "heimdall_auth:cancan"
+        generate "heimdall_auth:sessions"
+        generate "heimdall_auth:standard_pages"
+        generate "heimdall_auth:dotenv"
+      end
+    end
+  end
+end

data/lib/generators/heimdall_auth/sessions/sessions_generator.rb

@@ -0,0 +1,26 @@
+module HeimdallAuth
+  module Generators
+    class SessionsGenerator < ::Rails::Generators::Base
+
+      def add_session_routes
+        route "use_heimdall_auth"
+      end
+
+      def set_https_only
+        gsub_file 'config/environments/production.rb', '# config.force_ssl = true', 'config.force_ssl = true'
+        inject_into_file 'config/environments/development.rb', after: "  config.assets.debug = true\n" do
+<<-'RUBY'
+
+  # Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies.
+  config.force_ssl = true
+RUBY
+        end
+      end
+
+      def lower_production_log_level
+        gsub_file 'config/environments/production.rb', 'config.log_level = :debug', 'config.log_level = :warn'
+      end
+
+    end
+  end
+end

data/lib/generators/heimdall_auth/standard_pages/standard_pages_generator.rb

@@ -0,0 +1,19 @@
+module HeimdallAuth
+  module Generators
+    class StandardPagesGenerator < ::Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      def generate_admin_page
+        copy_file "admin_controller.rb", "app/controllers/admin_page_controller.rb"
+        copy_file "admin_view.html.erb", "app/views/admin_page/index.html.erb"
+        route "get '/admin' => 'admin_page#index'"
+      end
+
+      def generate_error_pages
+        copy_file "invalid_user_data.html.erb", "app/views/application/invalid_user_data.html.erb"
+        copy_file "not_enough_rights.html.erb", "app/views/application/not_enough_rights.html.erb"
+      end
+
+    end
+  end
+end

data/lib/generators/heimdall_auth/standard_pages/templates/admin_controller.rb

@@ -0,0 +1,5 @@
+class AdminPageController < ApplicationController
+  def index
+    authorize! :index, :admin_page
+  end
+end

data/lib/generators/heimdall_auth/standard_pages/templates/admin_view.html.erb

@@ -0,0 +1,2 @@
+<h1>Admin Page</h1>
+<h3>Hallo: <%=current_user && current_user.name%></h3>

data/lib/generators/heimdall_auth/standard_pages/templates/invalid_user_data.html.erb

@@ -0,0 +1,2 @@
+<h1>Ungültige Nutzerdaten.</h1>
+<p>Das Authentifizierungssytem hat ungültige Benutzerdaten geliefert. Bitte informieren Sie den Administrator.</p>

data/lib/generators/heimdall_auth/standard_pages/templates/not_enough_rights.html.erb

@@ -0,0 +1,2 @@
+<h1>Nicht genügend Rechte.</h1>
+<p>Sie verfügen leider nicht über genügend Rechte um diese Seite zu öffnen. Bei Fragen wenden Sie sich an Ihren Administrator.</p>

data/lib/heimdall_auth/controller_additions.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module HeimdallAuth
+  # This module is automatically included into all controllers.
+  # It adds methods like current_user but also handles auth-failure redirections
+  module ControllerAdditions
+
+    def self.included(base)
+      base.helper_method :current_user, :current_access_token, :user_signed_in? if base.respond_to? :helper_method
+      base.before_action :store_location_in_session
+
+      base.rescue_from CanCan::AccessDenied do |exception|
+        user_token = params[:user_token].presence
+
+        respond_to do |format|
+          format.json { head :forbidden, content_type: 'text/html' }
+          format.html {
+            if current_user.nil?
+              redirect_to new_user_session_path({user_token: user_token})
+            elsif current_user.is_invalid
+              render 'application/invalid_user_data'
+            else
+              render 'application/not_enough_rights'
+            end
+          }
+        end
+      end
+
+    end
+
+    def current_ability
+      @current_ability ||= Ability.new(current_user)
+    end
+
+    def store_location_in_session
+      session[:last_url] = request.url if storable_location?
+      logger.info("\033[32m session[:last_url] = #{session[:last_url]} \033[0m")
+    end
+
+    def storable_location?
+      request.get? && request.format.try(:ref) == :html && !is_a?(SessionsController) && !request.xhr?
+    end
+
+
+    def current_access_token
+      session[:access_token] || params[:access_token] || request.headers['HeimdallAccessToken']
+    end
+
+    def current_user
+      begin
+        @current_user ||= get_user_from_auth_server(current_access_token)
+      rescue NoMethodError => e
+        User.new(is_invalid: true)
+      rescue Exception => e
+        nil
+      end
+    end
+
+    def get_user_from_auth_server(access_token)
+      client = OAuth2::Client.new(ENV['HEIMDALL_APPLICATION_ID'], ENV['HEIMDALL_APPLICATION_SECRET'], :site => ENV['HEIMDALL_SERVER_URL'])
+      user_data = OAuth2::AccessToken.new(client,access_token).get('/me.json').parsed
+      User.new(user_data)
+    end
+
+    def user_signed_in?
+      return true if current_user
+    end
+  end
+end
+
+if defined? ActiveSupport
+  ActiveSupport.on_load(:action_controller) do
+    include HeimdallAuth::ControllerAdditions
+  end
+end

data/lib/heimdall_auth/engine.rb

@@ -0,0 +1,25 @@
+module HeimdallAuth
+  class Engine < Rails::Engine
+    initializer "heimdall_auth.routes" do
+      HeimdallAuth::Rails::Routes.install!
+    end
+
+    initializer "heimdall_auth.middleware" do |app|
+      fail_missing_config! if [ENV['HEIMDALL_SERVER_URL'], ENV['HEIMDALL_APPLICATION_ID'], ENV['HEIMDALL_APPLICATION_SECRET']].any? &:nil?
+      app.config.middleware.use OmniAuth::Builder do
+        provider :heimdall,
+          ENV['HEIMDALL_APPLICATION_ID'],
+          ENV['HEIMDALL_APPLICATION_SECRET'],
+          client_options: {
+            site: ENV['HEIMDALL_SERVER_URL']
+          }
+      end
+    end
+
+    private
+
+    def fail_missing_config!
+      raise "Heimdall configuration is missing. Set the follwing ENV-Variables: HEIMDALL_SERVER_URL, HEIMDALL_APPLICATION_ID and HEIMDALL_APPLICATION_SECRET"
+    end
+  end
+end

data/lib/heimdall_auth/rails/routes.rb

@@ -0,0 +1,19 @@
+module HeimdallAuth
+  module Rails
+    class Routes
+      module Helper
+        def use_heimdall_auth(options = {}, &block)
+          get '/auth/:provider' => 'heimdall_auth/sessions#create', :as => :auth_provider #This is only fake for url_helpers, because this paths are served by middleware
+          get '/auth/:provider/callback' => 'heimdall_auth/sessions#create', :as => :auth_provider_callback
+          get '/auth/failure' => 'heimdall_auth/sessions#failure'
+          get '/signin' => 'heimdall_auth/sessions#new', :as => :new_user_session
+          get '/signout' => 'heimdall_auth/sessions#destroy', :as => :destroy_user_session
+        end
+      end
+
+      def self.install!
+        ActionDispatch::Routing::Mapper.send :include, HeimdallAuth::Rails::Routes::Helper
+      end
+    end
+  end
+end

data/lib/heimdall_auth/railtie.rb

@@ -0,0 +1,4 @@
+module HeimdallAuth
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/heimdall_auth/user.rb

@@ -0,0 +1,18 @@
+class HeimdallAuth::User
+  include ActiveModel::Conversion
+  extend ActiveModel::Naming
+
+  attr_accessor :is_invalid
+  attr_accessor :id, :name, :email, :is_editor, :is_operator, :is_admin, :is_user_admin
+
+  def initialize(attributes = {})
+    attributes.each do |name, value|
+      setter_method = "#{name}="
+      send(setter_method, value) if self.respond_to? setter_method
+    end
+  end
+
+  def persisted?
+    false
+  end
+end

data/lib/heimdall_auth/version.rb

@@ -0,0 +1,3 @@
+module HeimdallAuth
+  VERSION = '1.0.0'
+end

data/lib/heimdall_auth.rb

@@ -0,0 +1,14 @@
+require "heimdall_auth/railtie" if defined?(Rails)
+
+require "heimdall_auth/engine"
+require "heimdall_auth/rails/routes"
+
+require "heimdall_auth/user"
+require "omniauth/stategies/heimdall"
+
+require "heimdall_auth/controller_additions"
+
+
+module HeimdallAuth
+  # Your code goes here...
+end

data/lib/omniauth/stategies/heimdall.rb

@@ -0,0 +1,47 @@
+require 'omniauth-oauth2'
+
+module OmniAuth
+  module Strategies
+    class Heimdall < OmniAuth::Strategies::OAuth2
+      option :name, :heimdall
+      option :provider_ignores_state, true
+
+      uid {
+        raw_info['id']
+      }
+
+      info do
+        {
+          name: raw_info['name'],
+          email: raw_info['email'],
+        }
+      end
+
+      extra do
+        { raw_info: raw_info }
+      end
+
+      def raw_info
+        @raw_info ||= access_token.get('/me.json').parsed
+      end
+
+      def callback_url
+        # If redirect_uri is configured in token_params, use that
+        # value.
+        token_params.to_hash(:symbolize_keys => true)[:redirect_uri] || super
+      end
+
+      def query_string
+        # This method is called by callback_url, only if redirect_uri
+        # is omitted in token_params.
+        if request.params["code"]
+          # If this is a callback, ignore query parameters added by
+          # the provider.
+          ""
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/tasks/puma_dev_link.rake

@@ -0,0 +1,12 @@
+namespace :puma_dev do
+  desc 'Fast linking to puma dev'
+  task :link do
+
+    application_name = Rails.application.class.parent_name
+    puma_dev_app_name = "#{application_name.underscore.dasherize}.vesputi-abc"
+    command = "ln -s #{Rails.root} ~/.puma-dev/#{puma_dev_app_name}"
+
+    puts "Script is linking to puma-dev"
+    sh command
+  end
+end

data/lib/tasks/register.rake

@@ -0,0 +1,84 @@
+require 'net/http'
+require 'net/https'
+require 'json'
+require 'optparse'
+
+namespace :heimdall do
+  desc 'Register application at a Heimdall Application'
+  task :register do
+
+    application_name = Rails.application.class.parent_name
+
+    options = {
+      application_name: application_name,
+      service_url: "https://#{application_name.underscore.dasherize}.vesputi-abc.de",
+      heimdall_url: "https://heimdall.vesputi-abc.de",
+    }
+    option_parser = OptionParser.new
+    option_parser.banner = "Usage: rake add [options]"
+    option_parser.on("-h", "--heimdall ARG", String) { |heimdall_url| options[:heimdall_url] = heimdall_url }
+    option_parser.on("-s", "--service ARG", String) { |service_url| options[:service_url] = service_url }
+    option_parser.on("-u", "--username ARG", String) { |username| options[:username] = username }
+    option_parser.on("-p", "--password ARG", String) { |password| options[:password] = password }
+
+    args = option_parser.order!(ARGV) {}
+    option_parser.parse!(args)
+
+    #TODO: strip the trialing slash ... if there is one
+    credentials = create_oauth_application_request(
+      options[:heimdall_url],
+      options[:service_url],
+      "#{options[:application_name]} | (Registered at #{DateTime.current.to_formatted_s(:long)})",
+      options[:username],
+      options[:password]
+    )
+
+    if credentials
+      STDERR.puts "## Sucessfully registered as '#{options[:application_name]}'"
+      STDERR.puts "# Heimdall URL as '#{options[:heimdall_url]}' (change it with -h\"https://heimdall.any-whe.re/\")"
+      STDERR.puts "# Service URL as '#{options[:service_url]}' (change it with -s\"https://foo.bar/\")"
+      puts "HEIMDALL_SERVER_URL=#{options[:heimdall_url]}/"
+      puts "HEIMDALL_APPLICATION_ID=#{credentials['uid']}"
+      puts "HEIMDALL_APPLICATION_SECRET=#{credentials['secret']}"
+    end
+  end
+end
+
+
+def create_oauth_application_request(heimdall_url, application_url, application_name, heimdall_username, heimdall_password)
+  uri = URI("#{heimdall_url}/oauth_applications_api.json")
+
+  # Create client
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true
+  http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+  dict = {
+            "oauth_application" => {
+                "name" => "#{application_name}",
+                "redirect_uri" =>
+                  "#{application_url}/auth/heimdall/callback\n" +
+                  "#{application_url}/auth/heimdall/callback/"
+            }
+        }
+  body = JSON.dump(dict)
+
+  # Create Request
+  req =  Net::HTTP::Post.new(uri)
+  # Add headers
+  req.add_field "Authorization", "Basic #{Base64.strict_encode64("#{heimdall_username}:#{heimdall_password}")}"
+  # Add headers
+  req.add_field "Content-Type", "application/json; charset=utf-8"
+  # Set body
+  req.body = body
+
+  # Fetch Request
+  res = http.request(req)
+
+  if res.code == "201"
+    return JSON.parse(res.body)
+  else
+    STDERR.puts "Can't Register \n\n Code #{res.code} Body: #{res.body}"
+  end
+rescue StandardError => e
+  STDERR.puts "HTTP Request failed (#{e.message})"
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: heimdall_auth
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- René Meye
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-12-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: omniauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+- !ruby/object:Gem::Dependency
+  name: omniauth-oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  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'
+description: Description of HeimdallAuth.
+email:
+- rene@vesputi.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/controllers/heimdall_auth/sessions_controller.rb
+- lib/generators/heimdall_auth/cancan/cancan_generator.rb
+- lib/generators/heimdall_auth/cancan/templates/ability.rb
+- lib/generators/heimdall_auth/dotenv/dotenv_generator.rb
+- lib/generators/heimdall_auth/install/install_generator.rb
+- lib/generators/heimdall_auth/sessions/sessions_generator.rb
+- lib/generators/heimdall_auth/standard_pages/standard_pages_generator.rb
+- lib/generators/heimdall_auth/standard_pages/templates/admin_controller.rb
+- lib/generators/heimdall_auth/standard_pages/templates/admin_view.html.erb
+- lib/generators/heimdall_auth/standard_pages/templates/invalid_user_data.html.erb
+- lib/generators/heimdall_auth/standard_pages/templates/not_enough_rights.html.erb
+- lib/heimdall_auth.rb
+- lib/heimdall_auth/controller_additions.rb
+- lib/heimdall_auth/engine.rb
+- lib/heimdall_auth/rails/routes.rb
+- lib/heimdall_auth/railtie.rb
+- lib/heimdall_auth/user.rb
+- lib/heimdall_auth/version.rb
+- lib/omniauth/stategies/heimdall.rb
+- lib/tasks/puma_dev_link.rake
+- lib/tasks/register.rake
+homepage: https://vesputi.com
+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: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Summary of HeimdallAuth.
+test_files: []