Breaking Changes

These following changes were already present in 5.8 and are listed here for visibility.

API Policy migration

We've strived to make the update and migration process as smooth as possible, but due to difference in the configuration model for the new API Policy based authentication and authorization, the following should be noted:

  • An API Process which has OAuth in the OpenAPI Specification and it's path is included in the API Key rulesets was previously only accessible through OAuth, but now it will be accessible with both authentication methods because it had a matching API Key ruleset. This can be reconfigured by modifying the API Policy

  • The update and migration might be blocked if there are inconsistencies between the OpenAPI Specification and Process deployments

Legacy Agent

We strongly recommend updating to the Cross-platform Agent to be able to use the latest technology and solutions possible. Some features will not be supported by it, like the HTTP monitoring which was released in Frends 5.7.

  • Legacy Agent are being retired, their End of Life is in 18 months, meaning that any releases after 1.1.2026 will no longer support the Legacy Agent

These following changes were already present in 5.7 and are listed here for visibility.

Frends Platform API changes (for pre 5.7 installations)

The Frends Platform API has been now released and the old v0.9 path has been retired, so you will need to update any calls to the API to target the new v1 path. Also the error result for the API calls has been changed, otherwise the APIs will work the same way as before. Also there are changes to the internal API which is not fully supported for outside use, so if you have used that, you will need to verify everything works separately.

You can learn more about the Frends Platform API here.

Frends Agent container image path changed

The path for the assemblies inside of the container image is now /app. If there are modifications to the official container image, the new path should be taken into account.

Agents required to have access to the UI

The Agents now fetch their Process and Task packages through the UI, so firewalls on the Agents need to allow outbound access to the Frends UI: <tenant>.frendsapp.com on port 443.

Agent bundled installation LocalDB requires Visual C++ Redistributable (Frends 5.7.3+)

Because the bundled LocalDb for the Legacy Agent was updated, you will need to install Visual C++ 2019 redistributable before installing the bundle. The installer available from here: https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170

OpenId Connect (SSO)

Customers using Microsoft Entra ID (formerly Azure AD) as an OpenID login provider for their Frends Tenant must update the App Registration in Azure.

In the Azure portal, go to Manage → Authentication and modify the App Registration's Redirect URI.

Starting with Frends 5.7, the Redirect URI must include an OIDC suffix: signin-oidc-[Application ID].

Example (Frends 5.6 or earlier):

  • Redirect URI: https://myfrendstenant.frendsapp.com

  • Application ID: 3e89b538-f75c-42b5-96f1-402f1ac0a549

Updated Redirect URI for Frends 5.7+: https://myfrendstenant.frendsapp.com/signin-oidc-3e89b538-f75c-42b5-96f1-402f1ac0a549

You can add the new URI in advance as an additional URI to the App Registration to ensure functionality before and after the update.

Do not remove or modify the current Redirect URI until Frends is updated to 5.7+, as the new format is incompatible with earlier versions.

No changes are needed in the Frends UI.

These following changes were already present in 5.5 and are listed here for visibility.

Service Bus for Windows (for pre 5.5 installations)

Support for Service Bus for Windows Server is removed, when updating to 5.5+ switching to RabbitMQ for full on-premise deployments is mandatory. This also means that using the Service Bus Trigger no longer works with Service Bus for Windows Server.

​Remote Subprocesses (for pre 5.5 installations)

Because of changes to the message busses used by Frends, Agent groups within an Environment should be reinstalled at the same time. This is required when Remote Subprocesses are being used.

​Frends.Tasks.Attributes support to be removed

Frends Tasks Attributes was a way of modifying the Parameter editor for Tasks before Frends 4.5.6, when it was deprecated and support for it was removed in 5.5.3. Previously imported Tasks will continue to work normally, but new Task imports will require migration to System.ComponentModel.Annotation to support conditional parameter displays etc.

Check here for more information about Custom Tasks.

SQL Server requirements

The minimum supported version of SQL Server is now MS SQL Server 2017 for on-premise deployments.

Last updated

Was this helpful?