Configure the Web Client settings.js file (modified in an update) - HxGN SDx - HxGN SDx - Reference - Hexagon

HxGN SDx Modified and Retired Functionality

Language
English
Product
HxGN SDx
Search by Category
Reference
SmartPlant Foundation / SDx Version
10
SmartPlant Markup Plus Version
10.0 (2019)

The following applies if you are using a version of the software from Update 23 to Update 49. From Update 50, the Web Client uses the settings.json file, which replaces the settings.js file. For the latest information, see Configure the Web Client settings.json file.

  1. Locate the Web Client settings.js file. For example:

    C:\SDx Server Files\WebClient_Sites\[WebClient]\settings.js

  2. Edit the settings.js file and add the settings shown in the following example:

    Setting

    Detail

    client Id

    0oag04x1t1cW5miJS0h7

    redirectUri

    https://okta-spf.12345.com/spfwebclient

    postLogoutRedirectUri

    https://okta-spf.12345.com/[separatelogoutURLpath]

    identityProvider

    ""

    scopes

    ingr.api openid profile

    usePKCE

    True

    dummyClientSecret

    ""

The following image shows an example of a settings.js file:

You can use the Logout Redirect URL setting in Server Manager to provide a separate redirection path after logout to avoid OAuth authentication loops. For more information, see Post logout redirect authentication loop.

SHARED Tip You can also configure the settings.js file using the Server Manager command line. The following example demonstrates how to configure the settings shown above:

SDxServerManager.exe /updatesdasite sn:SDxClient /oauthissuerurl: https://dev597594.oktapreviewcom/oauth2/ausg0871hp0DCijdr0h7 /clientid:0oag04x1t1cW5miJS0h7 /oauthredirecturi:https://okta-spf.12345.com/spfwebclient /postoauthRedirecturi:https://okta-spf.12345.com/[separatelogoutURLpath] /scopes:”ingr.api openid profile” /identityprovider:""

The following applies if you are using a version of the software before Update 23

The following applies if you are using a version of the software before Update 23. For the latest information, see Configure the Web Client settings.json file.

  1. Locate the Web Client settings.js file. For example:

    C:\SmartPlant Foundation Server Files\SPFWebClient_Sites\[WebClient]\settings.js

  2. Edit the settings.js file and add the settings shown in the following example:

    Setting

    Detail

    url

    https://dev597594.oktapreviewcom/oauth2/ausg0871hp0DCijdr0h7

    client id

    0oag04x1t1cW5miJS0h7

    redirectUri

    https://okta-spf.12345.com/spfwebclient

    logoutredirectUri

    https://okta-spf.12345.com/[separatelogoutURLpath]

    identityProvider

    ""

    Scopes

    ingr.api openid profile

  • Scopes is an additional line that needs to be added to the settings.js file. The following image shows an example of a settings.js file:

  • You can use the Logout Redirect URL setting in Server Manager to provide a separate redirection path after logout to avoid OAuth authentication loops. For more information, see Post logout redirect authentication loop.

SHARED Tip You can also configure the settings.js file using the Server Manager command line. The following example demonstrates how to configure the settings shown above:

SPFServerManager.exe /updatesdasite sn:SPFClient /oauthissuerurl: https://dev597594.oktapreviewcom/oauth2/ausg0871hp0DCijdr0h7 /clientid:0oag04x1t1cW5miJS0h7 /oauthredirecturi:https://okta-spf.12345.com/spfwebclient /postoauthRedirecturi:https://okta-spf.12345.com/[separatelogoutURLpath] /scopes:”ingr.api openid profile” /idenityprovider:""