CHANGELOG.md

Change Log

1.35.0 (2021-10-20)

Full Changelog

Added

• Added get job error details method to JobEntity #383 (jasonfagerberg-toast)
• Add MFA Authentication policies to GuardianEntity #379 (pelletier197)

Fixed

• Fix de/serialization of Invitation roles #380 (lbalmaceda)

1.34.1 (2021-09-21)

Full Changelog

Fixed

• Add user_name field to LogEvent #375 (jimmyjames)

1.34.0 (2021-08-27)

Full Changelog

Added

• Include log_id in the LogEvent entity #372 (jimmyjames)
• [SDK-2716] Add support for Actions Management APIs #369 (jimmyjames)
• [SDK-2686] Add retry on rate limit errors for management API #368 (jimmyjames)

Fixed

• Fix to rollback action version endpoint #370 (jimmyjames)

1.33.0 (2021-07-26)

Full Changelog

Added

• [SDK-2664] Add support for checkpoint pagination #362 (jimmyjames)

Deprecated

• Deprecate unused constructors in Page implementations #363 (jimmyjames)

1.32.0 (2021-07-05)

Full Changelog

Added

• [SDK-2622] Add expiresAt to token response #357 (jimmyjames)

Changed

• Update OSS release plugin version #358 (lbalmaceda)

1.31.0 (2021-05-10)

Full Changelog

Added

• [SDK-2550] Add networking client timeout configuration #354 (jimmyjames)

1.30.0 (2021-04-28)

Full Changelog

Added

• [SDK-2537] Add missing parameters to Ticket entities #352 (jimmyjames)

1.29.0 (2021-04-09)

Full Changelog

Added

• Adds method to get an organization's enabled connection and update JavaDocs #344 (jimmyjames)
• Add Organizations Management API Support [SDK-2437] #341 (jimmyjames)

1.28.1 (2021-04-05)

Full Changelog

Fixed

• Fix NoSuchMethodError when projects have OkHttp 3 dependency #342 (jimmyjames)

1.28.0 (2021-03-25)

Full Changelog

Added

• Add support for organizations feature #338 (jimmyjames)

Changed

• Update Gradle OSS Plugin #339 (jimmyjames)

1.27.0 (2021-02-05)

Full Changelog

Added

• Add support for async requests #328 (jimmyjames)

Changed

• Update dependency versions #329 (jimmyjames)

1.26.0 (2020-12-02)

Full Changelog

Added

• Add refresh token configuration object to client #321 (JakeUskoski)

Fixed

• Fix OkHttp dependency version #325 (jimmyjames)
• Tidy up code #317 (jsalinaspolo)

1.25.0 (2020-11-16)

Full Changelog

Changed

• Update to OkHttp 4 #319 (jimmyjames)
• Use java8 #316 (jsalinaspolo)

1.24.0 (2020-11-02)

Full Changelog

Added

• Add methods to determine cause of APIException #310 (jimmyjames)

Breaking Changes

• Return TokenRequest instead of AuthRequest #309 (jimmyjames)

Note: We aim to not introduce breaking changes within a release stream. We have taken steps, including running API compatibility checks, to prevent introducing breaking changes in the future.

Fixed

• Add unchecked warnings failures for src #311 (jimmyjames)

1.23.0 (2020-10-22)

Full Changelog

Added

• Add support for MFA OTP exchange #303 (jimmyjames)
• Passwordless support #300 (jimmyjames)
• Add scope to TokenHolder #297 (jimmyjames)
• Add inicludeEmailInRedirect field for create email verification ticket endpoint #296 (jimmyjames)

Changed

• Update dependencies #299 (jimmyjames)

1.22.1 (2020-10-13)

Full Changelog

Fixed

• Use Standard Jackson Date serialization #295 (jimmyjames)

1.22.0 (2020-09-28)

Full Changelog

Added

• Add support for identity field for email verification jobs and tickets #293 (jimmyjames)

1.21.0 (2020-08-27)

Full Changelog

Added

• Add support for Log Streams #284 (jimmyjames)

1.20.0 (2020-07-27)

Full Changelog

Added

• Add missing Linking User Accounts endpoint #270 (cschwalm)

Fixed

• Fix and document thread-safety #272 (lbalmaceda)

1.19.0 (2020-06-05)

Full Changelog

Added

• Add display_name property to Connection #267 (lbalmaceda)
• Add support for java Proxy with basic auth #266 (lbalmaceda)

1.18.0 (2020-05-29)

Full Changelog

