Common QPR Authentication

It is possible to configure a common authentication system between different QPR Suite product web clients (e.g. QPR ProcessAnalyzer Web Client and QPR Portal), so that linking from one product web client to the other can be done without the need of a separate login for the product that is the link target.

Configuring Common QPR Authentication

The configuration file web.config in QPR ProcessAnalyzer Service is used for registering servers belonging to the common authentication server group. The servers can then share user sessions created for users.

To set up a common authentication server group:

1. Create or change usernames in both the source and target QPR products, so that the usernames are identical in both products.
2. Configure common authentication settings by adding 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 ProcessAnalyzer Web Client, QPR MobileDashboard, and QPR Portal, do as follows:

• Add three groups, ServerGroupPA, ServerGroupMD, and ServerGroupMEA, to the web.config file under <Qpr.ProcessAnalyzer.Common.Properties.Settings> section. Specify the QPR ProcessAnalyzer service URLs for ServerGroupPA, the QPR MobileDashboard service URL(s) for ServerGroupMD, and the QPR Portal service URLs for ServerGroupMEA. See example below:

            <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://pa1.qpr.com</string>
                        <string>http://pa2.qpr.com</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://mobiledashboard: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://mea1.qpr.com/QPR/Portal/QPRIsapi.dll</string>
                        <string>http://mea2.qpr.com/QPR/Portal/QPRIsapi.dll</string>
                    </ArrayOfString>
                </value>
            </setting>

Linking between QPR Products

Common QPR authentication enables opening links, such as QPR ProcessAnalyzer reports in QPR Portal, without additional authentication.

QPR ProcessAnalyzer in QPR Portal

To view an analysis created with QPR ProcessAnalyzer in QPR Portal, do as follows:

1. In QPR ProcessAnalyzer Excel Client, open the analysis you want to view.
2. To save the current analysis view as a bookmark, click the Bookmark button, select New Bookmark and in the Bookmark Properties dialog that opens, click OK.
3. Find out the Id of the bookmark you just created by opening the Bookmark Properties dialog for the bookmark you created and see the Id in the Statistics group of that dialog.
   Optionally, in Manage Bookmarks dialog, right click a column title, select Column Chooser from the popup and drag the Id column to the table.
4. In QPR Portal, create a new bookmark. Paste the bookmark Id to the end of a URL that is formatted as follows:
   http://<QPR ProcessAnalyzer server>/#bookmark=<bookmark id>&ui=1&XSESSION={#sessionid}
   Do not make changes to the {#sessionid} tag, just copy it exactly like it is written above.
   For example: http://pa.qpr.com/#bookmark=1&ui=1&XSESSION={#sessionid}.
   Note that using the "&ui" parameter with the value "1" will open the bookmark in Full Screen Mode inside the web page it was embedded in.
5. In QPR Portal, open the bookmark you created in the previous step and you will see the analysis without additional authentication.

QPR ProcessAnalyzer in QPR MobileDashboard

To view an analysis created with QPR ProcessAnalyzer in QPR MobileDashboard, do as follows:

1. In QPR ProcessAnalyzer Excel Client, open the analysis you want to view.
2. To save the current analysis view as a bookmark, click the Bookmark button, select New Bookmark and in the Bookmark Properties dialog that opens, click OK.
3. Find out the Id of the bookmark you just created by opening the Bookmark Properties dialog for the bookmark you created and see the Id in the Statistics group of that dialog.
   Optionally, in Manage Bookmarks dialog, right click a column title, select Column Chooser from the popup and drag the Id column to the table.
4. In QPR MobileDashboard, add a new External Content presentation object to the view, and define its URL as:
   http://<QPR ProcessAnalyzer server>/#bookmark=<bookmark id>&ui=1&XSESSION={#sessionid}
   Do not make changes to the {#sessionid} tag, just copy it exactly like it is written above.
   For example: http://pa.qpr.com/#bookmark=1&ui=1&XSESSION={#sessionid}.
   Note that using the "&ui" parameter with the value "1" will open the bookmark in Full Screen Mode inside the web page it was embedded in.

Note: you can also show tabular QPR ProcessAnalyzer analyses in QPR MobileDashboard by using the Table presentation object.