Common QPR Authentication

Common authentication enables linking from one QPR product to the other without the need of a separate login for the product that is the link target. When you are authenticated to one QPR product, you are automatically authenticated all other QPR products as well. It is possible to configure a common authentication between following QPR products:

• QPR UI
• QPR ProcessAnalyzer Web Service
• QPR Suite Portal
• QPR Suite Web Services

Common authentication works in a way that if there is a valid (non expired) session existing in any of the systems, sessions for the other systems are refreshed automatically without the need to login again. If all sessions have expired, there is a need to relogin. If a session has been expired, a valid session in other system is able to renew the expired session without notifying user.

Common authentication needs to be setup for each QPR product according to the instructions described in this page.

In common authentication, username attribute is used to match user accounts between QPR products.

Configuring Common Authentication for QPR UI

To configure Common Authentication for QPR UI, follow these instructions:

1. Determine the needed setting string as follows: it uses format PRODUCTNAME,URL;PRODUCTNAME,URL;... where PRODUCTNAME is either WAS, WS or PA. Example:
   WAS,http://SERVERNAME/QPR/Portal/QPR.Isapi.dll;WS,http://SERVERNAME/QPR/Portal/QPR.Isapi.dll/wsforward/MainService.svc/webHttp/;
   SERVERNAME is the name of the corresponding server.
2. Login to the QPR UI database using the SQL Server using SQL Server Management Studio.
3. Right click QPR UI database, select New Query, and define following query:
   SELECT VALUE_FIELD FROM [DATABASENAME].[dbo].[CONFIGURATIONENTITY] WHERE KEY_FIELD ='AUTHENTICATION_SERVICES';
   If the query returns a row, store the result for backup.
4. If the step 4 query didn't return anything, execute following query to make the setting change:
   INSERT INTO [DATABASENAME].[dbo].[CONFIGURATIONENTITY](KEY_FIELD,VALUE_FIELD) VALUES ('AUTHENTICATION_SERVICES', 'SETTINGSTRING');
   (replace the SETTINGSTRING with the one determined in step 1).
5. If the step 4 query returned a row, execute following query to make the setting change:
   UPDATE [DATABASENAME].[dbo].[CONFIGURATIONENTITY] SET VALUE_FIELD = 'SETTINGSTRING' WHERE KEY_FIELD = 'AUTHENTICATION_SERVICES';
   (replace the SETTINGSTRING with the one determined in step 1).

Configuring Common Authentication for QPR ProcessAnalyzer

The QPR ProcessAnalyzer web.config configuration file is used for registering servers belonging to the common authentication group. To set up a common authentication group, add the URL of the product where the linking is done from to the web.config file of the target product. For example, to link between QPR UI and QPR Suite Portal, add three groups, ServerGroupPA, ServerGroupMD and ServerGroupMEA, to the web.config file in <Qpr.ProcessAnalyzer.Common.Properties.Settings> section. Specify the QPR ProcessAnalyzer url for ServerGroupPA, the QPR UI url for ServerGroupMD and the QPR Portal url for ServerGroupMEA.

In the following example, SERVERNAME's needs to be replaced with the name of the respective QPR server:

<setting name="ServerGroupPA" serializeAs="Xml">
  <value>
    <ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <string>http://SERSERNAME/string>
    </ArrayOfString>
  </value>
</setting>
<setting name="ServerGroupMD" serializeAs="Xml">
  <value>
    <ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <string>http://SERVERNAME:8080/EnticeServices/</string>
    </ArrayOfString>
  </value>
</setting>
<setting name="ServerGroupMEA" serializeAs="Xml">
  <value>
    <ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <string>http://SERVERNAME/QPR2017-1/Portal/QPR.Isapi.dll</string>
    </ArrayOfString>
  </value>
</setting>

Configuring Common Authentication for QPR Suite Portal and QPR Suite Web Service

1. In the QPR application server, open file C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Settings\QPR_Servers.ini. Note that you may have other version than QPR Suite 2017.
2. In the [UMS Settings] section, set EnableSSOForPortal=1 (if EnableSSOForPortal setting already exists, change the existing setting. If the setting doesn't exist, create it as a new).
3. If you are adding the common authentication to QPR UI, in the [WAS Settings] section, add
   AuthenticationService_1=ENTICE,http://SERVERNAME:8080
   SERVERNAME is the name of the QPR UI server that is used when accessing QPR UI. Note that the url defined here does not contain a path part, such as EnticeServices. If you also need to add common authentication to QPR ProcessAnalyzer, add
   AuthenticationService_2=PA,http://SERVERNAME
   as a new line. Note the increasing number in the setting name if AuthenticationService_1 is already reserved.
4. Restart QPR Suite Windows service.

For more information, see the detailed instructions: http://kb.qpr.com/qpr2017-1/index.html?common_qpr_authentication.htm

Note also that the QPR Reporting Add-on has a separate mode for the common QPR authentication (in its web.config file qprauthenticationmode=commonqprauthentication). More information about Reportin Add-on web.config file.

Embed QPR Suite Portal in QPR UI

QPR Suite Portal can be embedded into QPR UI using External Content presentation object. When setting QPR Suite Portal url (in the External Content URL field), add the following parameter to the url: &xsession=<#sys:sessionId>. When the session id is passed to the Suite QPR Portal, user is automatically authenticated to QPR Portal using the common authentication.

QPR UI Session Expiration

By default, QPR UI user session will expire if there is no communication with the QPR UI server for 30 minutes. This default expiration time can be changed by adding or editing the SESSION_EXPIRATION_TIME value (in minutes) in the CONFIGURATIONENTITY table in QPR UI database configuration table.

If session in QPR Suite or QPR ProcessAnalyzer is still valid when QPR UI session has expired, QPR UI session is automatically renewed without the need to input credentials.

If federated authentication is in use, the user is redirected to the identity provider. Note that the session in the identity provider server may still be valid and thus there is not need to input credentials.