jwt_keeper 3.0.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 82b55239d3d3c73d4308ffe4deae76f9946c5f69
-  data.tar.gz: 524f61adf98731f7c9b8a23d54188c86d433b70e
+  metadata.gz: 3d622a17d010fc9b106c161c42b90a4b3f8f1c05
+  data.tar.gz: 45467b7f357ad75e985b1b74297b5948cb2964d2
 SHA512:
-  metadata.gz: be39c5cf7875634fb3140d6b76e78bbc46b9c3978799e3e9cf2bc394de49c7f814052e7bdfddad25c5fa1497a84b9de6db89b41ba098207b76f374038b0fa65e
-  data.tar.gz: f8903ede2c42bee6eb3135d14d3b98ee22cf4e1dd8a1e818bd4c6d3be5ad470e5304e50515c59287af1e5194e05718b29a4d7899cceb675c72b9f66e32fad42a
+  metadata.gz: c87fbde489f9aace5c0bf65ae997b65d80b984bcd860986ed04bac9cece93b955b66bfa3bbca70dea29f1fb08dfb099cfdb1061f573e74cd63e66bf065eeaf7b
+  data.tar.gz: c5c28a26779d3c539c8dc63f6e5ba4636b5d82c2016cd1c2d7aa81526a498fec23aac300d4157e7c79ff5da724fd548dfd731bf43739fd695d75e24c095d092f

data/README.md

@@ -8,7 +8,7 @@
 An managing interface layer for handling the creation and validation of JWTs.
 
 ## Setup
- - Add `gem 'jwt_keeper', '~> 3.0'` to Gemfile
+ - Add `gem 'jwt_keeper'` to Gemfile
  - Run `rails generate keeper:install`
  - Configure `config/initializers/jwt_keeper.rb`
  - Done
@@ -28,13 +28,15 @@ raw_token_string = token.to_jwt
 ```
 
 ## Rails Usage
-The designed rails token flow is to receive and respond to requests with the token being present in the `Authorization` part of the header. This is to allow us to seamlessly rotate the tokens on the fly without having to rebuff the request as part of the user flow. Automatic rotation happens as part of the `require_authentication` action, meaning that you will always get the latest token data as
-created by `generate_claims` in your controllers. This new token is added to the response with the `respond_with_authentication` action.
+The designed rails token flow is to receive and respond to requests with the token being present in the `Authorization` part of the header. This is to allow us to seamlessly rotate the tokens on the fly without having to rebuff the request as part of the user flow. Automatic rotation happens as part of the `require_authentication` action, meaning that you will always get the latest token data as created by `generate_claims` in your controllers. This new token is added to the response with the `write_authentication_token` action.
+
+```bash
+rake generate jwt_keeper:install
+```
 
 ```ruby
 class ApplicationController < ActionController::Base
   before_action :require_authentication
-  after_action :respond_with_authentication
 
   def not_authenticated
     # Overload to return status 401
@@ -46,7 +48,7 @@ class ApplicationController < ActionController::Base
 
   def regenerate_claims(old_token)
     # Overload to update claims on automatic rotation.
-    current_user = User.find(authentication_token.claims[:uid])
+    current_user = User.find(old_token.claims[:uid])
     { uid: current_user.id, usn: current_user.email }
   end
 end
@@ -55,22 +57,25 @@ end
 ```ruby
 class SessionsController < ApplicationController
   skip_before_action :require_authentication, only: :create
-  skip_after_action :respond_with_authentication, only: :destroy
 
   # POST /sessions
   def create
-    authentication_token = JWTKeeper::Token.create({ uid: @user.id, usn: @user.email })
+    token = JWTKeeper::Token.create(uid: @user.id, usn: @user.email)
+    write_authentication_token(token)
   end
 
   # PATCH/PUT /sessions
   def update
-    authentication_token = request_token.rotate(generate_claims)
+    token = read_authentication_token
+    token.rotate
+    write_authentication_token(token)
   end
 
   # DELETE /sessions
   def destroy
-    request_token.revoke
-    authentication_token = nil
+    token = read_authentication_token
+    token.revoke
+    clear_authentication_token
   end
 ```
 