Added

• Add ID Token verifier API #260 (jimmyjames)
• Add signature verification classes #258 (jimmyjames)

Changed

• Update to OkHttp 3.14.9 #262 (jimmyjames)

1.17.0 (2020-05-22)

Full Changelog

Added

• Add missing property last_password_reset #256 (mario-moura-silva)
• Add missing "sources" property to the Permission #254 (lbalmaceda)

1.16.0 (2020-04-24)

Full Changelog

Added

• Add Job "POST User Imports" endpoint #249 (lbalmaceda)
• Add a new class to handle Multipart requests #248 (lbalmaceda)
• Add Job "GET Status" endpoint #247 (lbalmaceda)
• Add missing "initiate_login_uri" property to Client #244 (lbalmaceda)
• Use char array for passwords #242 (jimmyjames)
• Add Job "POST User Exports" endpoint #241 (lbalmaceda)
• Add Rules Configs entity #240 (lbalmaceda)

Deprecated

• deprecated string password APIs #243 (jimmyjames)

Fixed

• Make CreatedUser take the id from different properties #245 (lbalmaceda)

Security

• Use char array for passwords #242 (jimmyjames)

1.15.0 (2019-11-12)

Full Changelog

Changed

• Allow to set the client is_first_party property #230 (lbalmaceda)

1.14.3 (2019-09-25)

Full Changelog

Security

• Update jackson-databind to address CVE #225 (jimmyjames)

1.14.2 (2019-08-15)

Full Changelog

Fixed

• Find the right JDK version for Telemetry #220 (lbalmaceda)

Security

• Update dependencies #222 (jimmyjames)

1.14.1 (2019-07-03)

Full Changelog

Security

• Update jackson-databind dependency to fix security vulnerability #217 (jimmyjames)

1.14.0 (2019-07-02)

Full Changelog

Added

• Add getter for DeviceCredentials client_id #215 (lbalmaceda)
• Add missing ResourceServer properties #214 (lbalmaceda)

1.13.3 (2019-05-22)

Full Changelog

Fixed

• Add missing metadata field to Connection object #206 (AlisonT1230)

Security

• Bump dependencies and solve security issues #209 (lbalmaceda)

1.13.2 (2019-05-01)

Full Changelog

Fixed

• Dynamically obtain the project version for telemetry #201 (lbalmaceda)

1.13.1 (2019-04-25)

Full Changelog

Fixed

• Fix for issue #198: Core Authorization fails when adding Roles to User #199 (jakbutler)

1.13.0 (2019-04-23)

Full Changelog

Added

• Add support for Core Authorization's User Roles and Permissions #193 (jakbutler)

1.12.0 (2019-04-17)

Full Changelog

Added

• Update Telemetry format and allow to customize it #195 (lbalmaceda)

Changed

• Remove default version for search_engine #194 (lbalmaceda)

1.11.0 (2019-03-14)

Full Changelog

Added

• Add "mark_email_as_verified" property to PasswordChangeTicket #189 (akvamalin)

1.10.0 (2019-01-03)

Full Changelog

Added

• Add Serializable to the user data. #178 (dfredell)
• Include grant_types in Client #166 (osule)

Fixed

• Closing response body on RateLimitException #175 (j-m-x)

Security

• Bump jackson-databind to patch security issues. #181 (gkwang)

1.9.1 (2018-10-23)

Full Changelog

Security

• Use jackson-databind 2.9.7 #168 (lbalmaceda)

1.9.0 (2018-09-25)

Full Changelog

Added

• Allow to retrieve Rate Limit headers #153 (rvillablanca)
• Add web_origins attribute to the Client class #148 (lbalmaceda)
• Application (aka Client) description field support #147 (rrybalkin)

1.8.0 (2018-07-13)

Full Changelog

Added

• Allow to update the Management API token #141 (lbalmaceda)
• Allow to set search_engine version for Users API #140 (lbalmaceda)
• Make Connections accept include_totals parameter #135 (lbalmaceda)
• Add pagination support to Client Grants, Grants, Resource Servers and Rules #132 (lbalmaceda)

Deprecated

• Deprecate old list methods that do not support pagination #136 (lbalmaceda)

1.7.0 (2018-06-11)

Full Changelog

Added

• Support pagination on the Clients entity #124 (lbalmaceda)
• Add Resend verification email functionality #120 (minhlongdo)

Deprecated

• Deprecate ClientsEntity#list() method #128 (lbalmaceda)

Security

