Skip to content

wrk-corp/omniauth-webflow

Repository files navigation

omniauth-webflow

This gem is an OmniAuth 1.0 Strategy for authenticating with the Webflow API (version 1.0.0)

Setup

First, you will need to register your application with Webflow. This can be done on the Integrations tab.

Important: your callback URL should be specified as https://[hostname]/auth/webflow/callback

In order to authenticate with Webflow in both development and production we recommend registering a "-dev" app with Webflow that points at your localhost app. One thing to note here is that Webflow requires your callback url to be https.

After registering a new application with Webflow take note of the client_id and client_secret provided. You should put these into your Rails credentials or store them as environment variables like ENV['WEBFLOW_CLIENT_ID'] and ENV['WEBFLOW_CLIENT_SECRET']

Usage

Add this line to your application's Gemfile:

gem 'omniauth-webflow'

And then execute:

$ bundle install

In your Rails app, add the Webflow provider to your Omniauth middleware, e.g. in a file like config/initializers/omniauth.rb:

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :webflow, ENV['WEBFLOW_CLIENT_ID'], ENV['WEBFLOW_CLIENT_SECRET']
end

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/wrk-corp/omniauth-webflow. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

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

Code of Conduct

Everyone interacting in the Omniauth::Webflow project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.