base on Token based authentication for Rails JSON APIs. Designed to work with jToker and ng-token-auth. # Devise Token Auth [](http://badge.fury.io/rb/devise_token_auth) [](https://github.com/lynndylanhurley/devise_token_auth/actions/workflows/test.yml) [](https://codeclimate.com/github/lynndylanhurley/devise_token_auth) [](https://codeclimate.com/github/lynndylanhurley/devise_token_auth/coverage) [](https://rubygems.org/gems/devise_token_auth) [](#backers) [](#sponsors) [](https://gitter.im/lynndylanhurley/devise_token_auth?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) Simple, multi-client and secure token-based authentication for Rails. If you're building SPA or a mobile app, and you want authentication, you need tokens, not cookies. This gem refreshes the tokens on each request, and expires them in a short time, so the app is secure. Also, it maintains a session for each client/device, so you can have as many sessions as you want. ## Main features * Seamless integration with: * [ng-token-auth](https://github.com/lynndylanhurley/ng-token-auth) for [AngularJS](https://github.com/angular/angular.js) * [Angular-Token](https://github.com/neroniaky/angular-token) for [Angular](https://github.com/angular/angular) * [redux-token-auth](https://github.com/kylecorbelli/redux-token-auth) for [React with Redux](https://github.com/reactjs/react-redux) * [jToker](https://github.com/lynndylanhurley/j-toker) for [jQuery](https://jquery.com/) * [vanilla-token-auth](https://github.com/theblang/vanilla-token-auth) for an unopinionated client * Oauth2 authentication using [OmniAuth](https://github.com/intridea/omniauth). * Email authentication using [Devise](https://github.com/plataformatec/devise), including: * User registration, update and deletion * Login and logout * Password reset, account confirmation * Support for [multiple user models](./docs/usage/multiple_models.md). * It is [secure](docs/security.md). This project leverages the following gems: * [Devise](https://github.com/plataformatec/devise) * [OmniAuth](https://github.com/intridea/omniauth) ## Installation Add the following to your `Gemfile`: ~~~ruby gem 'devise_token_auth' ~~~ Then install the gem using bundle: ~~~bash bundle install ~~~ ## [Docs](https://devise-token-auth.gitbook.io/devise-token-auth) ## Need help? Please use [StackOverflow](https://stackoverflow.com/questions/tagged/devise-token-auth) for help requests and how-to questions. Please open GitHub issues for bugs and enhancements only, not general help requests. Please search previous issues (and Google and StackOverflow) before creating a new issue. Please read the [issue template](https://github.com/lynndylanhurley/devise_token_auth/blob/master/.github/ISSUE_TEMPLATE.md) before posting issues. ## [FAQ](docs/faq.md) ## Contributors wanted! See our [Contribution Guidelines](https://github.com/lynndylanhurley/devise_token_auth/blob/master/.github/CONTRIBUTING.md). Feel free to submit pull requests, review pull requests, or review open issues. If you'd like to get in contact, [Zach Feldman](https://github.com/zachfeldman) has been wrangling this effort, you can reach him with his name @gmail. Further discussion of this in [this issue](https://github.com/lynndylanhurley/devise_token_auth/issues/969). We have some bounties for some issues, [check them out](https://github.com/lynndylanhurley/devise_token_auth/issues?q=is%3Aopen+is%3Aissue+label%3Abounty)! ## Live Demos [Here is a demo](https://stackblitz.com/github/neroniaky/angular-token) of this app running with the [Angular-Token](https://github.com/neroniaky/angular-token) service and [Angular](https://github.com/angular/angular). The fully configured api used in these demos can be found [here](https://github.com/lynndylanhurley/devise_token_auth_demo). ## Contributors <a href="graphs/contributors"><img src="https://opencollective.com/devise_token_auth/contributors.svg?width=890&button=false" /></a> ## Backers Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/devise_token_auth#backer)] [](https://opencollective.com/devise_token_auth#backers) ## Sponsors Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/devise_token_auth#sponsor)] [](https://opencollective.com/devise_token_auth/sponsor/0/website) [](https://opencollective.com/devise_token_auth/sponsor/1/website) [](https://opencollective.com/devise_token_auth/sponsor/2/website) [](https://opencollective.com/devise_token_auth/sponsor/3/website) [](https://opencollective.com/devise_token_auth/sponsor/4/website) [](https://opencollective.com/devise_token_auth/sponsor/5/website) [](https://opencollective.com/devise_token_auth/sponsor/6/website) [](https://opencollective.com/devise_token_auth/sponsor/7/website) [](https://opencollective.com/devise_token_auth/sponsor/8/website) [](https://opencollective.com/devise_token_auth/sponsor/9/website) ## License This project uses the WTFPL ", Assign "at most 3 tags" to the expected json: {"id":"1228","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"