gonzalo-bulnes/rails-5-token-authentication-demo

Demonstrate the Simple Token Authentication usage in a Rails 5 app.

Demo: Rails 5 Token Authentication

Demonstrate the Simple Token Authentication usage in a Rails 5 app.

This application aims at demonstrating how token authentication can be implemented and tested and documented in a Rails 5 application.

1. Implementation: makes use of Simple Token Authentication
2. Testing and documentation: are performed using RSpec

Usage

Deployment

Local

rackup -p 3000 # see http://localhost:3000

Heroku

Click the button below to automatically set up the demo in an app running on your Heroku account.

Alternatively, you can manually create a Heroku app and use Git to push and deploy.

Testing and documentation

The application specification can be read online or generated locally:

# Run the test suite and output the app specification
rake

User Data and Must See

The demo user is called Alice, she doesn't need to authenticate to accede /, however she can do it through token authentication. See the home page with authentication and without authentication.

On the contrary, she must authenticate in ordder to accede to /restricted_index. Of course, she can do it through token authentication. See the restricted home page with authentication and without authentication.

Hooks

Interested in using hooks? Check your server logs for messages of successful token authentication!

Development

Goals

This application is meant to be used as an example (think "Hello, World!") to implement token authentication features. The main goal is then to keep the implmenetation of each feature as simple as possible to make it as easy to follow as possible. Please keep that in mind when enhancing this demo!

Contributions

Only one of the [many possible token authentication scenarios][scenarios] is demonstrated so far. Contributions are welcome!

Credits

Thank you to @johnmosesman for contributing testing documentation to Simple Token Authentication, that was the inspiration of this demo!

License

Demo: Rails 5 Token Authentication
Copyright (C) 2016 Gonzalo Bulnes Guilpain

This application code is placed in the public domain.

rails-5-token-authentication-demo's Issues

Token auth with only token

Hi,

I would like to use only token for auth rather with email as below.

https://rails-5-token-authentication.herokuapp.com/?user_token=1G8_s7P-V-4MGojaKD7a

So where should I modify to allow only token based auth ?

Thanks.