Skip to content
This repository has been archived by the owner on Sep 25, 2024. It is now read-only.

Commit

Permalink
✨ Badges FTW!
Browse files Browse the repository at this point in the history
  • Loading branch information
pboling committed Sep 5, 2024
1 parent 35c378c commit 869d6a3
Showing 1 changed file with 60 additions and 23 deletions.
83 changes: 60 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,25 @@
OpenIdAuthentication [![Build Status](https://travis-ci.org/grosser/open_id_authentication.png)](https://travis-ci.org/grosser/open_id_authentication)
====================
# OpenIdAuthentication

<div id="badges">

[![CI Supported Build][🚎s-wfi]][🚎s-wf]
[![CI Unsupported Build][🚎us-wfi]][🚎us-wf]
[![CI Style Build][🚎st-wfi]][🚎st-wf]
[![CI Coverage Build][🚎cov-wfi]][🚎cov-wf]
[![CI Heads Build][🚎hd-wfi]][🚎hd-wf]

[🚎s-wf]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/supported.yml
[🚎s-wfi]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/supported.yml/badge.svg
[🚎us-wf]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/unsupported.yml
[🚎us-wfi]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/unsupported.yml/badge.svg
[🚎st-wf]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/style.yml
[🚎st-wfi]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/style.yml/badge.svg
[🚎cov-wf]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/coverage.yml
[🚎cov-wfi]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/coverage.yml/badge.svg
[🚎hd-wf]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/heads.yml
[🚎hd-wfi]: https://github.com/VitalConnectInc/open_id_authentication2/actions/workflows/heads.yml/badge.svg

</div>

Provides a thin wrapper around the excellent ruby-openid gem from JanRan.

Expand All @@ -8,9 +28,7 @@ from that gem.

The specification used is http://openid.net/specs/openid-authentication-2_0.html.


Prerequisites
-------------
## Prerequisites

OpenID authentication uses the session, so be sure that you haven't turned that off.

Expand All @@ -27,9 +45,7 @@ The plugin also expects to find a root_url method that points to the home page o

This plugin relies on Rails Edge revision 6317 or newer.


Example
-------
## Example

This example is just to meant to demonstrate how you could use OpenID authentication. You might well want to add
salted hash logins instead of plain text passwords and other requirements on top of this. Treat it as a starting point,
Expand Down Expand Up @@ -139,8 +155,6 @@ app/controllers/sessions_controller.rb
end
end



If you're fine with the result messages above and don't need individual logic on a per-failure basis,
you can collapse the case into a mere boolean:

Expand All @@ -155,8 +169,7 @@ you can collapse the case into a mere boolean:
end


Simple Registration OpenID Extension
------------------------------------
## Simple Registration OpenID Extension

Some OpenID Providers support this lightweight profile exchange protocol. See more: http://www.openidenabled.com/openid/simple-registration-extension

Expand Down Expand Up @@ -209,8 +222,7 @@ You can support it in your app by changing #open_id_authentication
{ :login => 'nickname', :email => 'email', :display_name => 'fullname' }
end

Attribute Exchange OpenID Extension
-----------------------------------
## Attribute Exchange OpenID Extension

Some OpenID providers also support the OpenID AX (attribute exchange) protocol for exchanging identity information between endpoints. See more: http://openid.net/specs/openid-attribute-exchange-1_0.html

Expand All @@ -222,17 +234,42 @@ Accessing AX data is very similar to the Simple Registration process, described

This would provide the sreg data for :email via registration, and the AX data for http://schema.openid.net/birthDate via ax.

TODO
----
- tests
## TODO

- More tests

## Credits

## 🌈 Contributors

Current maintainer(s):

- [Peter Boling](https://github.com/pboling)

Special thanks to:
- David Heinemeier Hansson - author of original `open_id_authentication`
- [Joshua Peek](https://github.com/josh) maintainer of original `open_id_authentication2`

And all the other contributors!

[![Contributors][🖐contributors-img]][🖐contributors]

Made with [contributors-img][🖐contrib-rocks].

[🖐contrib-rocks]: https://contrib.rocks
[🖐contributors]: https://github.com/VitalConnectInc/open_id_authentication2/graphs/contributors
[🖐contributors-img]: https://contrib.rocks/image?repo=VitalConnectInc/open_id_authentication2

## 📄 License

Credits
-------
The gem is available as open source under the terms of
the [MIT License][📄license] [![License: MIT][📄license-img]][📄license-ref].

open_id_authentication was written by David Heinemeier Hansson with a number of other [contributors](https://github.com/Velir/open_id_authentication/contributors).
See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].

[comment]: <> ( 📄 LEGAL LINKS )

License
-------
Copyright (c) 2007-2011 David Heinemeier Hansson, released under the MIT license
[📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
[📄license]: LICENSE.txt
[📄license-ref]: https://opensource.org/licenses/MIT
[📄license-img]: https://img.shields.io/badge/License-MIT-green.svg

0 comments on commit 869d6a3

Please sign in to comment.