EPB Authentication and Authorisation Tools

This RubyGem provides a set of tools to use along with communitiesuk/epb-auth-server. There are two primary components: middleware for validating JWTs in sinatra apps, and a HTTP client that provides a mechanism for making authenticated requests.

To install all required libs and other info, run make install.

To test the gem, run make test.

To ensure that all your code looks nice and conforms to the repo standards, run make format.

The epb-auth-tools module has a sinatra conditional routing helper class.

To use this simply require epb-auth-tools and define the following in your application class.

# frozen_string_literal: true

require 'sinatra'
require 'epb-auth-tools'

class AppService < Sinatra::Base
  set(:jwt_auth) do
    condition do
      Auth::Sinatra::Conditional.process_request env
    rescue Auth::Errors::Error => e
      content_type :json
      halt 401, { error: e }.to_json
    end
  end

  get '/', jwt_auth: [] do
    content_type :json
    status 200
    { message: 'authenticated' }.to_json
  end
end