SecureAuth Identity Platform air-gapped installation preventing New Experience from displaying

Version Affected:  9.3 and newer

Description:  

When deploying the SecureAuth Identity Platform in an air-gapped environment, you are not able to get to the New Experience dashboard due to the appliance's inability to contact SecureAuth cloud services.  Instead of the admin console, you either see errors on the page, or simply a blank white page.

Cause:  

The New Experience dashboard in Identity Platform 9.3 and newer requires access to the SecureAuth cloud services in order to render information that is stored in the cloud.  If that connection is not available, the Identity Platform will not be able to render a usable page, preventing access to the admin console to manage your realms.

Resolution:  

You will need to modify the start pages of the Identity Platform so that it redirects you to the Classic Experience by default.

• In D:\SecureAuth\SecureAuth0\localAdmin.aspx, change the following pieces:

1. Inherits

<%@ Page Language="vb" AutoEventWireup="false" Inherits="MFC.WebApp.SecureAuth.LocalAdmin" CodeBehind="LocalAdmin.aspx.vb" %>

 to

<%@ Page Language="vb" AutoEventWireup="false" Inherits="LocalAdmin" CodeFile="LocalAdmin.aspx.vb" %>

2. ResolveUrl

In Identity Platform 19.07+

<a href="<%=Page.ResolveUrl("~/authorized/webadminswap.aspx")%>">

In Identity Platform 9.3

<a href="<%=Page.ResolveUrl("~/authorized/webadmin.aspx")%>">

to

<a href="<%=Page.ResolveUrl("~/authorized/webadminstart.aspx")%>">

3. setTimeout

In Identity Platform 19.07+

redirectTimeout = setTimeout("location.href='Authorized/WebAdminSwap.aspx'", 5000);

In Identity Platform 9.3

redirectTimeout = setTimeout("location.href='Authorized/WebAdmin.aspx'", 5000);

to

redirectTimeout = setTimeout("location.href='Authorized/WebAdminStart.aspx'", 5000);

• In D:\Secureauth\Secureauth0\localAdmin.aspx.vb, change the following pieces:

1. HttpContext

In Identity Platform 19.07+

HttpContext.Current.Response.Redirect("~/Authorized/WebAdminSwap.aspx", False)

In Identity Platform 9.3

HttpContext.Current.Response.Redirect("~/Authorized/WebAdmin.aspx", False)

to

HttpContext.Current.Response.Redirect("~/Authorized/WebAdminStart.aspx", False)

2. Request update

In Identity Platform 19.07+

Response.Redirect("~/Authorized/WebAdminSwap.aspx", False)

In Identity Platform 9.3

Response.Redirect("~/Authorized/WebAdmin.aspx", False)

to

Response.Redirect("~/Authorized/WebAdminStart.aspx", False)

Once all the changes have been completed, clear your browser cache and restart IIS.  Then try to access the admin console.  The browser should automatically take you to the Classic Experience, skipping the New Experience entirely.

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.