Post-installation Configuration and Known Impacts

Because this hotfix moves the Aras Innovator platform to .NET 10, a small number of .NET 10 runtime changes can affect how an existing deployment behaves after the upgrade. Review the following items and apply the configuration described where it applies to your environment. These changes do not affect every installation; standard single-server deployments without a reverse proxy generally require no additional configuration.

This item applies if Aras Innovator is deployed behind a reverse proxy, load balancer, or in a Kubernetes environment where client information is passed using the X-Forwarded-For and X-Forwarded-Proto headers. With the update to .NET 10, Microsoft has introduced changes to the forwarded-headers middleware (deprecation ASPDEPR005). To understand these changes and how they may impact your configuration, please refer directly to Microsoft’s official documentation:

• ASPDEPR005: Obsolete ForwardedHeadersOptions properties and types
• Configure ASP.NET Core to work with proxy servers and load balancers

To ensure compatibility with the updated platform binaries in this hotfix, any custom server-side methods, plugins, or extensions must be recompiled to target net10.0. This includes, where used, authentication plugins (such as SiteMinder, SAML2, and Windows Authentication), vault storage plugins (such as Azure Blob Storage and Simple File Upload), and any other server-side components built against an earlier .NET version.

For guidance on updating your custom code to .NET 10 and addressing any framework-level changes, please refer directly to Microsoft’s official documentation:

• What’s new in .NET 10
• Breaking changes in .NET 10

If you use Aras Applications, Platform Components, or custom integrations and are unsure whether they require changes, contact Aras Corporation Support at Aras Subscriber Portal before applying the hotfix in production.

Some Aras-provided applications include server-side plugin components and therefore require versions that target .NET 10. Before applying this hotfix to an environment that uses these applications, upgrade them to the minimum versions listed below:

• Enterprise Hot Fix (EHF): version 14.3.0 or later.
• Office Add-in for Requirements (OAR): version 14.2.0 or later.

For these applications, the required action is a version upgrade to the listed release or higher prior to applying the .NET 10 hotfix.