• Security fix and dependencies update #129 (lbalmaceda)

1.6.0 (2018-06-04)

Full Changelog

Added

• Expose additional error response properties in the Exception #123 (lbalmaceda)
• Add email-templates endpoints #117 (lbalmaceda)

1.5.1 (2018-03-01)

Full Changelog

Fixed

• Support password policy error response #108 (lbalmaceda)
• Close ResponseBody buffer after read #101 (lbalmaceda)

1.5.0 (2017-12-07)

Full Changelog

Added

• Resource server #77 (mfarsikov)

1.4.0 (2017-11-30)

Full Changelog

Added

• Add user_id setter #93 (lbalmaceda)
• Add /v1/users-by-email endpoint #87 (lbalmaceda)

Breaking changes

• Include a proper SignUp response #92 (lbalmaceda)

1.3.1 (2017-11-01)

Full Changelog Closed issues

• NullPointerException, StdDeserializer #78

Fixed

• Upgrade Jackson-databind dependency #82 (LuisSaybe)

1.3.0 (2017-09-08)

Full Changelog

Added

• implemented /api/v1/grants endpoint of authok management api #74 (neshanjo)

Changed

• removed unmotivated throwing of UnsupportedEncodingException #75 (neshanjo)

1.2.0 (2017-08-07)

Full Changelog Closed issues

• Get AD connection's provisioning_ticket_url property #66

Added

• Add support for provisioning_ticket_url property to Connection POJO #67 (unnamed38)
• Add public User constructor without parameters #59 (lbalmaceda)

Removed

• Remove invalid Logout URL parameter #65 (lbalmaceda)

1.1.0 (2017-05-23)

Full Changelog

Added

• Add getter for User and ProfileData extra properties #56 (lbalmaceda)
• Add renew authentication endpoint #51 (lbalmaceda)
• Add revoke token endpoint #50 (lbalmaceda)
• Add getter for Identity extra properties #45 (lbalmaceda)
• Add response_type and custom parameter setter for AuthorizeUrlBuilder #40 (lbalmaceda)

Changed

• Improve Guardian section #39 (nikolaseu)
• Simplify/reduce amount of code #36 (nikolaseu)

Fixed

• Fix "q" query parameter encoding #55 (lbalmaceda)
• Close the ResponseBody after its parsed #38 (lbalmaceda)

1.0.0 (2017-01-30)

Reworked Authok SDK for java by providing better support for non-Android application (for Android please use Authok.Android).

The changes from v0 includes:

• OAuth 2.0 endpoints in Authentication API
• Sync calls by default
• Added Management API endpoints
• Better error handling for Auth and Management API erros

Auth API

The implementation is based on the Authentication API Docs.

Create a new AuthAPI instance by providing the client data from the dashboard.

AuthAPI auth = new AuthAPI("{YOUR_DOMAIN}", "{YOUR_CLIENT_ID}", "{YOUR_CLIENT_SECRET}");

Management API

The implementation is based on the Management API Docs.

Create a new ManagementAPI instance by providing the domain from the client dashboard and the API Token. Click here for more information on how to obtain a valid API Token.

ManagementAPI mgmt = new ManagementAPI("{YOUR_DOMAIN}", "{YOUR_API_TOKEN}");

The Management API is divided into different entities. Each of them have the list, create, update, delete and update methods plus a few more if corresponds. The calls are authenticated using the API Token given in the ManagementAPI instance creation and must contain the scope required by each entity. See the javadoc for details on which scope is expected for each call.

• Client Grants: See Docs. Access the methods by calling mgmt.clientGrants().
• Clients: See Docs. Access the methods by calling mgmt.clients().
• Connections: See Docs. Access the methods by calling mgmt.connections().
• Device Credentials: See Docs. Access the methods by calling mgmt.deviceCredentials().
• Logs: See Docs. Access the methods by calling mgmt.logEvents().
• Rules: See Docs. Access the methods by calling mgmt.rules().
• User Blocks: See Docs. Access the methods by calling mgmt.userBlocks().
• Users: See Docs. Access the methods by calling mgmt.users().
• Blacklists: See Docs. Access the methods by calling mgmt.blacklists().
• Emails: See Docs. Access the methods by calling mgmt.emailProvider().
• Guardian: See Docs. Access the methods by calling mgmt.guardian().
• Stats: See Docs. Access the methods by calling mgmt.stats().
• Tenants: See Docs. Access the methods by calling mgmt.tenants().
• Tickets: See Docs. Access the methods by calling mgmt.tickets().