Here you can see the full list of changes between each Authlib release.

Version 0.11: Kaori

Released on Apr 6, 2019.

BIG NEWS: Authlib has changed its open source license from AGPL to BSD.

Important Changes: Authlib specs module has been split into jose, oauth1, oauth2, and oidc. Find how to solve the deprecate issues via

RFC implementations and updates in this release:

  • RFC7518: Added A128GCMKW, A192GCMKW, A256GCMKW algorithms for JWE.
  • RFC5849: Removed draft-eaton-oauth-bodyhash-00 spec for OAuth 1.0.

Small changes and bug fixes in this release:

  • Fixed missing scope on password and client_credentials grant types of OAuth2Session via issue#96.
  • Fixed Flask OAuth client cache detection via issue#98.
  • Enabled ssl certificates for OAuth2Session via PR#100, thanks to pingz.
  • Fixed error response for invalid/expired refresh token via issue#112.
  • Fixed error handle for invalid redirect uri via issue#113.
  • Fixed error response redirect to fragment via issue#114.
  • Fixed non-compliant responses from RFC7009 via issue#119.

Experiment Features: There is an experiment aiohttp client for OAuth1 and OAuth2 in authlib.client.aiohttp.

Version 0.10: Kluke

Released on Oct 12, 2018.

The most important change in this version is grant extension system. When registering a grant, developers can pass extensions to the grant:

authorization_server.register_grant(GrantClass, [extension])

Find Flask Grant Extensions implementation.

RFC implementations and updates in this release:

Besides that, there are other improvements:

  • Export save_authorize_state method on Flask and Django client
  • Add fetch_token to Django OAuth client
  • Add scope operator for @require_oauth Multiple Scopes
  • Fix two OAuth clients in the same Flask route PR#85

Deprecate Changes: find how to solve the deprecate issues via

Version 0.9: Ponyo

Released on Aug 12, 2018. Fun Dive.

There is no big break changes in this version. The very great improvement is adding JWE support. But the JWA parts of JWE are not finished yet, use with caution.

RFC implementations in this release:

Other Changes:

  • Fixed the lazy initialization of Flask OAuth 2.0 provider.
  • Deprecated authlib.client.apps from v0.7 has been dropped.

Version 0.8: Arutoria

Released on Jun 17, 2018. Try Django.

Authlib has tried to introduce Django OAuth server implementation in this version. It turns out that it is not that easy. In this version, only Django OAuth 1.0 server is provided.

As always, there are also RFC features added in this release, here is what’s in version 0.8:

Improvement in this release:

  • A new redesigned error system. All errors are subclasses of a AuthlibBaseError.
  • I18N support for error descriptions.
  • Separate AuthorizationCodeMixin in authlib.flask.oauth2.sqla via issue#57.
  • Add context information when generate token via issue#58.
  • Improve JWT key handles, auto load JWK and JWK set.
  • Add require_oauth.acquire with statement, get example on Flask OAuth 2.0 Server.

Deprecate Changes: find how to solve the deprecate issues via

  • Rename Flask OAuth 2.0 create_expires_generator to create_token_expires_in_generator

Version 0.7: Honami

Released on Apr 28, 2018. Better Beta.

Authlib has changed its license from LGPL to AGPL. This is not a huge release like v0.6, but it still contains some deprecate changes, the good news is they are compatible, they won’t break your project. Authlib can’t go further without these deprecate changes.

As always, Authlib is adding specification implementations. Here is what’s in version 0.7:

Besides that, there are more changes:

  • Add overwrite parameter for framework integrations clients.
  • Add response_mode=query for OpenID Connect implicit and hybrid flow.
  • Bug fix and documentation fix via issue#42, issue#43.
  • Dropping authlib.client.apps. Use Loginpass instead.

Deprecate Changes: find how to solve the deprecate issues via

Version 0.6: Matoi

Released on Mar 20, 2018. Going Beta!

From alpha to beta. This is a huge release with lots of deprecating changes and some breaking changes. And finally, OpenID Connect server is supported by now, because Authlib has added these specifications:

The specifications are not completed yet, but they are ready to use. The missing RFC7516 (JWE) is going to be implemented in next version. Open ID Connect 1.0 is added with:

Besides that, there are more changes:

  • Implementation of RFC7662: OAuth 2.0 Token Introspection via PR#36.
  • Use the token_endpoint_auth_method concept defined in RFC7591.
  • Signal feature for Flask integration of OAuth 2.0 server.
  • Bug fixes for OAuth client parts, thanks for the instruction by Lukas Schink.

Breaking Changes:

  1. the columns in authlib.flask.oauth2.sqla has been changed a lot. If you are using it, you need to upgrade your database.
  2. use register_token_validator on ResourceProtector.
  3. authlib.client.oauth1.OAuth1 has been renamed to authlib.client.oauth1.OAuth1Auth.

Deprecate Changes: find how to solve the deprecate issues via

Version 0.5.1

Released on Feb 11, 2018.

Just a quick bug fix release.

  • Fixed OAuth2Session.request with auth.

Version 0.5: Kirie

Released on Feb 11, 2018. Breaking Changes!

This version breaks a lot of things. There are many redesigns in order to get a better stable API. It is still in Alpha stage, with these breaking changes, I hope Authlib will go into Beta in the next version.

  • Added register_error_uri() and its Flask integration.
  • OAuth2Session supports more grant types.
  • Deprecate built-in cache. Read more on issue#23.
  • Redesigned OAuth 1 Flask server. Read the docs Flask OAuth 1.0 Server.
  • Deprecate client_model. Read more on issue#27.
  • Breaking change on AuthorizationCodeGrant.create_authorization_code, last parameter is changed to an OAuth2Request instance.
  • Rename callback_uri to redirect_uri in client.

Version 0.4.1

Released on Feb 2, 2018. A Quick Bugfix

  • Fixed missing code params when fetching access token. This bug is introduced when fixing issue#16.

Version 0.4: Tsukino

Released on Jan 31, 2018. Enjoy the Super Blue Blood Moon!

This is a feature releasing for OAuth 1 server. Things are not settled yet, there will still be breaking changes in the future. Some of the breaking changes are compatible with deprecated messages, a few are not. I’ll keep the deprecated message for 2 versions. Here is the main features:

  • RFC5847, OAuth 1 client and server
  • Flask implementation of OAuth 1 authorization server and resource protector.
  • Mixin of SQLAlchemy models for easy integration with OAuth 1.

In version 0.4, there is also several bug fixes. Thanks for the early contributors.

  • Allow Flask OAuth register fetch_token and update_token.
  • Bug fix for OAuthClient when refresh_token_params is None via PR#14.
  • Don’t pass everything in request args for Flask OAuth client via issue#16.
  • Bug fix for IDToken.validate_exp via issue#17.

Deprecated Changes

There are parameters naming changes in the client part:

  • client_key has been changed to client_id
  • resource_owner_key has been changed to token
  • resource_owner_secret has been changed to token_secret

Currently, they are backward compatible. You will be notified by warnings.

Old Versions

  • Version 0.3: Released on Dec 24, 2017
  • Version 0.2.1: Released on Dec 6, 2017
  • Version 0.2: Released on Nov 25, 2017
  • Version 0.1: Released on Nov 18, 2017