Creating a Default SSO Jump Page Layout

Owned by Stephen Call (Deactivated)
Last updated: Feb 23, 2022
3 min read

Problem

You want to be able to customize the default layout of the SSO Jump page. 

Requirements

  • PortalGuard version feature: v6.5.X or Later

  • The Identity Provider must be configured to allow for Jump Page customization.

    • This is done from the Jump Page tab in the 'General IdP Settings':

Solution

Define a default JSON string under the 'Edit Default Customization' section within the Jump Page settings.

To create the JSON string for the default customization, follow the steps below:

  1. Log into your own account or test account and customize it however you like. The layout you make will be what is set as the default.

  2. Connect to your SQL server through Microsoft SQL Server Management Studio and create a new query, copy and pasting the following. Replace 'username' with the name of the user you made the previous customization on, keeping the single quotes.

    • use pstar;

    • select * from SSOCustomizations where Uname = 'username';

  3. Right Click and copy the contents of the The Blob column for this user.

  4. Enter your IdP configuration editor, click 'General IdP settings', and navigate to the last tab Jump Page.

  5. Click the 'Edit Default Customization' Button and paste the JSON string that was just copied.

  6. Click 'OK', then 'Save'

  7. Click 'Apply to Identity Provider', then 'Sync' to push the changes to the PortalGuard Identity Provider.

  8. Log into PortalGuard with a different account, and test to see that the default customization loads.

TheBlob Entry is too big! - How can I convert the field into a usable state?

The JSON is only compressed at rest in the SQL table. The uncompressed JSON can be seen numerous ways:

  1. Use a HTTP trace utility like Fiddler or the built-in Network tracing in Chrome to see the JSON returned from the "/sso/PGIdP.ashx" URL when refreshing the SSO Jump Page. It is clear-text at this point.

  2. If you copy the encoded & compressed value from the "template" user directly from the SSOCustomizations table, you can paste this into Fiddler's "TextWizard" feature and get the clear-text using the "From DeflatedSAML" transform.

Of these two, the 2nd is probably the easier, instructions for which are provided below:

  1. Copy “TheBlob” entry for the user you would like to use as the Default SSO Jump Page.

  2. Open Fiddler.

    1. Select 'Tools → TextWizard…”

  3. Copy “TheBlob” entry into the TextWizard.

  4. Transform: FromDeflatedSAML

  5. Copy the output into the Idp Configuration Editor to use as the Default SSO Jump Page for all users.