An OmniAuth strategy that passes request params straight through the middleware.
This strategy allows you to pass auth hash values directly to an auth endpoint and forwards them directly to your callback(s). The end goal of this is to provide more flexibility when writing login helpers in development/test environments while still utilizing your OmniAuth callback(s).
Install the gem and add to the application's Gemfile by executing:
bundle add omniauth-passthroughIf bundler is not being used to manage dependencies, install the gem by executing:
gem install omniauth-passthroughInclude the passthrough strategy in development/test environments as you would with any other OmniAuth strategy. NEVER use it in a production environment.
Once included, any POST request to /auth/passthrough will pass through any uid, info, credentials and extra
params to your omniauth callback.
# request
post '/auth/passthrough', params: { uid: 'my-uid',
info: { email: '[email protected]', first_name: 'My', last_name: 'Name' } }
# callback
request.env['omniauth.auth'].uid # => 'my-uid'
request.env['omniauth.auth'].info.email # => '[email protected]'
request.env['omniauth.auth'].info.first_name # => 'My'
request.env['omniauth.auth'].info.last_name # => 'Name'A number of test helpers are provided to help with using the strategy for test login helpers.
# including one of the following helpers in your test
include Omniauth::Passthrough::RackHelper # if using Rack::Test
include Omniauth::Passthrough::ActionDispatchHelper # if using ActionDispatch (Rails)
include Omniauth::Passthrough::CapybaraHelper # if using Capybara
# will make the following login helper available
omniauth_passthrough(uid: 'my-uid', info: { email: '[email protected]', first_name: 'My', last_name: 'Name' })- Run
bin/setupto install dependencies. - Run
bin/rake appraisal specto run the tests. - Run
bin/rake rubocopto run the linter. - Run
bin/consolefor an interactive prompt that will allow you to experiment.
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/omniauth-passthrough.
The gem is available as open source under the terms of the MIT License.