Release Notes

Looking for release notes older than 1.23.0? Look in the release notes archive. Looking to be notified of new releases?

Version 1.48.2

November 21st, 2023

Fixed

Security

Internal

Version 1.48.1

October 29th, 2023

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

Version 1.48.0 - Webhook Walrus

October 27th, 2023

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Changed

Security

Fixed

Enhancements

Internal

Version 1.47.1

July 27th, 2023

Fixed

Version 1.47.0 - Performance Panther

July 25th, 2023

Please be sure to read the notes in the Changed section before upgrading.

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Security

Changed

  1. Find the alternativeLogins macro usage in oauth2Authorize and oauth2Register and add federatedCSRFToken=federatedCSRFToken as the last argument to this macro.
[#-- Updated macro usage. Line breaks added for readability. --]
[@helpers.alternativeLogins clientId=client_id
                            identityProviders=identityProviders
                            passwordlessEnabled=passwordlessEnabled
                            bootstrapWebauthnEnabled=bootstrapWebauthnEnabled
                            idpRedirectState=idpRedirectState
                            federatedCSRFToken=federatedCSRFToken/]
  1. Find the macro named alternativeLogins in helpers and add federatedCSRFToken="" as the last argument to this macro.
[#-- Updated macro in helpers. Line breaks added for readability. --]
[#macro alternativeLogins clientId
                          identityProviders
                          passwordlessEnabled
                          bootstrapWebauthnEnabled=false
                          idpRedirectState=""
                          federatedCSRFToken=""]
  1. Find the element <div class="login-button-container"> in the macro named alternativeLogins in helpers and add id="login-button-container" and data-federated-csrf="${federatedCSRFToken}" attributes.
[#-- Updated div in alternativeLogins macro. Line breaks added for readability. --]
<div id="login-button-container"
     class="login-button-container"
     data-federated-csrf="${federatedCSRFToken}">

Fixed

Enhancements

New

Internal

Version 1.46.0

June 19th, 2023

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Security

Fixed

Enhancements

New

Internal

Version 1.45.4

July 25th, 2023

Fixed

Version 1.45.3

May 31st, 2023

Fixed

This fixes a very low level HTTP server bug. In some rare cases, the HTTP response handler may not identity the end of the stream and effectively truncate the response body. It is difficult to say how how may affect your integration if you were to encounter it. If you were to make an API call with a large response body, it may be possible the response would not include a valid JSON object if the response is truncated. When this error occurs, the HTTP status code will be valid, but the response will be truncated or non-existent. + For additional detail see the linked commit in the linked GitHub issue.

Version 1.45.2

May 8th, 2023

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

It is recommended to upgrade to this version at a minimum if you are coming from a version prior to version 1.45.0. +

Version 1.45.1

April 14th, 2023

Changed

Fixed

Version 1.45.0

April 10th, 2023

Known Issues

If you wish to upgrade before a fix is available, please document your access token signing key configuration for each entity type that has provided a specific signing configuration. Then, once the upgrade has completed, review each entity type and confirm the correct signing key configuration. If the configuration is not correct, set the signing key to the previously documented signing key. + To verify if this issue may affect you during upgrade, confirm your signing configuration for each configured entity type.

Security

Fixed

Enhancements

Also allow the self-service account session to be bootstrapped from a mobile application using token authentication, also known as the Bearer authentication scheme. This mechanism provides access to the self-service themed pages even if you are unable to share cookies with the web view used to complete login. + Example request header: Authorization: Bearer <access_token>

New

And there was much rejoicing. 😅 +

Applications, Consents, Groups, Tenants, Themes, Keys, API keys, User Comments, Email Templates, Identity Providers, Webhooks, and Lambdas. (🦁 🐯 🐻 … oh my!) +

Internal

Version 1.44.0

March 13th, 2023

Additional details
This migration will add an index to the identity_provider_links table. It is not expected to negatively impact the migration time during upgrade, but please be aware that deployments with millions of Identity Provider Links may experience additional processing time during the migration.]

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

Enhancements

Internal

Version 1.43.2

July 9th, 2023

Changed

Fixed

Correct an edge case that exists where an event-log.create event fails to be sent to a Kafka topic, and this error causes another event-log.create event to be triggered. +

Internal

Version 1.43.1

March 6th, 2023

Fixed

Version 1.43.0

February 15th, 2023

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Fixed

Enhancements

New

Version 1.42.1

January 8th, 2023

Fixed

Version 1.42.0

December 7th, 2022

Known Issues

Changed

Fixed

Enhancements

New

Version 1.41.3

November 21st, 2022

Security

Version 1.41.2

November 17th, 2022

Fixed

Version 1.41.1

November 16th, 2022

Security

Fixed

Version 1.41.0

November 10th, 2022

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Security

Changed

Fixed

Enhancements

New

Internal

Version 1.40.2

September 28th, 2022

Fixed

Version 1.40.1

September 26th, 2022

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

Enhancements

Version 1.40.0

September 16th, 2022

Changed

Fixed

Enhancements

New

Version 1.39.0

September 11th, 2022

Fixed

Enhancements

Version 1.38.1

August 22nd, 2022

Fixed

Version 1.38.0

August 17th, 2022

Fixed

New

Version 1.37.2

August 11th, 2022

Fixed

Enhancements

Version 1.37.1

August 10th, 2022

Fixed

Version 1.37.0

August 9th, 2022

This release contains some significant internal changes to our HTTP server. While we do not expect any issues, please be aware of this change as you test and prepare for upgrades. Please also be aware of changes to our Windows bundling options.

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Security

Changed

Fixed

Enhancements

New

Internal

Version 1.36.8

July 4th, 2022

Fixed

Version 1.36.7

June 23rd, 2022

Security

Fixed

Version 1.36.6

June 16th, 2022

Fixed

Version 1.36.5

June 13th, 2022

Security

Fixed

Internal

Version 1.36.4

April 21st, 2022

Security

Version 1.36.3

April 19th, 2022

Fixed

Version 1.36.2

April 14th, 2022

Fixed

Version 1.36.1

April 14th, 2022

Fixed

Version 1.36.0

April 7th, 2022

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Security

Changed

Fixed

Enhancements

New

Internal

Version 1.35.0

March 10th, 2022

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

New

Version 1.34.1

February 23rd, 2022

Fixed

Version 1.34.0

February 21st, 2022

Known Issues

Security

Changed

New

Version 1.33.0

February 7th, 2022

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Security

Changed

Fixed

Enhancements

Version 1.32.1

December 13th, 2021

Fixed

Version 1.32.0

December 10th, 2021

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Changed

Fixed

Enhancements

New

Internal

Version 1.31.0

November 18th, 2021

Known Issues

Changed

Fixed

Enhancements

Internal

Version 1.30.2

October 13th, 2021

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

Enhancements

Internal

Version 1.30.1

August 25th, 2021

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Fixed

Enhancements

Internal

Version 1.30.0

August 12th, 2021

Features that require the Threat Detection feature:

  • CAPTCHA
  • Domain blocking in registration
  • IP access control lists
  • IP location
  • Some of the new events and transactional emails
  • Rate limiting

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Fixed

Changed

New

Enhancements

Version 1.29.4

August 12th, 2021

Fixed

Version 1.29.3

August 6th, 2021

Fixed

Version 1.29.2

July 31st, 2021

Fixed

Version 1.29.1

July 26th, 2021

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

Version 1.29.0

July 10th, 2021

Fixed

Enhancements

Internal

Version 1.28.1

June 21st, 2021

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Fixed

Tech Preview

Version 1.28.0

June 7rd, 2021

The FusionAuth identity providers have undergone a significant improvement to add additional flexibility and support for 3rd parties. Please take time to test this upgrade with your existing configuration to ensure compatibility. Some of the features in this release are in tech-preview.

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Changed

New

Enhanced

Fixed

Tech Preview

Version 1.27.2

May 10th, 2021

Changed

Fixed

Version 1.27.1

May 7th, 2021

Fixed

Version 1.27.0

May 5th, 2021

Some of the features in this release are in tech-preview. Please give us feedback and let us know how they work for you!

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Changed

Fixed

Tech Preview

New

Enhancements

Version 1.26.1

April 20th, 2021

Fixed

Known Issues

Version 1.26.0

April 20th, 2021

Lots of changes ahead! Read carefully to see how this release may affect you.

Two Factor APIs

Breaking changes. If you use this functionality, please review the API changes and test before upgrading. The Two-Factor API, two-factor fields on the User and Import User APIs and the Integrations API have changed and are not backwards compatible. If you use this functionality, please review the API changes and test before upgrading.

Upgrading from < 1.7.0

If you are upgrading from a version less than 1.7.0, you must do a two stage upgrade. Upgrade to a version greater than or equal to 1.7.0 but less than 1.26.0, then upgrade from that version to 1.26.0. There were internal migration changes which necessitate this two stage process.

Accessing the admin Login after upgrading:

The / path of FusionAuth no longer automatically forwards to the admin login. To access the Admin UI to complete this configuration append /admin/ to the URL. Once the theme configuration is complete, this root page will contain links to login and instructions on how to utilize this root landing page.

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Changed

Fixed

Tech Preview

New

Enhancements

Version 1.25.0

March 10th, 2021

SAML v2 Logout is now fully supported. No action should be required. If you are currently using FusionAuth as a SAML v2 IdP, please verify your configuration as you may want to provide additional configuration to take full advantage of the SAML v2 Logout configuration. The additional of SAML v2 Logout means there is a new themed page to manage the user experience for SAML v2 Logout. Please review your theme to ensure your user experience is not interrupted. See additional details in the New section below.

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Changed

Fixed

New

Enhancements

Internal

Version 1.24.0

February 11th, 2021

Known Issues

Security

Changed

Fixed

Enhancements

Internal

Version 1.23.3

January 21th, 2021

Fixed

Version 1.23.2

January 20th, 2021

Fixed

Version 1.23.1

January 13th, 2021

Fixed

Version 1.23.0

January 11th, 2021

The database schema has changed and an upgrade is required for this version of FusionAuth. While in development mode you will prompted to upgrade the database by maintenance mode before you may login. In a production runtime with silent configuration, the upgrade will occur automatically during startup.

See Database Upgrades for more information about database migrations.

Known Issues

Fixed

New

Enhancements

Client libraries