[V8.5.6.1 or later]

Specifying a redirection logout URL for the dashboard

When users explicitly log out of the WSRR dashboard, you can, for security or other reasons, redirect their browser page to a specific redirection URL. You can configure an internal server redirection by using an implicit or explicit forward slash (/), or configure an external redirection by using an Internet protocol string.
Note: Redirection does not occur for session timeouts, which are related to a period of inactivity.

To configure the redirection, you must create a WebSphere variable. WebSphere variables can be used to provide settings for the string data type attributes that are contained in the product configuration files, configure product path names, or configure certain cell-wide or cluster-wide customization values. The variables are defined with a scope, to indicate the range of locations within the product network (node, cluster, cell, or server level) where the variable is applicable.

Procedure

  1. Log in to the WebSphere Application Server administrative console as an administrator.
  2. Click Environment > WebSphere variables.
  3. Select the scope of the variable from the listed scopes. Choose one of the following options:
    • Set the scope at the cluster level to apply the variable to the entire cluster in the deployment manager cell.
    • Set the scope at the server level to apply the variable to the entire server.
  4. To create the WebSphere variable for redirection, click New.
  5. Specify WSRR_DASHBOARD_LOGOUT_REDIRECT_URL as the variable name.
  6. Specify a value for this variable. The redirection value can take one of three formats, as shown in the table. In the examples, https://server:port/ServiceRegistryDashboard represents the login URL (secured) for the WSRR dashboard, https://server:port represents the base URL, and ServiceRegistryDashboard represents the name of the dashboard context root.
    Format Redirection value and description
    Extension of the dashboard URL Appends the specified value to the dashboard URL and redirects the browser page to this new address.
    Note: A leading forward slash (/) is not required because it is implicit.
    Example:
    • Value of variable: login.jsp
    • Redirection URL: https://server:port/ServiceRegistryDashboard/login.jsp
    Replacement of the dashboard context root Replaces the dashboard context root with the specified value and redirects the browser page to this new address.
    Important: The first character must be a forward slash (/).
    Example:
    • Value of variable: /ServiceRegistry
    • Redirection URL: https://server:port/ServiceRegistry
    Redirection to a different site or server Redirects the browser page to the address of a different site or server.
    Important: This value must be an absolute URL that starts with either http:// or https://; otherwise, it will be processed as a dashboard URL extension or context root substitution depending on the starting character.
    Example:
    • Value of variable: http://www.ibm.com/software/products/en/wsrr
    • Redirection URL: http://www.ibm.com/software/products/en/wsrr
  7. Optional: Specify a description for the variable.
  8. Click OK.
  9. Save your configuration and then restart the server for the variable configuration change to take effect.