Skip to content

v5.0.0

Compare
Choose a tag to compare
@davidpatrick davidpatrick released this 23 Oct 05:47
· 293 commits to master since this release
dfcf405

v5.0.0 (2020-10-22)

This release addresses some long standing issues with the library that could only be addressed in a major. We have also removed APIv1 endpoints and other deprecated methods.

Migration from v4 to v5

Top Level Structs

The following top level structs were colliding with other libraries, this was addressed in #183 and have been namespaced with ::Auth0::

  • ApiToken changed to ::Auth0::ApiToken
  • Permission changed to ::Auth0::Permission
  • AccessToken changed to ::AccessToken::AccessToken

Api2 Users create_user method

This method was requiring you send in a name, which was optional, but didn't require connection_name which isn't optional. This was fixed in #244.

Auth0::Api::V2::Users.create_user(name, options = {}) has changed to Auth0::Api::V2::Users.create_user(connection_name, options = {})

APIv1 End of Life

APIv1 endpoints were deprecated in 4.x and now have been removed in v5. They reached end-of-life in the Public Cloud on 13 July 2020. Migration from v1 to v2 has been documented here https://auth0.com/docs/product-lifecycle/deprecations-and-migrations/migrate-to-management-api-v2

Catching 429 Errors

In 4.x RateLimitEncountered was inheriting from Auth0::Unsupported in order for backwards compatibility. This class is now inheriting Auth0::HTTPError. If you are catching 429 errors with Auth0::Unsupported then you will need to migrate to catching with Auth0::HTTPError.

Changes

Full Changelog

Fixed

  • Don't define structs as top-level constants (breaking changes) #183 (makimoto)
  • Fix create_user implementation (breaking changes) #244 (davidpatrick)

Removed