Deeplink redirects to default home page after Teamcenter SSO login instead of intended destination

Issue

When accessing a Mendix application via a deeplink, the application redirects to the default home page after Teamcenter SSO login instead of the intended deeplink destination. The Teamcenter SSO configuration works correctly when accessing the application directly. The flow is as follows:

1. Navigation to the Mendix application with a deeplink (for example, http://localhost:8080/item_id/12345).
2. The application redirects to the Teamcenter SSO login page, using mendixapp/callback as the callback URL.
3. After successful SSO login, the application redirects back into the Mendix app via mendixapp/callback.
4. At this point, the deeplink is lost — provisioning and authentication are completed, and the application is redirected to mendixapp/homepage instead of the intended deeplink destination.

Environment

Teamcenter Extension

Cause

This behavior occurs because the deeplink target is not preserved through the Teamcenter SSO authentication roundtrip. During the Teamcenter SSO login flow, when the application redirects to the identity provider and back via the callback URL, the deeplink module loses the original deeplink destination. The deeplink module and the Teamcenter SSO authentication flow do not natively communicate the intended redirect destination across the roundtrip. This scenario is not supported out of the box and has been registered as a feature request.

Solution/Workaround

Native support for preserving deeplink destinations across a Teamcenter SSO login roundtrip is not available. The following two custom implementation approaches can be used as a workaround:

1. Customization using a RedirectURL query parameter on the Teamcenter SSO login endpoint:
   • In the published REST service document, add RedirectURL as a query parameter to /rest/tcsso/login.
   • The entity should store the RedirectURL when it is created in DL_HandleSSOLoginMicroflow.
   • After authentication, retrieve the RedirectURL from the entity and use it to navigate to the intended URL.
2. Use the callback URL with additional query parameters that survive the Teamcenter SSO roundtrip:

Extend the callback URL with additional query parameters that encode the intended deeplink destination, so the information is preserved throughout the Teamcenter SSO authentication flow and can be used to redirect back to the original destination after login.

Additional information

• Mendix documentation:
  • Deep Link Module
  • Teamcenter SSO