Redirect legacy realm URL for internal applications

Use this procedure if you've set up an internal application in the New Experience to replace an existing legacy internal application that was created in the Classic Experience.

To continue using the login URL from the legacy realm, you can set up a redirect from the legacy realm to the new realm.

Prerequisites

  • SecureAuth® Identity Platform release 21.04 on-prem deployment

  • For Identity Platform release 21.04 cloud deployments, contact SecureAuth Support

  • New internal application set up and configured as in: Connecting a legacy internal application

  • Realm numbers for legacy internal application and new internal application

Procedure

  1. In the Identity Platform, go to the Classic Experience.

  2. Click the Admin Realm tab, and clear any selected realm check boxes.

    Important

    Make sure you do not have any selected realm check boxes, like SecureAuth0.

  3. Click the legacy realm name and make sure you select the realm check box.

    For example, the legacy realm is SecureAuth254.

    Important

    It is important that you first select and open the legacy realm.

    internal_app_mgr_013.png
  4. Next, find the matching new internal application realm and select only the realm check box.

    For example, the new internal application realm you added using the Internal Application Manager is SecureAuth256.

    Important

    It is important that you select only the check box and not the realm name link.

    internal_app_mgr_014.png
  5. Click Save and confirm your changes.

  6. On the Identity Platform on-prem server, open the IIS Manager.

  7. To redirect the legacy realm URL to the new realm URL, do the following:

    1. From list of realms, select the legacy realm.

      For example the legacy realm is SecureAuth254.

    2. Set the Pattern to .*

      This catches any requests to the legacy realm.

    3. Set the Action type to Redirect.

    4. Set the Redirect URL to the new internal application realm.

      For example, the new internal application realm is SecureAuth256.

    internal_app_mgr_011.png
  8. Apply your changes.