data/jwt_keeper.gemspec

@@ -9,11 +9,11 @@ Gem::Specification.new do |spec|
   spec.authors       = ['David Rivera', 'Zane Wolfgang Pickett']
   spec.email         = ['david.r.rivera193@gmail.com', 'sirwolfgang@users.noreply.github.com']
   spec.summary       = 'JWT for Rails made easy'
-  spec.description   = 'It is a keeper'
+  spec.description   = 'A managing interface layer for handling the creation and validation of JWTs'
   spec.homepage      = 'https://github.com/sirwolfgang/jwt_keeper'
   spec.license       = 'MIT'
 
-  spec.files         = `git ls-files -z`.split("\x0")
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(/^example\//) }
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']

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

@@ -1,6 +1,6 @@
 require 'rails/generators/base'
 
-module JWTKeeper
+module JwtKeeper
   class InstallGenerator < Rails::Generators::Base
     source_root File.expand_path('../../../templates', __FILE__)
 

data/lib/jwt_keeper/version.rb

@@ -1,4 +1,4 @@
 # Gem Version
 module JWTKeeper
-  VERSION = '3.0.0'.freeze
+  VERSION = '3.0.1'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jwt_keeper
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.1
 platform: ruby
 authors:
 - David Rivera
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-25 00:00:00.000000000 Z
+date: 2016-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -193,7 +193,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
-description: It is a keeper
+description: A managing interface layer for handling the creation and validation of
+  JWTs
 email:
 - david.r.rivera193@gmail.com
 - sirwolfgang@users.noreply.github.com
@@ -212,34 +213,6 @@ files:
 - Rakefile
 - docker-compose.yml
 - example.env
-- example/.gitignore
-- example/Gemfile
-- example/Rakefile
-- example/app/controllers/application_controller.rb
-- example/app/controllers/sessions_controller.rb
-- example/bin/bundle
-- example/bin/rails
-- example/bin/rake
-- example/bin/setup
-- example/bin/spring
-- example/config.ru
-- example/config/application.rb
-- example/config/boot.rb
-- example/config/environment.rb
-- example/config/environments/development.rb
-- example/config/environments/production.rb
-- example/config/environments/test.rb
-- example/config/initializers/backtrace_silencer.rb
-- example/config/initializers/cookies_serializer.rb
-- example/config/initializers/filter_parameter_logging.rb
-- example/config/initializers/jwt_keeper.rb
-- example/config/initializers/session_store.rb
-- example/config/initializers/wrap_parameters.rb
-- example/config/locales/en.yml
-- example/config/routes.rb
-- example/config/secrets.yml
-- example/example.env
-- example/log/.keep
 - jwt_keeper.gemspec
 - lib/generators/jwt_keeper/install/install_generator.rb
 - lib/generators/templates/jwt_keeper.rb

data/example/.gitignore

@@ -1,15 +0,0 @@
-# See https://help.github.com/articles/ignoring-files for more about ignoring files.
-#
-# If you find yourself ignoring temporary files generated by your text editor
-# or operating system, you probably want to add a global ignore instead:
-#   git config --global core.excludesfile '~/.gitignore_global'
-
-# Ignore bundler config.
-/.bundle
-
-# Ignore all logfiles and tempfiles.
-/log/*
-!/log/.keep
-/tmp
-
-.env

data/example/Gemfile

@@ -1,15 +0,0 @@
-source 'https://rubygems.org'
-
-gem 'rails', '4.2.6'
-gem 'puma'
-
-gem 'jwt_keeper', path: '..'
-
-group :development, :test do
-  gem 'dotenv-rails'
-
-  gem 'pry'
-  gem 'pry-stack_explorer'
-  gem 'pry-rescue'
-  gem 'pry-byebug'
-end

data/example/Rakefile

@@ -1,6 +0,0 @@
-# Add your own tasks in files placed in lib/tasks ending in .rake,
-# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
-
-require File.expand_path('../config/application', __FILE__)
-
-Rails.application.load_tasks

data/example/app/controllers/application_controller.rb

@@ -1,27 +0,0 @@
-class ApplicationController < ActionController::Base
-  protect_from_forgery with: :exception
-  skip_before_action :verify_authenticity_token
-
-  before_action :default_format_json
-  before_action :require_authentication
-
-  private
-
-  def default_format_json
-    request.format ||= 'json'
-  end
-
-  def not_authenticated
-    respond_to do |format|
-      format.json { head :unauthorized }
-    end
-  end
-
-  def authenticated(decoded_token)
-    @current_user_id = decoded_token.claims[:uid] # Hold off on database calls until necessary
-  end
-
-  def current_user
-    @current_user ||= { id: @current_user_id }
-  end
-end

data/example/app/controllers/sessions_controller.rb

@@ -1,52 +0,0 @@
-class SessionsController < ApplicationController
-  skip_before_action :require_authentication, only: :create
-
-  # GET /session
-  def show
-    token = read_authentication_token
-
-    respond_to do |format|
-      format.json { render json: token }
-    end
-  end
-
-  # POST /session
-  def create
-    @user = { id: 1 }
-
-    respond_to do |format|
-      if @user
-        write_authentication_token(JWTKeeper::Token.create(uid: @user[:id]))
-        format.json { head :created }
-      else
-        clear_authentication_token
-        format.json { head :unauthorized }
-      end
-    end
-  end
-
-  # PATCH/PUT /session
-  def update
-    token = read_authentication_token
-
-    respond_to do |format|
-      if token.rotate
-        write_authentication_token(token)
-        format.json { head :created }
-      else
-        clear_authentication_token
-        format.json { head :unauthorized }
-      end
-    end
-  end
-
-  # DELETE /session
-  def destroy
-    read_authentication_token.revoke
-
-    respond_to do |format|
-      clear_authentication_token
-      format.json { head :no_content }
-    end
-  end
-end

data/example/bin/bundle

@@ -1,3 +0,0 @@
-#!/usr/bin/env ruby
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
-load Gem.bin_path('bundler', 'bundle')

data/example/bin/rails

@@ -1,9 +0,0 @@
-#!/usr/bin/env ruby
-begin
-  load File.expand_path('../spring', __FILE__)
-rescue LoadError => e
-  raise unless e.message.include?('spring')
-end
-APP_PATH = File.expand_path('../../config/application', __FILE__)
-require_relative '../config/boot'
-require 'rails/commands'

data/example/bin/rake

@@ -1,9 +0,0 @@
-#!/usr/bin/env ruby
-begin
-  load File.expand_path('../spring', __FILE__)
-rescue LoadError => e
-  raise unless e.message.include?('spring')
-end
-require_relative '../config/boot'
-require 'rake'
-Rake.application.run

data/example/bin/setup

@@ -1,29 +0,0 @@
-#!/usr/bin/env ruby
-require 'pathname'
-
-# path to your application root.
-APP_ROOT = Pathname.new File.expand_path('../../', __FILE__)
-
-Dir.chdir APP_ROOT do
-  # This script is a starting point to setup your application.
-  # Add necessary setup steps to this file:
-
-  puts '== Installing dependencies =='
-  system 'gem install bundler --conservative'
-  system 'bundle check || bundle install'
-
-  # puts "\n== Copying sample files =="
-  # unless File.exist?("config/database.yml")
-  #   system "cp config/database.yml.sample config/database.yml"
-  # end
-
-  puts "\n== Preparing database =="
-  system 'bin/rake db:setup'
-
-  puts "\n== Removing old logs and tempfiles =="
-  system 'rm -f log/*'
-  system 'rm -rf tmp/cache'
-
-  puts "\n== Restarting application server =="
-  system 'touch tmp/restart.txt'
-end

data/example/bin/spring

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-
-# This file loads spring without using Bundler, in order to be fast.
-# It gets overwritten when you run the `spring binstub` command.
-
-unless defined?(Spring)
-  require 'rubygems'
-  require 'bundler'
-
-  if (match = Bundler.default_lockfile.read.match(/^GEM$.*?^    (?:  )*spring \((.*?)\)$.*?^$/m))
-    Gem.paths = { 'GEM_PATH' => [Bundler.bundle_path.to_s, *Gem.path].uniq.join(Gem.path_separator) }
-    gem 'spring', match[1]
-    require 'spring/binstub'
-  end
-end

data/example/config/application.rb

@@ -1,32 +0,0 @@
-require File.expand_path('../boot', __FILE__)
-
-require 'rails'
-# Pick the frameworks you want:
-# require "active_model/railtie"
-# require "active_job/railtie"
-# require "active_record/railtie"
-require 'action_controller/railtie'
-# require "action_mailer/railtie"
-require 'action_view/railtie'
-# require "sprockets/railtie"
-# require "rails/test_unit/railtie"
-
-# Require the gems listed in Gemfile, including any gems
-# you've limited to :test, :development, or :production.
-Bundler.require(*Rails.groups)
-
-module Example
-  class Application < Rails::Application
-    # Settings in config/environments/* take precedence over those specified here.
-    # Application configuration should go into files in config/initializers
-    # -- all .rb files in that directory are automatically loaded.
-
-    # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
-    # Run "rake -D time" for a list of tasks for finding time zone names. Default is UTC.
-    # config.time_zone = 'Central Time (US & Canada)'
-
-    # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
-    # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}').to_s]
-    # config.i18n.default_locale = :de
-  end
-end

data/example/config/boot.rb

@@ -1,3 +0,0 @@
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
-
-require 'bundler/setup' # Set up gems listed in the Gemfile.

data/example/config/environment.rb

@@ -1,5 +0,0 @@
-# Load the Rails application.
-require File.expand_path('../application', __FILE__)
-
-# Initialize the Rails application.
-Rails.application.initialize!

data/example/config/environments/development.rb

@@ -1,24 +0,0 @@
-Rails.application.configure do
-  # Settings specified here will take precedence over those in config/application.rb.
-
-  # In the development environment your application's code is reloaded on
-  # every request. This slows down response time but is perfect for development
-  # since you don't have to restart the web server when you make code changes.
-  config.cache_classes = false
-
-  # Do not eager load code on boot.
-  config.eager_load = false
-
-  # Show full error reports and disable caching.
-  config.consider_all_requests_local       = true
-  config.action_controller.perform_caching = false
-
-  # Don't care if the mailer can't send.
-  # config.action_mailer.raise_delivery_errors = false
-
-  # Print deprecation notices to the Rails logger.
-  config.active_support.deprecation = :log
-
-  # Raises error for missing translations
-  # config.action_view.raise_on_missing_translations = true
-end

data/example/config/environments/production.rb

@@ -1,63 +0,0 @@
-Rails.application.configure do
-  # Settings specified here will take precedence over those in config/application.rb.
-
-  # Code is not reloaded between requests.
-  config.cache_classes = true
-
-  # Eager load code on boot. This eager loads most of Rails and
-  # your application in memory, allowing both threaded web servers
-  # and those relying on copy on write to perform better.
-  # Rake tasks automatically ignore this option for performance.
-  config.eager_load = true
-
-  # Full error reports are disabled and caching is turned on.
-  config.consider_all_requests_local       = false
-  config.action_controller.perform_caching = true
-
-  # Enable Rack::Cache to put a simple HTTP cache in front of your application
-  # Add `rack-cache` to your Gemfile before enabling this.
-  # For large-scale production use, consider using a caching reverse proxy like
-  # NGINX, varnish or squid.
-  # config.action_dispatch.rack_cache = true
-
-  # Disable serving static files from the `/public` folder by default since
-  # Apache or NGINX already handles this.
-  config.serve_static_files = ENV['RAILS_SERVE_STATIC_FILES'].present?
-
-  # Specifies the header that your server uses for sending files.
-  # config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
-  # config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for NGINX
-
-  # Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies.
-  # config.force_ssl = true
-
-  # Use the lowest log level to ensure availability of diagnostic information
-  # when problems arise.
-  config.log_level = :debug
-
-  # Prepend all log lines with the following tags.
-  # config.log_tags = [ :subdomain, :uuid ]
-
-  # Use a different logger for distributed setups.
-  # config.logger = ActiveSupport::TaggedLogging.new(SyslogLogger.new)
-
-  # Use a different cache store in production.
-  # config.cache_store = :mem_cache_store
-
-  # Enable serving of images, stylesheets, and JavaScripts from an asset server.
-  # config.action_controller.asset_host = 'http://assets.example.com'
-
-  # Ignore bad email addresses and do not raise email delivery errors.
-  # Set this to true and configure the email server for immediate delivery to raise delivery errors.
-  # config.action_mailer.raise_delivery_errors = false
-
-  # Enable locale fallbacks for I18n (makes lookups for any locale fall back to
-  # the I18n.default_locale when a translation cannot be found).
-  config.i18n.fallbacks = true
-
-  # Send deprecation notices to registered listeners.
-  config.active_support.deprecation = :notify
-
-  # Use default logging formatter so that PID and timestamp are not suppressed.
-  config.log_formatter = ::Logger::Formatter.new
-end

data/example/config/environments/test.rb

@@ -1,42 +0,0 @@
-Rails.application.configure do
-  # Settings specified here will take precedence over those in config/application.rb.
-
-  # The test environment is used exclusively to run your application's
-  # test suite. You never need to work with it otherwise. Remember that
-  # your test database is "scratch space" for the test suite and is wiped
-  # and recreated between test runs. Don't rely on the data there!
-  config.cache_classes = true
-
-  # Do not eager load code on boot. This avoids loading your whole application
-  # just for the purpose of running a single test. If you are using a tool that
-  # preloads Rails for running tests, you may have to set it to true.
-  config.eager_load = false
-
-  # Configure static file server for tests with Cache-Control for performance.
-  config.serve_static_files   = true
-  config.static_cache_control = 'public, max-age=3600'
-
-  # Show full error reports and disable caching.
-  config.consider_all_requests_local       = true
-  config.action_controller.perform_caching = false
-
-  # Raise exceptions instead of rendering exception templates.
-  config.action_dispatch.show_exceptions = false
-
-  # Disable request forgery protection in test environment.
-  config.action_controller.allow_forgery_protection = false
-
-  # Tell Action Mailer not to deliver emails to the real world.
-  # The :test delivery method accumulates sent emails in the
-  # ActionMailer::Base.deliveries array.
-  # config.action_mailer.delivery_method = :test
-
-  # Randomize the order test cases are executed.
-  config.active_support.test_order = :random
-
-  # Print deprecation notices to the stderr.
-  config.active_support.deprecation = :stderr
-
-  # Raises error for missing translations
-  # config.action_view.raise_on_missing_translations = true
-end

data/example/config/initializers/backtrace_silencer.rb

@@ -1 +0,0 @@
-Rails.backtrace_cleaner.remove_silencers!

data/example/config/initializers/cookies_serializer.rb

@@ -1,3 +0,0 @@
-# Be sure to restart your server when you modify this file.
-
-Rails.application.config.action_dispatch.cookies_serializer = :json

data/example/config/initializers/filter_parameter_logging.rb

@@ -1,4 +0,0 @@
-# Be sure to restart your server when you modify this file.
-
-# Configure sensitive parameters which will be filtered from the log file.
-Rails.application.config.filter_parameters += [:password]

data/example/config/initializers/jwt_keeper.rb

@@ -1,11 +0,0 @@
-JWTKeeper.configure do |config|
-  config.expiry           = 1.hour
-  config.algorithm        = 'HS512'
-  config.secret           = 'secret'
-  config.issuer           = '.localhost'
-  config.audience         = 'localhost'
-  config.redis_connection = Redis.new(url: ENV['REDIS_URL'])
-  config.version          = 1
-  config.cookie_lock      = true
-  config.cookie_secure    = !(Rails.env.test? || Rails.env.development?)
-end

data/example/config/initializers/session_store.rb

@@ -1,3 +0,0 @@
-# Be sure to restart your server when you modify this file.
-
-Rails.application.config.session_store :cookie_store, key: '_example_session'

data/example/config/initializers/wrap_parameters.rb

@@ -1,9 +0,0 @@
-# Be sure to restart your server when you modify this file.
-
-# This file contains settings for ActionController::ParamsWrapper which
-# is enabled by default.
-
-# Enable parameter wrapping for JSON. You can disable this by setting :format to an empty array.
-ActiveSupport.on_load(:action_controller) do
-  wrap_parameters format: [:json] if respond_to?(:wrap_parameters)
-end

data/example/config/locales/en.yml

@@ -1,23 +0,0 @@
-# Files in the config/locales directory are used for internationalization
-# and are automatically loaded by Rails. If you want to use locales other
-# than English, add the necessary files in this directory.
-#
-# To use the locales, use `I18n.t`:
-#
-#     I18n.t 'hello'
-#
-# In views, this is aliased to just `t`:
-#
-#     <%= t('hello') %>
-#
-# To use a different locale, set it with `I18n.locale`:
-#
-#     I18n.locale = :es
-#
-# This would use the information in config/locales/es.yml.
-#
-# To learn more, please read the Rails Internationalization guide
-# available at http://guides.rubyonrails.org/i18n.html.
-
-en:
-  hello: "Hello world"

data/example/config/routes.rb

@@ -1,3 +0,0 @@
-Rails.application.routes.draw do
-  resource :session, only: [:show, :create, :update, :destroy]
-end

data/example/config/secrets.yml

@@ -1,22 +0,0 @@
-# Be sure to restart your server when you modify this file.
-
-# Your secret key is used for verifying the integrity of signed cookies.
-# If you change this key, all old signed cookies will become invalid!
-
-# Make sure the secret is at least 30 characters and all random,
-# no regular words or you'll be exposed to dictionary attacks.
-# You can use `rake secret` to generate a secure secret key.
-
-# Make sure the secrets in this file are kept private
-# if you're sharing your code publicly.
-
-development:
-  secret_key_base: 82e9f5f97a6b624896c35b930acb75d5d5d9df9aa363a21b4173e8a370480ffd7f329a280223a22f03fc07afd2d28c15fae09087eef781506ffea4954e16e12f
-
-test:
-  secret_key_base: 516e709c30b7198b27d1b2c724e6eaffb13ac2ef0b7d22da67771afdf36f0c6d995e788d12e1da042e739be29d4b2c29ced96d6153f0ad296749570689d9bb4e
-
-# Do not keep production secrets in the repository,
-# instead read values from the environment.
-production:
-  secret_key_base: <%= ENV["SECRET_KEY_BASE"] %>

data/example/config.ru

@@ -1,4 +0,0 @@
-# This file is used by Rack-based servers to start the application.
-
-require ::File.expand_path('../config/environment', __FILE__)
-run Rails.application

data/example/example.env

@@ -1 +0,0 @@
-REDIS_URL=redis://:password@localhost:port