{"id":13879061,"url":"https://github.com/omniauth/omniauth-identity","last_synced_at":"2025-12-16T21:20:50.578Z","repository":{"id":1711474,"uuid":"2441054","full_name":"omniauth/omniauth-identity","owner":"omniauth","description":"A simple login and password strategy for OmniAuth.","archived":false,"fork":false,"pushed_at":"2025-05-09T09:40:53.000Z","size":1679,"stargazers_count":348,"open_issues_count":2,"forks_count":98,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-05-12T16:15:20.987Z","etag":null,"topics":["authentication","authentication-middleware","authentication-strategy","omniauth","omniauth-strategy"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omniauth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"buy_me_a_coffee":"pboling","community_bridge":null,"github":["pboling"],"issuehunt":"pboling","ko_fi":"pboling","liberapay":"pboling","open_collective":null,"patreon":"galtzo","polar":"pboling","thanks_dev":"u/gh/pboling","tidelift":"rubygems/omniauth-identity"}},"created_at":"2011-09-23T00:18:06.000Z","updated_at":"2025-05-09T09:40:56.000Z","dependencies_parsed_at":"2024-01-13T20:56:34.330Z","dependency_job_id":"ed8179ef-f29d-4c6e-883d-6289ee3856e2","html_url":"https://github.com/omniauth/omniauth-identity","commit_stats":{"total_commits":296,"total_committers":29,"mean_commits":"10.206896551724139","dds":"0.33783783783783783","last_synced_commit":"f37d5c05beb3f315c24aa91dfe0a0344bd6ebf8e"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omniauth%2Fomniauth-identity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omniauth%2Fomniauth-identity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omniauth%2Fomniauth-identity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omniauth%2Fomniauth-identity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omniauth","download_url":"https://codeload.github.com/omniauth/omniauth-identity/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253778497,"owners_count":21962876,"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":["authentication","authentication-middleware","authentication-strategy","omniauth","omniauth-strategy"],"created_at":"2024-08-06T08:02:08.482Z","updated_at":"2025-12-16T21:20:50.567Z","avatar_url":"https://github.com/omniauth.png","language":"Ruby","funding_links":["https://buymeacoffee.com/pboling","https://github.com/sponsors/pboling","https://issuehunt.io/r/pboling","https://ko-fi.com/pboling","https://liberapay.com/pboling","https://patreon.com/galtzo","https://polar.sh/pboling","https://thanks.dev/u/gh/pboling","https://tidelift.com/funding/github/rubygems/omniauth-identity","https://tidelift.com/badges/package/rubygems/omniauth-identity","https://tidelift.com/subscription/pkg/rubygems-omniauth-identity?utm_source=rubygems-omniauth-identity\u0026utm_medium=referral\u0026utm_campaign=readme","https://liberapay.com/pboling/donate","https://ko-fi.com/O5O86SNP4","https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte\u0026emoji=\u0026slug=pboling\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Cookie\u0026outline_colour=000000\u0026coffee_colour=ffffff","https://www.buymeacoffee.com/pboling","https://www.paypal.com/paypalme/peterboling","https://blog.tidelift.com/tidelift-joins-sonar"],"categories":["Ruby"],"sub_categories":[],"readme":"| 📍 NOTE                                                                                                                                                           |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| RubyGems (the [GitHub org][rubygems-org], not the website) [suffered][draper-security] a [hostile takeover][ellen-takeover] in September 2025.                    |\n| Ultimately [4 maintainers][simi-removed] were [hard removed][martin-removed] and a reason has been given for only 1 of those, while 2 others resigned in protest. |\n| It is a [complicated story][draper-takeover] which is difficult to [parse quickly][draper-lies].                                                                  |\n| I'm adding notes like this to gems because I [don't condone theft][draper-theft] of repositories or gems from their rightful owners.                              |\n| If a similar theft happened with my repos/gems, I'd hope some would stand up for me.                                                                              |\n| Disenfranchised former-maintainers have started [gem.coop][gem-coop].                                                                                             |\n| Once available I will publish there exclusively; unless RubyCentral makes amends with the community.                                                              |\n| The [\"Technology for Humans: Joel Draper\"][reinteractive-podcast] podcast episode by [reinteractive][reinteractive] is the most cogent summary I'm aware of.      |\n| See [here][gem-naming], [here][gem-coop] and [here][martin-ann] for more info on what comes next.                                                                 |\n| What I'm doing: A (WIP) proposal for [bundler/gem scopes][gem-scopes], and a (WIP) proposal for a federated [gem server][gem-server].                             |\n\n[rubygems-org]: https://github.com/rubygems/\n[draper-security]: https://joel.drapper.me/p/ruby-central-security-measures/\n[draper-takeover]: https://joel.drapper.me/p/ruby-central-takeover/\n[ellen-takeover]: https://pup-e.com/blog/goodbye-rubygems/\n[simi-removed]: https://www.reddit.com/r/ruby/s/gOk42POCaV\n[martin-removed]: https://bsky.app/profile/martinemde.com/post/3m3occezxxs2q\n[draper-lies]: https://joel.drapper.me/p/ruby-central-fact-check/\n[draper-theft]: https://joel.drapper.me/p/ruby-central/\n[reinteractive]: https://reinteractive.com/ruby-on-rails\n[gem-coop]: https://gem.coop\n[gem-naming]: https://github.com/gem-coop/gem.coop/issues/12\n[martin-ann]: https://martinemde.com/2025/10/05/announcing-gem-coop.html\n[gem-scopes]: https://github.com/galtzo-floss/bundle-namespace\n[gem-server]: https://github.com/galtzo-floss/gem-server\n[reinteractive-podcast]: https://youtu.be/_H4qbtC5qzU?si=BvuBU90R2wAqD2E6\n\n[![Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0][🖼️galtzo-i]][🖼️galtzo-discord] [![omniauth Logo by tomeara(?), MIT License][🖼️omniauth-i]][🖼️omniauth] [![ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5][🖼️ruby-lang-i]][🖼️ruby-lang]\n\n[🖼️galtzo-i]: https://logos.galtzo.com/assets/images/galtzo-floss/avatar-192px.svg\n[🖼️galtzo-discord]: https://discord.gg/3qme4XHNKN\n[🖼️ruby-lang-i]: https://logos.galtzo.com/assets/images/ruby-lang/avatar-192px.svg\n[🖼️ruby-lang]: https://www.ruby-lang.org/\n[🖼️omniauth-i]: https://logos.galtzo.com/assets/images/omniauth/avatar-182px.png\n[🖼️omniauth]: https://github.com/omniauth/omniauth-identity\n\n# 🫵 OmniAuth::Identity\n\n[![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license-ref] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![Open Source Helpers][👽oss-helpi]][👽oss-help] [![CodeCov Test Coverage][🏀codecovi]][🏀codecov] [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls] [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov] [![QLTY Maintainability][🏀qlty-mnti]][🏀qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Supported][🚎6-s-wfi]][🚎6-s-wf] [![CI Legacy][🚎4-lg-wfi]][🚎4-lg-wf] [![CI Unsupported][🚎7-us-wfi]][🚎7-us-wf] [![CI Ancient][🚎1-an-wfi]][🚎1-an-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![CodeQL][🖐codeQL-img]][🖐codeQL] [![Apache SkyWalking Eyes License Compatibility Check][🚎15-🪪-wfi]][🚎15-🪪-wf]\n\n`if ci_badges.map(\u0026:color).detect { it != \"green\"}` ☝️ [let me know][🖼️galtzo-discord], as I may have missed the [discord notification][🖼️galtzo-discord].\n\n---\n\n`if ci_badges.map(\u0026:color).all? { it == \"green\"}` 👇️ send money so I can do more of this. FLOSS maintenance is now my full-time job.\n\n[![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate at ko-fi.com][🖇kofi-img]][🖇kofi]\n\n## 🌻 Synopsis\n\nThe `omniauth-identity` gem provides a way for applications to utilize a\ntraditional username/password based authentication system without the need\nto give up the simple authentication flow provided by OmniAuth. Identity\nis designed on purpose to be as featureless as possible: it provides the\nbasic construct for user management and then gets out of the way.\n\n## 💡 Info you can shake a stick at\n\n| Tokens to Remember      | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace]                                                                                                                                                                                                                                                                          |\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Works with JRuby        | ![JRuby 9.1 Compat][💎jruby-9.1i] ![JRuby 9.2 Compat][💎jruby-9.2i] ![JRuby 9.3 Compat][💎jruby-9.3i] \u003cbr/\u003e [![JRuby 9.4 Compat][💎jruby-9.4i]][🚎10-j-wf] [![JRuby 10.0 Compat][💎jruby-c-i]][🚎11-c-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]                                                                                                          |\n| Works with Truffle Ruby | ![Truffle Ruby 22.3 Compat][💎truby-22.3i] ![Truffle Ruby 23.0 Compat][💎truby-23.0i] \u003cbr/\u003e [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎9-t-wf] [![Truffle Ruby 24.1 Compat][💎truby-c-i]][🚎11-c-wf]                                                                                                                                                            |\n| Works with MRI Ruby 3   | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎4-lg-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎6-s-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎6-s-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎6-s-wf] [![Ruby 3.4 Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]                                                                                         |\n| Works with MRI Ruby 2   | [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎1-an-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎1-an-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎7-us-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎7-us-wf]                              |\n| Support \u0026 Community     | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]                                       |\n| Source                  | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc]                                                                                                                                                         |\n| Documentation           | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki]                                                                                          |\n| Compliance              | [![License: MIT][📄license-img]][📄license-ref] [![Compatible with Apache Software Projects: Verified by SkyWalking Eyes][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |\n| Style                   | [![Enforced Code Style Linter][💎rlts-img]][💎rlts] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] [![Gitmoji Commits][📌gitmoji-img]][📌gitmoji] [![Compatibility appraised by: appraisal2][💎appraisal2-img]][💎appraisal2]                                                                                                                  |\n| Maintainer 🎖️          | [![Follow Me on LinkedIn][💖🖇linkedin-img]][💖🖇linkedin] [![Follow Me on Ruby.Social][💖🐘ruby-mast-img]][💖🐘ruby-mast] [![Follow Me on Bluesky][💖🦋bluesky-img]][💖🦋bluesky] [![Contact Maintainer][🚂maint-contact-img]][🚂maint-contact] [![My technical writing][💖💁🏼‍♂️devto-img]][💖💁🏼‍♂️devto]                                                      |\n| `...` 💖                | [![Find Me on WellFound:][💖✌️wellfound-img]][💖✌️wellfound] [![Find Me on CrunchBase][💖💲crunchbase-img]][💖💲crunchbase] [![My LinkTree][💖🌳linktree-img]][💖🌳linktree] [![More About Me][💖💁🏼‍♂️aboutme-img]][💖💁🏼‍♂️aboutme] [🧊][💖🧊berg] [🐙][💖🐙hub]  [🛖][💖🛖hut] [🧪][💖🧪lab]                                                                   |\n\n### Compatibility\n\nCompatible with MRI Ruby 2.4+, and concordant releases of JRuby, and TruffleRuby.\n\n| 🚚 _Amazing_ test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚             |\n|------------------------------------------------|--------------------------------------------------------|\n| 👟 Check it out!                               | ✨ [github.com/appraisal-rb/appraisal2][💎appraisal2] ✨ |\n\n### Federated DVCS\n\n\u003cdetails\u003e\n  \u003csummary\u003eFind this repo on federated forges (Coming soon!)\u003c/summary\u003e\n\n| Federated [DVCS][💎d-in-dvcs] Repository        | Status                                                                | Issues                    | PRs                      | Wiki                      | CI                       | Discussions                  |\n|-------------------------------------------------|-----------------------------------------------------------------------|---------------------------|--------------------------|---------------------------|--------------------------|------------------------------|\n| 🧪 [omniauth/omniauth-identity on GitLab][📜src-gl]   | The Truth                                                             | [💚][🤝gl-issues]         | [💚][🤝gl-pulls]         | [💚][📜gl-wiki]           | 🐭 Tiny Matrix           | ➖                            |\n| 🧊 [omniauth/omniauth-identity on CodeBerg][📜src-cb] | An Ethical Mirror ([Donate][🤝cb-donate])                             | [💚][🤝cb-issues]         | [💚][🤝cb-pulls]         | ➖                         | ⭕️ No Matrix             | ➖                            |\n| 🐙 [omniauth/omniauth-identity on GitHub][📜src-gh]   | Another Mirror                                                        | [💚][🤝gh-issues]         | [💚][🤝gh-pulls]         | [💚][📜gh-wiki]           | 💯 Full Matrix           | [💚][gh-discussions]         |\n| 🎮️ [Discord Server][✉️discord-invite]          | [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] | [Let's][✉️discord-invite] | [talk][✉️discord-invite] | [about][✉️discord-invite] | [this][✉️discord-invite] | [library!][✉️discord-invite] |\n\n\u003c/details\u003e\n\n[gh-discussions]: https://github.com/omniauth/omniauth-identity/discussions\n\n### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/omniauth-identity)](https://tidelift.com/subscription/pkg/rubygems-omniauth-identity?utm_source=rubygems-omniauth-identity\u0026utm_medium=referral\u0026utm_campaign=readme)\n\nAvailable as part of the Tidelift Subscription.\n\n\u003cdetails\u003e\n  \u003csummary\u003eNeed enterprise-level guarantees?\u003c/summary\u003e\n\nThe maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.\n\n[![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]\n\n- 💡Subscribe for support guarantees covering _all_ your FLOSS dependencies\n- 💡Tidelift is part of [Sonar][🏙️entsup-tidelift-sonar]\n- 💡Tidelift pays maintainers to maintain the software you depend on!\u003cbr/\u003e📊`@`Pointy Haired Boss: An [enterprise support][🏙️entsup-tidelift] subscription is \"[never gonna let you down][🧮kloc]\", and *supports* open source maintainers\n\nAlternatively:\n\n- [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]\n- [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork]\n- [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]\n\n\u003c/details\u003e\n\n## ✨ Installation\n\nInstall the gem and add to the application's Gemfile by executing:\n\n```console\nbundle add omniauth-identity\n```\n\nIf bundler is not being used to manage dependencies, install the gem by executing:\n\n```console\ngem install omniauth-identity\n```\n\n### 🔒 Secure Installation\n\n\u003cdetails\u003e\n  \u003csummary\u003eFor Medium or High Security Installations\u003c/summary\u003e\n\nThis gem is cryptographically signed, and has verifiable [SHA-256 and SHA-512][💎SHA_checksums] checksums by\n[stone_checksums][💎stone_checksums]. Be sure the gem you install hasn’t been tampered with\nby following the instructions below.\n\nAdd my public key (if you haven’t already, expires 2045-04-29) as a trusted certificate:\n\n```console\ngem cert --add \u003c(curl -Ls https://raw.github.com/galtzo-floss/certs/main/pboling.pem)\n```\n\nYou only need to do that once.  Then proceed to install with:\n\n```console\ngem install omniauth-identity -P HighSecurity\n```\n\nThe `HighSecurity` trust profile will verify signed gems, and not allow the installation of unsigned dependencies.\n\nIf you want to up your security game full-time:\n\n```console\nbundle config set --global trust-policy MediumSecurity\n```\n\n`MediumSecurity` instead of `HighSecurity` is necessary if not all the gems you use are signed.\n\nNOTE: Be prepared to track down certs for signed gems and add them the same way you added mine.\n\n\u003c/details\u003e\n\n## ⚙️ Configuration\n\nThis gem is compatible with a wide range of Ruby versions and Ruby ORMs, as of May 2025, version 3.1.\n\n* Tested in CI against:\n  * Ruby 2.4, 2.5, 2.6, 2.7, 3.0, 3.1, 3.2, 3.3, 3.4, ruby-head\n  * JRuby 9.2, 9.3, 9.4, 10.0, jruby-head\n  * omniauth 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 1.9, 2.0, 2.1, HEAD\n  * activerecord 5.2, 6.0, 6.1, 7.0, 7.1, 7.2, 8.0, HEAD\n  * sqlite3 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 2.0, 2.1\n  * couch_potato 1.17+\n  * mongoid 7.3, 7.4, 8.1, 9.0\n  * bson 4.12, 4.15, 5.0, HEAD\n  * sequel 5.86+\n  * rom-sql (Ruby Object Mapper) 3.7+\n* At least 6 different database ORM adapters, which connect to 15 different database clients!\n\n| Databases                                                                                                 | Adapter Libraries                                                        |\n|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|\n| MySQL, MariaDB, PostgreSQL, SQLite                                                                        | [ActiveRecord](https://guides.rubyonrails.org/active_record_basics.html) |\n| CouchDB                                                                                                   | [CouchPotato](https://github.com/langalex/couch_potato)                  |\n| MongoDB                                                                                                   | [Mongoid](https://github.com/mongodb/mongoid)                            |\n| RethinkDB                                                                                                 | [NoBrainer](http://nobrainer.io/)                                        |\n| ADO, Amalgalite, IBM_DB, JDBC, MySQL, MariaDB, ODBC, Oracle, PostgreSQL, SQLAnywhere, SQLite, and TinyTDS | [rom-sql](https://rom-rb.org/)                                           |\n| ADO, Amalgalite, IBM_DB, JDBC, MySQL, MariaDB, ODBC, Oracle, PostgreSQL, SQLAnywhere, SQLite, and TinyTDS | [Sequel](http://sequel.jeremyevans.net)                                  |\n\n## 🔧 Basic Usage\n\nThis can be a bit hard to understand the first time. Luckily, Ryan Bates made\na [Railscast](http://railscasts.com/episodes/304-omniauth-identity) about it!\n\nYou use `omniauth-identity` just like you would any other OmniAuth provider: as a\nRack middleware. In rails, this would be created by an initializer, such as\n`config/initializers/omniauth.rb`. The basic setup for an email/password authentication would look something like this:\n\n```ruby\nuse OmniAuth::Builder do\n  provider :identity,                 # required: tells OA that the Identity strategy is being used\n    model: Identity,                  # optional: specifies the name of the \"Identity\" model. Defaults to \"Identity\"\n    fields: %i[email custom1 custom2] # optional: list of custom fields that are in the model's table\nend\n```\n\nNext, you need to create a model (called `Identity` by default, or specified\nwith `:model` argument above) that will be able to persist the information\nprovided by the user. Luckily for you, there are pre-built models for popular\nORMs that make this dead simple.\n\nOnce you've got an `Identity` persistence model and the strategy up and\nrunning, you can point users to `/auth/identity` and it will request\nthat they log in or give them the opportunity to sign up for an account.\nOnce they have authenticated with their identity, OmniAuth will call\nthrough to `/auth/identity/callback` with the same kinds of information\nit would have had the user authenticated through an external provider.\n\n**Note:** OmniAuth Identity is different from many other user authentication\nsystems in that it is *not* built to store authentication information in your primary\n`User` model. Instead, the `Identity` model should be **associated** with your\n`User` model giving you maximum flexibility to include other authentication\nstrategies such as Facebook, Twitter, etc.\n\n### ActiveRecord\n\nJust subclass `OmniAuth::Identity::Models::ActiveRecord` and provide fields\nin the database for all the fields you are using.\n\n```ruby\nclass Identity \u003c OmniAuth::Identity::Models::ActiveRecord\n  auth_key :email    # optional: specifies the field within the model that will be used during the login process\n                     # defaults to email, but may be username, uid, login, etc.\n\n  # Anything else you want!\nend\n```\n\n### Sequel\n\n[Sequel](http://sequel.jeremyevans.net/) is an alternative to ActiveRecord.\n\nJust include `OmniAuth::Identity::Models::Sequel` mixin, and specify\nwhatever else you will need.\n\n```ruby\nclass SequelTestIdentity \u003c Sequel::Model(:identities)\n  include ::OmniAuth::Identity::Models::Sequel\n\n  auth_key :email\n  # whatever else you want!\nend\n```\n\n### Mongoid\n\nInclude the `OmniAuth::Identity::Models::Mongoid` mixin and specify\nfields that you will need.\n\n```ruby\nclass Identity\n  include ::Mongoid::Document\n  include ::OmniAuth::Identity::Models::Mongoid\n\n  field :email, type: String\n  field :name, type: String\n  field :password_digest, type: String\nend\n```\n\n### CouchPotato\n\nInclude the `OmniAuth::Identity::Models::CouchPotatoModule` mixin and specify\nfields that you will need.\n\n```ruby\nclass Identity\n  # NOTE: CouchPotato::Persistence must be included before OmniAuth::Identity::Models::CouchPotatoModule\n  include ::CouchPotato::Persistence\n  include ::OmniAuth::Identity::Models::CouchPotatoModule\n\n  property :email\n  property :password_digest\n\n  def self.where(search_hash)\n    CouchPotato.database.view(Identity.by_email(key: search_hash))\n  end\n\n  view :by_email, key: :email\nend\n```\n\n### NoBrainer\n\n[NoBrainer](http://nobrainer.io/) is an ORM for [RethinkDB](https://rethinkdb.com/).\n\nInclude the `OmniAuth::Identity::Models::NoBrainer` mixin and specify\nfields that you will need.\n\n```ruby\nclass Identity\n  include ::NoBrainer::Document\n  include ::OmniAuth::Identity::Models::NoBrainer\n\n  auth_key :email\nend\n```\n\n### Ruby Object Mapper\n\n[ROM](https://rom-rb.org/) is an ORM for pretty much every database.\n\nInclude the `OmniAuth::Identity::Models::Rom` mixin and specify\nthe `rom_container`, everything else is optional.\n\n```ruby\nclass Identity\n  include OmniAuth::Identity::Models::Rom\n\n  # Configure the ROM container and relation\n  rom_container -\u003e { MyDatabase.rom } # See spec_orms/rom_spec.rb for example\n  rom_relation_name :identities # optional, defaults to :idneitities\n  owner_relation_name :owners  # optional, for loading associated owner\n  auth_key :email  # optional, defaults to :email\n  password_field :password_digest  # optional, defaults to :password_digest\nend\n```\n\n### Custom Auth Model\n\nTo use a class other than the default, specify the \u003ctt\u003e:model\u003c/tt\u003e option to a\ndifferent class.\n\n```ruby\nuse OmniAuth::Builder do\n  provider :identity, fields: [:email], model: MyCustomClass\nend\n```\n\nNOTE: In the above example, `MyCustomClass` must have a class method called `auth_key` that returns\nthe default (`email`) or custom `auth_key` to use.\n\n### Customizing Registration Failure\n\nTo use your own custom registration form, create a form that POSTs to\n`/auth/identity/register` with `password`, `password_confirmation`, and your\nother fields.\n\n```erb\n\u003c%= form_tag '/auth/identity/register' do |f| %\u003e\n  \u003ch1\u003eCreate an Account\u003c/h1\u003e\n  \u003c%= text_field_tag :email %\u003e\n  \u003c%= password_field_tag :password %\u003e\n  \u003c%= password_field_tag :password_confirmation %\u003e\n  \u003c%= submit_tag %\u003e\n\u003c% end %\u003e\n```\n\nBeware not to nest your form parameters within a namespace. This strategy\nlooks for the form parameters at the top level of the post params. If you are\nusing [simple\\_form](https://github.com/plataformatec/simple_form), then you\ncan avoid the params nesting by specifying `:input_html`.\n\n```erb\n\u003c%= simple_form_for @identity, :url =\u003e '/auth/identity/register' do |f| %\u003e\n  \u003ch1\u003eCreate an Account\u003c/h1\u003e\n  \u003c%# specify :input_html to avoid params nesting %\u003e\n  \u003c%= f.input :email, :input_html =\u003e {:name =\u003e 'email'} %\u003e\n  \u003c%= f.input :password, :as =\u003e 'password', :input_html =\u003e {:name =\u003e 'password'} %\u003e\n  \u003c%= f.input :password_confirmation, :label =\u003e \"Confirm Password\", :as =\u003e 'password', :input_html =\u003e {:name =\u003e 'password_confirmation'} %\u003e\n  \u003cbutton type='submit'\u003eSign Up\u003c/button\u003e\n\u003c% end %\u003e\n```\n\nNext you'll need to let OmniAuth know what action to call when a registration\nfails. In your OmniAuth configuration, specify any valid rack endpoint in the\n`:on_failed_registration` option.\n\n```ruby\nuse OmniAuth::Builder do\n  provider :identity,\n    fields: [:email],\n    on_failed_registration: UsersController.action(:new)\nend\n```\n\nFor more information on rack endpoints, check out [this\nintroduction](http://library.edgecase.com/Rails/2011/01/04/rails-routing-and-rack-endpoints.html)\nand\n[ActionController::Metal](http://rubydoc.info/docs/rails/ActionController/Metal)\n\n### Customizing Locate Conditions\n\nYou can customize the way that matching records are found when authenticating.\nFor example, for a site with multiple domains, you may wish to scope the search\nwithin a particular subdomain.  To do so, add :locate_conditions to your config.\nThe default value is:\n\n```ruby\nuse OmniAuth::Builder do\n  provider :identity,\n    locate_conditions: -\u003e(req) { {model.auth_key =\u003e req.params[\"auth_key\"]} }\n    # ...\nend\n```\n\n`locate_conditions` takes a `Proc` object, and must return a `Hash` object, which will be used\nas the argument to the locate method for your ORM.  The proc is evaluated in the\ncallback context, and has access to your `Identity` model (using `model`) and receives the request\nobject as a parameter.  Note that `model.auth_key` defaults to `email`, but is also configurable.\n\nNote: Be careful when customizing `locate_conditions`.  The best way to modify the conditions is\nto copy the default value, and then add to the hash.  Removing the default condition will almost\nalways break things!\n\n### Customizing Other Things\n\nFrom the code - here are the options we have for you, a couple of which are documented above, and the rest are documented... in the specs we hope!?\n\n```\noption :fields, %i[name email]\n\n      # Primary Feature Switches:\noption :enable_registration, true   # See #other_phase and #request_phase\noption :enable_login, true          # See #other_phase\n\n      # Customization Options:\noption :on_login, nil               # See #request_phase\noption :on_validation, nil          # See #registration_phase\noption :on_registration, nil        # See #registration_phase\noption :on_failed_registration, nil # See #registration_phase\noption :locate_conditions, -\u003e(req) { {model.auth_key =\u003e req.params[\"auth_key\"]} }\n```\n\nPlease contribute some documentation if you have the gumption!  The maintainer's time is limited, and sometimes the authors of PRs with new options don't update the _this_ readme. 😭\n\n## 🦷 FLOSS Funding\n\nWhile omniauth tools are free software and will always be, the project would benefit immensely from some funding.\nRaising a monthly budget of... \"dollars\" would make the project more sustainable.\n\nWe welcome both individual and corporate sponsors! We also offer a\nwide array of funding channels to account for your preferences.\nCurrently, [GitHub Sponsors][🖇sponsor], and [Liberapay][⛳liberapay] are our preferred funding platforms.\n\n**If you're working in a company that's making significant use of omniauth tools we'd\nappreciate it if you suggest to your company to become a omniauth sponsor.**\n\nYou can support the development of omniauth tools via\n[GitHub Sponsors][🖇sponsor],\n[Liberapay][⛳liberapay],\n[PayPal][🖇paypal],\nand [Tidelift][🏙️entsup-tidelift].\n\n| 📍 NOTE                                                                                                                                                                                                              |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| If doing a sponsorship in the form of donation is problematic for your company \u003cbr/\u003e from an accounting standpoint, we'd recommend the use of Tidelift, \u003cbr/\u003e where you can get a support-like subscription instead. |\n\n### Another way to support open-source\n\n\u003e How wonderful it is that nobody need wait a single moment before starting to improve the world.\u003cbr/\u003e\n\u003e—Anne Frank\n\nI’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small.  Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions — totaling 79 hours of FLOSS coding over just the past seven days, a pretty regular week for me.  I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).\n\nIf you work at a company that uses my work, please encourage them to support me as a corporate sponsor. My work on gems you use might show up in `bundle fund`.\n\nI’m developing a new library, [floss_funding][🖇floss-funding-gem], designed to empower open-source developers like myself to get paid for the work we do, in a sustainable way. Please give it a look.\n\n**[Floss-Funding.dev][🖇floss-funding.dev]: 👉️ No network calls. 👉️ No tracking. 👉️ No oversight. 👉️ Minimal crypto hashing. 💡 Easily disabled nags**\n\n[![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate to my FLOSS or refugee efforts at ko-fi.com][🖇kofi-img]][🖇kofi] [![Donate to my FLOSS or refugee efforts using Patreon][🖇patreon-img]][🖇patreon]\n\n## 🔐 Security\n\nSee [SECURITY.md][🔐security].\n\n## 🤝 Contributing\n\nIf you need some ideas of where to help, you could work on adding more code coverage,\nor if it is already 💯 (see [below](#code-coverage)) check [reek](REEK), [issues][🤝gh-issues], or [PRs][🤝gh-pulls],\nor use the gem and think about how it could be better.\n\nWe [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.\n\nSee [CONTRIBUTING.md][🤝contributing] for more detailed instructions.\n\n### 🚀 Release Instructions\n\nSee [CONTRIBUTING.md][🤝contributing].\n\n### Code Coverage\n\n[![Coverage Graph][🏀codecov-g]][🏀codecov]\n\n[![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls]\n\n[![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov]\n\n### 🪇 Code of Conduct\n\nEveryone interacting with this project's codebases, issue trackers,\nchat rooms and mailing lists agrees to follow the [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct].\n\n## 🌈 Contributors\n\n[![Contributors][🖐contributors-img]][🖐contributors]\n\nMade with [contributors-img][🖐contrib-rocks].\n\nAlso see GitLab Contributors: [https://gitlab.com/omniauth/omniauth-identity/-/graphs/main][🚎contributors-gl]\n\n\u003cdetails\u003e\n    \u003csummary\u003e⭐️ Star History\u003c/summary\u003e\n\n\u003ca href=\"https://star-history.com/#omniauth/omniauth-identity\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=omniauth/omniauth-identity\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=omniauth/omniauth-identity\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=omniauth/omniauth-identity\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n\u003c/details\u003e\n\n## 📌 Versioning\n\nThis Library adheres to [![Semantic Versioning 2.0.0][📌semver-img]][📌semver].\nViolations of this scheme should be reported as bugs.\nSpecifically, if a minor or patch version is released that breaks backward compatibility,\na new version should be immediately released that restores compatibility.\nBreaking changes to the public API will only be introduced with new major versions.\n\n\u003e dropping support for a platform is both obviously and objectively a breaking change \u003cbr/\u003e\n\u003e—Jordan Harband ([@ljharb](https://github.com/ljharb), maintainer of SemVer) [in SemVer issue 716][📌semver-breaking]\n\nI understand that policy doesn't work universally (\"exceptions to every rule!\"),\nbut it is the policy here.\nAs such, in many cases it is good to specify a dependency on this library using\nthe [Pessimistic Version Constraint][📌pvc] with two digits of precision.\n\nFor example:\n\n```ruby\nspec.add_dependency(\"omniauth-identity\", \"~\u003e 1.0\")\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e📌 Is \"Platform Support\" part of the public API? More details inside.\u003c/summary\u003e\n\nSemVer should, IMO, but doesn't explicitly, say that dropping support for specific Platforms\nis a *breaking change* to an API.\nIt is obvious to many, but not all, and since the spec is silent, the bike shedding is endless.\n\nTo get a better understanding of how SemVer is intended to work over a project's lifetime,\nread this article from the creator of SemVer:\n\n- [\"Major Version Numbers are Not Sacred\"][📌major-versions-not-sacred]\n\n\u003c/details\u003e\n\nSee [CHANGELOG.md][📌changelog] for a list of releases.\n\n## 📄 License\n\nThe gem is available as open source under the terms of\nthe [MIT License][📄license] [![License: MIT][📄license-img]][📄license-ref].\nSee [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].\n\n### © Copyright\n\n\u003cul\u003e\n    \u003cli\u003e\n        Copyright (c) 2021, 2024-2025 Peter H. Boling, of\n        \u003ca href=\"https://discord.gg/3qme4XHNKN\"\u003e\n            Galtzo.com\n            \u003cpicture\u003e\n              \u003cimg src=\"https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px-blank.svg\" alt=\"Galtzo.com Logo (Wordless) by Aboling0, CC BY-SA 4.0\" width=\"24\"\u003e\n            \u003c/picture\u003e\n        \u003c/a\u003e, and omniauth-identity contributors.\n    \u003c/li\u003e\n    \u003cli\u003e\n        Copyright (c) 2020 Peter H. Boling, Andrew Roberts, and Jellybooks Ltd.\n    \u003c/li\u003e\n    \u003cli\u003e\n        Copyright (c) 2010-2015 Michael Bleigh, and Intridea, Inc.\n    \u003c/li\u003e\n\u003c/ul\u003e\n\n## 🤑 A request for help\n\nMaintainers have teeth and need to pay their dentists.\nAfter getting laid off in an RIF in March and filled with many dozens of rejections,\nI'm now spending ~60+ hours a week building open source tools.\nI'm hoping to be able to pay for my kids' health insurance this month,\nso if you value the work I am doing, I need your support.\nPlease consider sponsoring me or the project.\n\nTo join the community or get help 👇️ Join the Discord.\n\n[![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]\n\nTo say \"thanks!\" ☝️ Join the Discord or 👇️ send money.\n\n[![Sponsor me on GitHub Sponsors][🖇sponsor-bottom-img]][🖇sponsor] 💌 [![Sponsor me on Liberapay][⛳liberapay-bottom-img]][⛳liberapay-img] 💌 [![Donate on PayPal][🖇paypal-bottom-img]][🖇paypal-img]\n\n### Please give the project a star ⭐ ♥.\n\nThanks for RTFM. ☺️\n\n[⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay\u0026color=a51611\u0026style=flat\n[⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge\u0026logo=liberapay\u0026color=a51611\n[⛳liberapay]: https://liberapay.com/pboling/donate\n[🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social\u0026logo=github\n[🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge\u0026logo=github\n[🖇sponsor]: https://github.com/sponsors/pboling\n[🖇polar-img]: https://img.shields.io/badge/polar-donate-a51611.svg?style=flat\n[🖇polar]: https://polar.sh/pboling\n[🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat\n[🖇kofi]: https://ko-fi.com/O5O86SNP4\n[🖇patreon-img]: https://img.shields.io/badge/patreon-donate-a51611.svg?style=flat\n[🖇patreon]: https://patreon.com/galtzo\n[🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat\n[🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte\u0026emoji=\u0026slug=pboling\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Cookie\u0026outline_colour=000000\u0026coffee_colour=ffffff\n[🖇buyme]: https://www.buymeacoffee.com/pboling\n[🖇paypal-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=flat\u0026logo=paypal\n[🖇paypal-bottom-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=for-the-badge\u0026logo=paypal\u0026color=0A0A0A\n[🖇paypal]: https://www.paypal.com/paypalme/peterboling\n[🖇floss-funding.dev]: https://floss-funding.dev\n[🖇floss-funding-gem]: https://github.com/galtzo-floss/floss_funding\n[✉️discord-invite]: https://discord.gg/3qme4XHNKN\n[✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge\u0026logo=discord\n[✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge\u0026logo=dailydotdev\u0026logoColor=white\n[✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends\n\n[✇bundle-group-pattern]: https://gist.github.com/pboling/4564780\n[⛳️gem-namespace]: https://github.com/omniauth/omniauth-identity\n[⛳️namespace-img]: https://img.shields.io/badge/namespace-Omniauth::Identity-3C2D2D.svg?style=square\u0026logo=ruby\u0026logoColor=white\n[⛳️gem-name]: https://bestgems.org/gems/omniauth-identity\n[⛳️name-img]: https://img.shields.io/badge/name-omniauth--identity-3C2D2D.svg?style=square\u0026logo=rubygems\u0026logoColor=red\n[⛳️tag-img]: https://img.shields.io/github/tag/omniauth/omniauth-identity.svg\n[⛳️tag]: http://github.com/omniauth/omniauth-identity/releases\n[🚂maint-blog]: http://www.railsbling.com/tags/omniauth-identity\n[🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge\u0026logo=rubyonrails\u0026logoColor=orange\n[🚂maint-contact]: http://www.railsbling.com/contact\n[🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat\u0026logo=rubyonrails\u0026logoColor=red\n[💖🖇linkedin]: http://www.linkedin.com/in/peterboling\n[💖🖇linkedin-img]: https://img.shields.io/badge/PeterBoling-LinkedIn-0B66C2?style=flat\u0026logo=newjapanprowrestling\n[💖✌️wellfound]: https://wellfound.com/u/peter-boling\n[💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat\u0026logo=wellfound\n[💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling\n[💖💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=flat\u0026logo=crunchbase\n[💖🐘ruby-mast]: https://ruby.social/@galtzo\n[💖🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https://ruby.social\u0026style=flat\u0026logo=mastodon\u0026label=Ruby%20@galtzo\n[💖🦋bluesky]: https://bsky.app/profile/galtzo.com\n[💖🦋bluesky-img]: https://img.shields.io/badge/@galtzo.com-0285FF?style=flat\u0026logo=bluesky\u0026logoColor=white\n[💖🌳linktree]: https://linktr.ee/galtzo\n[💖🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=flat\u0026logo=linktree\n[💖💁🏼‍♂️devto]: https://dev.to/galtzo\n[💖💁🏼‍♂️devto-img]: https://img.shields.io/badge/dev.to-0A0A0A?style=flat\u0026logo=devdotto\u0026logoColor=white\n[💖💁🏼‍♂️aboutme]: https://about.me/peter.boling\n[💖💁🏼‍♂️aboutme-img]: https://img.shields.io/badge/about.me-0A0A0A?style=flat\u0026logo=aboutme\u0026logoColor=white\n[💖🧊berg]: https://codeberg.org/pboling\n[💖🐙hub]: https://github.org/pboling\n[💖🛖hut]: https://sr.ht/~galtzo/\n[💖🧪lab]: https://gitlab.com/pboling\n[👨🏼‍🏫expsup-upwork]: https://www.upwork.com/freelancers/~014942e9b056abdf86?mp_source=share\n[👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge\u0026logo=Upwork\u0026logoColor=white\n[👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github\u0026utm_medium=button\u0026utm_term=peterboling\u0026utm_campaign=github\n[👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge\u0026logo=CodeMentor\u0026logoColor=white\n[🏙️entsup-tidelift]: https://tidelift.com/subscription/pkg/rubygems-omniauth-identity?utm_source=rubygems-omniauth-identity\u0026utm_medium=referral\u0026utm_campaign=readme\n[🏙️entsup-tidelift-img]: https://img.shields.io/badge/Tidelift_and_Sonar-Enterprise_Support-FD3456?style=for-the-badge\u0026logo=sonar\u0026logoColor=white\n[🏙️entsup-tidelift-sonar]: https://blog.tidelift.com/tidelift-joins-sonar\n[💁🏼‍♂️peterboling]: http://www.peterboling.com\n[🚂railsbling]: http://www.railsbling.com\n[📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge\u0026logo=Gitlab\u0026logoColor=orange\n[📜src-gl]: https://gitlab.com/omniauth/omniauth-identity/\n[📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge\u0026logo=CodeBerg\u0026logoColor=blue\n[📜src-cb]: https://codeberg.org/omniauth/omniauth-identity\n[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge\u0026logo=Github\u0026logoColor=green\n[📜src-gh]: https://github.com/omniauth/omniauth-identity\n[📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge\u0026logo=readthedocs\u0026logoColor=white\n[📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge\u0026logo=readthedocs\u0026logoColor=white\n[📜gl-wiki]: https://gitlab.com/omniauth/omniauth-identity/-/wikis/home\n[📜gh-wiki]: https://github.com/omniauth/omniauth-identity/wiki\n[📜gl-wiki-img]: https://img.shields.io/badge/wiki-examples-943CD2.svg?style=for-the-badge\u0026logo=gitlab\u0026logoColor=white\n[📜gh-wiki-img]: https://img.shields.io/badge/wiki-examples-943CD2.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\n[👽dl-rank]: https://bestgems.org/gems/omniauth-identity\n[👽dl-ranki]: https://img.shields.io/gem/rd/omniauth-identity.svg\n[👽oss-help]: https://www.codetriage.com/omniauth/omniauth-identity\n[👽oss-helpi]: https://www.codetriage.com/omniauth/omniauth-identity/badges/users.svg\n[👽version]: https://bestgems.org/gems/omniauth-identity\n[👽versioni]: https://img.shields.io/gem/v/omniauth-identity.svg\n[🏀qlty-mnt]: https://qlty.sh/gh/omniauth/projects/omniauth-identity\n[🏀qlty-mnti]: https://qlty.sh/gh/omniauth/projects/omniauth-identity/maintainability.svg\n[🏀qlty-cov]: https://qlty.sh/gh/omniauth/projects/omniauth-identity/metrics/code?sort=coverageRating\n[🏀qlty-covi]: https://qlty.sh/gh/omniauth/projects/omniauth-identity/coverage.svg\n[🏀codecov]: https://codecov.io/gh/omniauth/omniauth-identity\n[🏀codecovi]: https://codecov.io/gh/omniauth/omniauth-identity/graph/badge.svg\n[🏀coveralls]: https://coveralls.io/github/omniauth/omniauth-identity?branch=main\n[🏀coveralls-img]: https://coveralls.io/repos/github/omniauth/omniauth-identity/badge.svg?branch=main\n[🖐codeQL]: https://github.com/omniauth/omniauth-identity/security/code-scanning\n[🖐codeQL-img]: https://github.com/omniauth/omniauth-identity/actions/workflows/codeql-analysis.yml/badge.svg\n[🚎1-an-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/ancient.yml\n[🚎1-an-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/ancient.yml/badge.svg\n[🚎2-cov-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/coverage.yml\n[🚎2-cov-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/coverage.yml/badge.svg\n[🚎3-hd-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/heads.yml\n[🚎3-hd-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/heads.yml/badge.svg\n[🚎4-lg-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/legacy.yml\n[🚎4-lg-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/legacy.yml/badge.svg\n[🚎5-st-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/style.yml\n[🚎5-st-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/style.yml/badge.svg\n[🚎6-s-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/supported.yml\n[🚎6-s-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/supported.yml/badge.svg\n[🚎7-us-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/unsupported.yml\n[🚎7-us-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/unsupported.yml/badge.svg\n[🚎8-ho-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/hoary.yml\n[🚎8-ho-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/hoary.yml/badge.svg\n[🚎9-t-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/truffle.yml\n[🚎9-t-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/truffle.yml/badge.svg\n[🚎10-j-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/jruby.yml\n[🚎10-j-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/jruby.yml/badge.svg\n[🚎11-c-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/current.yml\n[🚎11-c-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/current.yml/badge.svg\n[🚎12-crh-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/dep-heads.yml\n[🚎12-crh-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/dep-heads.yml/badge.svg\n[🚎13-🔒️-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/locked_deps.yml\n[🚎13-🔒️-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/locked_deps.yml/badge.svg\n[🚎14-🔓️-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/unlocked_deps.yml\n[🚎14-🔓️-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/unlocked_deps.yml/badge.svg\n[🚎15-🪪-wf]: https://github.com/omniauth/omniauth-identity/actions/workflows/license-eye.yml\n[🚎15-🪪-wfi]: https://github.com/omniauth/omniauth-identity/actions/workflows/license-eye.yml/badge.svg\n[💎ruby-2.4i]: https://img.shields.io/badge/Ruby-2.4-DF00CA?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-2.5i]: https://img.shields.io/badge/Ruby-2.5-DF00CA?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-2.6i]: https://img.shields.io/badge/Ruby-2.6-DF00CA?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-2.7i]: https://img.shields.io/badge/Ruby-2.7-DF00CA?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-3.0i]: https://img.shields.io/badge/Ruby-3.0-CC342D?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-3.1i]: https://img.shields.io/badge/Ruby-3.1-CC342D?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-3.2i]: https://img.shields.io/badge/Ruby-3.2-CC342D?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-3.3i]: https://img.shields.io/badge/Ruby-3.3-CC342D?style=for-the-badge\u0026logo=ruby\u0026logoColor=white\n[💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge\u0026logo=ruby\u0026logoColor=green\n[💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge\u0026logo=ruby\u0026logoColor=blue\n[💎truby-22.3i]: https://img.shields.io/badge/Truffle_Ruby-22.3_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge\u0026logo=ruby\u0026logoColor=pink\n[💎truby-23.0i]: https://img.shields.io/badge/Truffle_Ruby-23.0_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge\u0026logo=ruby\u0026logoColor=pink\n[💎truby-23.1i]: https://img.shields.io/badge/Truffle_Ruby-23.1-34BCB1?style=for-the-badge\u0026logo=ruby\u0026logoColor=pink\n[💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge\u0026logo=ruby\u0026logoColor=green\n[💎truby-headi]: https://img.shields.io/badge/Truffle_Ruby-HEAD-34BCB1?style=for-the-badge\u0026logo=ruby\u0026logoColor=blue\n[💎jruby-9.1i]: https://img.shields.io/badge/JRuby-9.1_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge\u0026logo=ruby\u0026logoColor=red\n[💎jruby-9.2i]: https://img.shields.io/badge/JRuby-9.2_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge\u0026logo=ruby\u0026logoColor=red\n[💎jruby-9.3i]: https://img.shields.io/badge/JRuby-9.3_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge\u0026logo=ruby\u0026logoColor=red\n[💎jruby-9.4i]: https://img.shields.io/badge/JRuby-9.4-FBE742?style=for-the-badge\u0026logo=ruby\u0026logoColor=red\n[💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge\u0026logo=ruby\u0026logoColor=green\n[💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge\u0026logo=ruby\u0026logoColor=blue\n[🤝gh-issues]: https://github.com/omniauth/omniauth-identity/issues\n[🤝gh-pulls]: https://github.com/omniauth/omniauth-identity/pulls\n[🤝gl-issues]: https://gitlab.com/omniauth/omniauth-identity/-/issues\n[🤝gl-pulls]: https://gitlab.com/omniauth/omniauth-identity/-/merge_requests\n[🤝cb-issues]: https://codeberg.org/omniauth/omniauth-identity/issues\n[🤝cb-pulls]: https://codeberg.org/omniauth/omniauth-identity/pulls\n[🤝cb-donate]: https://donate.codeberg.org/\n[🤝contributing]: CONTRIBUTING.md\n[🏀codecov-g]: https://codecov.io/gh/omniauth/omniauth-identity/graphs/tree.svg\n[🖐contrib-rocks]: https://contrib.rocks\n[🖐contributors]: https://github.com/omniauth/omniauth-identity/graphs/contributors\n[🖐contributors-img]: https://contrib.rocks/image?repo=omniauth/omniauth-identity\n[🚎contributors-gl]: https://gitlab.com/omniauth/omniauth-identity/-/graphs/main\n[🪇conduct]: CODE_OF_CONDUCT.md\n[🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg\n[📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint\n[📌semver]: https://semver.org/spec/v2.0.0.html\n[📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat\n[📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139\n[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html\n[📌changelog]: CHANGELOG.md\n[📗keep-changelog]: https://keepachangelog.com/en/1.0.0/\n[📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat\n[📌gitmoji]:https://gitmoji.dev\n[📌gitmoji-img]:https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square\n[🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ\n[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.467-FFDD67.svg?style=for-the-badge\u0026logo=YouTube\u0026logoColor=blue\n[🔐security]: SECURITY.md\n[🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat\n[📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year\n[📄license]: LICENSE.txt\n[📄license-ref]: https://opensource.org/licenses/MIT\n[📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg\n[📄license-compat]: https://dev.to/galtzo/how-to-check-license-compatibility-41h0\n[📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat\u0026logo=Apache\n[📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm\n[📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat\n[🚎yard-current]: http://rubydoc.info/gems/omniauth-identity\n[🚎yard-head]: https://omniauth-identity.galtzo.com\n[💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums\n[💎SHA_checksums]: https://gitlab.com/omniauth/omniauth-identity/-/tree/main/checksums\n[💎rlts]: https://github.com/rubocop-lts/rubocop-lts\n[💎rlts-img]: https://img.shields.io/badge/code_style_\u0026_linting-rubocop--lts-34495e.svg?plastic\u0026logo=ruby\u0026logoColor=white\n[💎appraisal2]: https://github.com/appraisal-rb/appraisal2\n[💎appraisal2-img]: https://img.shields.io/badge/appraised_by-appraisal2-34495e.svg?plastic\u0026logo=ruby\u0026logoColor=white\n[💎d-in-dvcs]: https://railsbling.com/posts/dvcs/put_the_d_in_dvcs/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomniauth%2Fomniauth-identity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomniauth%2Fomniauth-identity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomniauth%2Fomniauth-identity/lists"}