Once the Reporting Dashboards is installed, the appsettings.json file must be edited to properly connect the Reporting Dashboards to the API Server. The appsettings.json file is located in the config folder of the Reporting Dashboards installation location. By default, this location is ..Program Files\Hyland\ReportingDashboardsWebSuite\.
To edit the appsettings.json file:
- Open appsettings.json using a text editor, such as Notepad.
- Locate the authConfig element in the hyShell element.
-
Update the values of the following attributes:
Attribute
Description
issuer
The URL of the previously configured IdP server, including /idp.
scope
The scope of the IdP server, defined in the idpconfig.json file for that server. You must include both "openid" and "offline_access" in the scope. For example, at minimum, this value should be set to "open id offline_access".
clientId
The client ID defined in the idpconfig.json file for that server.
idp-tenant
The tenant defined in the idpconfig.json file for that server.
redirectUri
The URL to redirect authenticated users to. Set the value to the root URL to which the Reporting Dashboards is deployed and add /view/authentication-confirmation.
Note:The value for redirectUri also needs to be set in the idpconfig.json file.
postLogoutRedirectUri
The URL to redirect unauthenticated and logged out users to. Set the value to the root URL to which the Reporting Dashboards is deployed and add /view/unauthenticated.
Note:The value for postLogoutRedirectUri also needs to be set in the idpconfig.json file.
apiServerUrl
The UPRL of the API server, including the port.
- Save the changes to the appsettings.json file.
- Close the text editor.
After completing the editing of the appsettings.json file, you must perform an IIS reset for the changes to take effect.