This gem provides the extracted Token Authenticatable module of devise. It includes the functionality that was also in version 3.1.2 of devise. With the inclusion of this module a user is able to sign in via an authentication token. This token can be given via a query string or HTTP Basic Authentication. See the hint below to understand which version of this gem supports which version of devise.
Use this gem as a starting point for your own token authentication mechanism for devise. Furthermore, if you need token authentication in connection with newer devise releases this gem might be an appropriate solution, too.
Add this line to your application's Gemfile:
gem 'devise-token_authenticatable'
And then execute:
$ bundle
Or install it yourself as:
$ gem install devise-token_authenticatable
devise-token_authenticatable | devise |
---|---|
0.1.0 | ~> 3.2.0 |
0.2.0 | ~> 3.3.0 |
0.3.0 | ~> 3.4.0 |
Add :token_authenticatable
to your devise model:
class User < ActiveRecord::Base
devise :database_authenticatable, :token_authenticatable
end
The authentication key name used by this module defaults to auth_token
. Use the following configuration (e.g., in a Rails initializer) to alter the name:
Devise::TokenAuthenticatable.setup do |config|
config.token_authentication_key = :other_key_name
end
For your convenience there is also a source code documentation.
- Fork it.
- Create your feature branch (
git checkout -b my-new-feature
). - Commit your changes (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin my-new-feature
). - Create new Pull Request.
- Get a thank you!