Breaking Changes

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

Use your own Application ID, obtained from Azure Portal for your Application registration, instead of the example value. The example value will not work for you.

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.