Welcome to Hadley¶ ↑

Hadley is rack middleware built on top of the excellent security authentication middleware warden. Hadley enables Rack-based web applications to easily become AFID protected resource servers.

Getting Started¶ ↑

Rails:

1. Add gem 'hadley' to your Gemfile

2. Run bundle from your project root

3. Run touch config/initializers/hadley.rb from your project root

4. Add warden and hadley to your middleware stack by opening config/initializers/hadlery.rb in your favorite text editor and adding the following:

   token_store = Hadley::TokenStore.new(Rails.cache)
   
   MyApp::Application.config.middleware.insert_after ActionDispatch::Session::CookieStore, Warden::Manager do |manager|
     # setup authentication for the afid server to provision and revoke access tokens
     manager.basic(:server) do |basic|
       basic.hash_credentials true
       basic.lookup do |id, secret|
         [ id, secret ] == [ 'my_hashed_id', 'my_hashed_secret' ] ? id : nil
       end
     end
     # setup authentication for afid clients to authenticate in anonymous mode (client_credentials grant type in OAuth2
     # parlance)
     manager.bearer(:client) do |bearer|
       bearer.token_store token_store
       bearer.anonymous_allowed true
     end
     # setup authentication for afid clients to access apis on behalf of a particular user (authorization_grant grant
     # type in OAuth2 parlance)
     manager.bearer(:user) do |bearer|
       bearer.token_store token_store
       bearer.anonymous_allowed false
     end
   end
   
   MyApp::Application.config.middleware.insert_after Warden::Manager, Hadley::Middleware, token_store: token_store
   

5. Run rake middleware from your project root and verify that Warden::Manager appears after ActionDispatch::Session::CookieStore and Hadley::Middleware appears after Warden::Manager