IBM Support

Automatically renew trusted credential’ in Cognos Analytics 11.x

Question & Answer


Question

How do I choose the value to use for the Security > Authentication > Automatically renew trusted credential setting in Cognos Analytics 11.x?

Answer

For IBM Cognos Analytics 11 deployments that do not implement a single sign-on (SSO) solution, stored credentials used for running scheduled activities can be automatically updated. When a user logs into the IBM Cognos Analytics 11 application with a user name and password, the trusted credential used to run schedules when not logged in will be refreshed as well. This removes the burden from the end user of having to remember to manually refresh their trusted credentials and may eliminate failed activities caused by changed or expired user credentials.
Trusted credentials can consist of one or more credential pairing (user ID and password) depending on how many namespaces you log into during your session when you create or renew your credentials. The account that the trusted credentials will be applied to is the Primary namespace which is the first namespace you log into for that session.

The credential refresh behaviour is controlled by the Security > Authentication > Automatically renew trusted credential setting in IBM Cognos Configuration. The default time interval for the renewal of trusted credentials is once per day. The administrator can change the value (in days) in the Advance properties, but the minimum is one day. See the core documentation on Trusted Credentials for more information. Keep in mind, if you change your password during the day and have missed the window of opportunity to have your credential automatically renewed, you will need to renew them manually in order to not have any schedules using the credentials fail. For example, you log into Cognos Analytics in the morning. The automatic renewal takes place. In the afternoon, you change your password and log into Cognos Analytics again. Since the automatic renewal already took place in that 24 hour period, it will not occur again and your credentials will not be renewed. In this case you would need to renew manually to ensure any schedules later that day do not fail.

The three different settings for renewing credentials are as follows:

· Primary namespace only (default setting): When you log on to the first namespace of your session, that is considered the Primary namespace for the Cognos Analytics session. The account you logged into is considered the container for the trusted credentials you will create or renew for that session. If you have trusted credentials for that account, the credentials are updated for this account only. All other credentials from other namespaces that you may log into are not updated.

· Off: Credentials are not updated in any namespace.

· All namespaces: When you log on to the first namespace, your credentials are updated as described for “Primary namespace only”. When you log on to additional namespaces, if your trusted credentials associated with the primary namespace account contain logon information for the additional namespaces, then those trusted credentials are updated as well. Using this option is typically done for scenarios where a schedule needs to be run that requires credentials from multiple namespaces. For example an administrator may want to run a scheduled consistency check which spans across multiple namespaces. This setting is a system wide setting and should only be considered if necessary.

NOTE: It is not recommended to use the All namespaces option if users authenticate into secondary namespaces as different users as this may cause conflicts in the credentials that are renewed for the namespace.

It is not possible to use SSO with the feature ‘Automatically renew trusted credential’ unless using IdentityMapping for REMOTE_USER because of the following:

A trusted credential is special because the namespace credentials it stores must be usable at any time, not depending on any timestamp. This rules out SSO tickets like Kerberos tokens or SAP tokens as they will expire after a short time and will become unusable. A suitable trusted credential therefore usually is a pair consisting of a user name and a password. However, for SSO based authentication, there is no password available to the namespace that can be stored into the trusted credential. Therefore, this feature will only work for basic authentication, when the user provides a user name and password to the login screen. The exception to this rule is when IdentityMapping for REMOTE_USER is configured. See the core documentation for more information: https://www.ibm.com/support/knowledgecenter/en/SSEP7J_11.1.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_stp_sso_active_drctry_remote_user.html

[{"Product":{"code":"SSTSF6","label":"IBM Cognos Analytics"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Administration and Configuration v11x","Platform":[{"code":"PF033","label":"Windows"}],"Version":"11.0","Edition":"All Editions","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
01 May 2019

UID

swg21998776