IBM Support

How to redirect users after Sign Out in Cognos Analytics?

Question/Answer


Question

By default, Cognos Analytics returns users to the Cognos Analytics main page when they click the Sign Out link. This can result in confusion in the case where single sign-on is configured as users will be immediately logged back in again.

In Cognos 11.1, you no longer need to create a html file to redirect users. Logout/login URLs can be specified directly from the portal. You will not need to restart the services after updating the URLs.

Answer

You can override the default behaviour in the following way on all Cognos Content Manager Servers:

In Cognos Analytics 11.0.5 or earlier:


1. Modify <install.dir>/configuration/bi-services.xml and add the following line
<jndiEntry jndiName="glass/sso/logout" value="about:blank"/>
2. Modify "about:blank" to be any relative or absolute URL of your choice.

In Cognos Analytics 11.0.6 and later (Solution verified using Internet Explorer browser):

  1. Create an XML file called local-server.xml
  2. Edit the file to add the following: <server><jndiEntry jndiName="glass/sso/logout" value="logoff.html"/></server>
  3. This file should be placed in <app dir> / configuration /
  4. Create an HTML file called logoff.html
  5. Edit the file to contain the following:

<html>

 <head><head><title>log off</title></head>

 <script type="text/javascript">

function functionOne() { javascript:document.execCommand("ClearAuthenticationCache"); }

function functionTwo() { javascript:window.open(" YOUR DISPATCHER URI","_self"); }

 </script>

 </head>

<body>

 <p><a href="#‌" onClick="functionOne(); functionTwo();">Clear User Session & Log On...</a></p>

 </body>

</html>

Where YOUR DISPATCHER URI = http://servername:port/bi/v1/disp

  1. This logoff.html file should be placed in <gateway dir> / webcontent / bi /
  2. App tier will need to be restarted for changes to take effect.
  3. Now signing off should take the user to the logoff.html where they will be able to click the link to access the direct dispatch to log in.

The logoff.html is an example redirect page and can be changed to something more appropriate if necessary.

If this doesn’t work check the following:

  • The URL after being redirected matches the location of the logoff.html, if it doesn’t adjust the local-server.xml accordingly. Remember any changes made to local-server.xml won’t take effect until the app service is restarted.
  • Sometimes browser cache can cause the user to be logged straight back in again when using the direct dispatch, so you may need to use private browsing or clear cache.
  • Ensure that if you have multiple gateways and multiple applications that the local-server.xml and logoff.html are placed in all of them.

Related information

Redirect user at Log off
Equivalent in Cognos 11.1

Document information

More support for: Cognos Analytics

Component: Administration and Configuration v11x

Software version: 11.0.x, 11.1.x

Operating system(s): AIX, Linux, Solaris, Windows

Software edition: All Editions

Reference #: 1995296

Modified date: 13 February 2019