Boruta is the core of an OAuth 2.0 and OpenID Connect provider implementing according business rules. This library also provides a generator to create phoenix controllers, views and templates to have a basic provider up and running.
As it, a provider implemented using Boruta aim to follow RFCs:
- RFC 6749 - The OAuth 2.0 Authorization Framework
- RFC 7662 - OAuth 2.0 Token Introspection
- RFC 7009 - OAuth 2.0 Token Revocation
- RFC 7636 - Proof Key for Code Exchange by OAuth Public Clients
- RFC 7521 - Assertion Framework for OAuth 2.0 Client Authentication and Authorization Grants
- RFC 7523 - JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants
- RFC 9449 - OAuth 2.0 Demonstrating Proof-of-Possession at the Application Layer (DPoP)
- RFC 9126 - OAuth 2.0 Pushed Authorization Requests
And specification from OpenID Foundation:
- OpenID Connect core 1.0
- OpenID Connect Dynamic Client Registration 1.0 incorporating errata set 1
- OpenID for Verifiable Credential Issuance - draft 11/13
- Self-Issued OpenID Provider v2 - draft 13
- OpenID for Verifiable Presentations - draft 21
This package is meant to help to bring authorization into Elixir applications. With it, you can perform part or all of authorization code, implicit, hybrid, client credentials, or resource owner password credentials grants flows. It also helps introspecting and revoking tokens.
Master branch documentation can be found here
Stable documentation is hosted on hexdocs.pm
An example of integration can be found here, it followed the integration steps described in below guides section.
This package has successfully passed basic, implicit and hybrid OpenID Profiles certifications as of May 7th, 2022 for its version 2.1.2. This certification was performed with the above sample server.
Here are some guides helping the integration of OAuth/OpenID Connect in your systems:
- Basic OAuth/OpenID Connect provider integration
- How to create an OAuth client
- Client request authorization
- Notes about confidential clients
- Notes about pkce
It is a work in progress, all feedbacks / feature requests / improvements are welcome
This product community follows the code of conduct available here
This code is released under the MIT license.
