{"id":13879045,"url":"https://github.com/square/rails-auth","last_synced_at":"2025-06-13T01:39:44.915Z","repository":{"id":56202716,"uuid":"50199704","full_name":"square/rails-auth","owner":"square","description":"Modular resource-based authentication and authorization for Rails/Rack","archived":false,"fork":false,"pushed_at":"2023-01-16T22:43:27.000Z","size":225,"stargazers_count":288,"open_issues_count":5,"forks_count":26,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-04-13T17:52:13.181Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/square.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-22T18:31:44.000Z","updated_at":"2024-02-24T12:37:10.000Z","dependencies_parsed_at":"2023-02-10T06:35:16.686Z","dependency_job_id":null,"html_url":"https://github.com/square/rails-auth","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Frails-auth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Frails-auth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Frails-auth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Frails-auth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/square","download_url":"https://codeload.github.com/square/rails-auth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226138849,"owners_count":17579496,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-06T08:02:07.950Z","updated_at":"2024-11-24T07:31:31.026Z","avatar_url":"https://github.com/square.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"Rails::Auth\n===========\n[![Gem Version](https://badge.fury.io/rb/rails-auth.svg)](http://rubygems.org/gems/rails-auth)\n[![Build Status](https://travis-ci.org/square/rails-auth.svg?branch=master)](https://travis-ci.org/square/rails-auth)\n[![Code Climate](https://codeclimate.com/github/square/rails-auth/badges/gpa.svg)](https://codeclimate.com/github/square/rails-auth)\n[![Coverage Status](https://coveralls.io/repos/github/square/rails-auth/badge.svg?branch=master)](https://coveralls.io/github/square/rails-auth?branch=master)\n[![Apache 2 licensed](https://img.shields.io/badge/license-Apache2-blue.svg)](https://github.com/square/rails-auth/blob/master/LICENSE)\n\nModular resource-based authentication and authorization for Rails/Rack designed\nto support [microservice] authentication and [claims-based identity].\n\n[microservice]: http://martinfowler.com/articles/microservices.html\n[claims-based identity]: https://en.wikipedia.org/wiki/Claims-based_identity\n\n## Description\n\nRails::Auth is a flexible library designed for both authentication (AuthN) and authorization (AuthZ) using Rack Middleware.\nIt [splits AuthN and AuthZ steps into separate middleware classes][design overview], using AuthN middleware to first verify\ncredentials (such as X.509 certificates or cookies), then authorizing the request via separate AuthZ middleware that\nconsumes these credentials, e.g. [access control lists][acls] (ACLs).\n\nRails::Auth can be used to authenticate and authorize end users using browser cookies, service-to-service requests using\n[X.509 client certificates][x509], or any other clients with credentials that have proper authenticating middleware.\n\nDespite what the name may lead you to believe, Rails::Auth also [works well with other Rack-based frameworks][rack]\nlike Sinatra.\n\n[design overview]: https://github.com/square/rails-auth/wiki/Design-Overview\n[acls]: https://github.com/square/rails-auth/wiki/Access-Control-Lists\n[x509]: https://github.com/square/rails-auth/wiki/X.509\n[rack]: https://github.com/square/rails-auth/wiki/Rack-Usage\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'rails-auth'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install rails-auth\n\n## Comparison to other Rails/Rack auth libraries/frameworks\n\nFor a comparison of Rails::Auth to other Rails auth libraries, including\ncomplimentary libraries and those that Rails::Auth overlaps/competes with,\nplease see this page on the Wiki:\n\n[Comparison With Other Libraries](https://github.com/square/rails-auth/wiki/Comparison-With-Other-Libraries)\n\n## Documentation\n\nDocumentation can be found on the Wiki at: https://github.com/square/rails-auth/wiki\n\nYARD documentation is also available: http://www.rubydoc.info/github/square/rails-auth/master\n\nPlease see the following page for how to add Rails::Auth to a Rails app:\n\n[Rails Usage](https://github.com/square/rails-auth/wiki/Rails-Usage)\n\n## Contributing\n\nAny contributors to the master *rails-auth* repository must sign the\n[Individual Contributor License Agreement (CLA)]. It's a short form that covers\nour bases and makes sure you're eligible to contribute.\n\nWhen you have a change you'd like to see in the master repository, send a\n[pull request]. Before we merge your request, we'll make sure you're in the list\nof people who have signed a CLA.\n\n[Individual Contributor License Agreement (CLA)]: https://spreadsheets.google.com/spreadsheet/viewform?formkey=dDViT2xzUHAwRkI3X3k5Z0lQM091OGc6MQ\u0026ndplr=1\n[pull request]: https://github.com/square/rails-auth/pulls\n\n## License\n\nCopyright (c) 2016 Square Inc. Distributed under the Apache 2.0 License.\nSee LICENSE file for further details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Frails-auth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquare%2Frails-auth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Frails-auth/lists"}