omniauth-strategies-passthrough

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).

Installation

Install the gem and add to the application’s Gemfile by executing:

bundle add omniauth-strategies-passthrough

If bundler is not being used to manage dependencies, install the gem by executing:

gem install omniauth-strategies-passthrough

Usage

Include 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 and info 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'

Development

  • Run bin/setup to install dependencies.

  • Run bin/rake appraisal spec to run the tests.

  • Run bin/rake rubocop to run the linter.

  • Run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub.

License

The gem is available as open source under the terms of the MIT License.