IVisa Interface

The IVisa interface is used to set and maintain the context for the user. After the Visa object is established, it is used for each new authentication provider request from the IBM® Cognos® Analytics server.

The IBM Cognos user can have only one Passport per session. In the Passport, there is a different Visa object for each namespace the user logs on to.

The following methods can be used in the IVisa interface.

generateCredential
Generates credentials for the user.
generateTrustedCredential
Generates trusted credentials for the user.

Use to maintain credential information used by IBM Cognos Analytics for scheduled jobs and reports.

getAccount
Returns account information for the logged user.
getGroups
Returns the groups of which the user is a member.
getRoles
Returns the roles of which the user is a member.
isValid
Verifies whether a Visa is still valid.

If the logon request does not contain sufficient information to validate the user, the generateCredential and generateTrustedCredential methods of the Visa may be returned with one of three types of exceptions:

  • User-recoverable
  • System-recoverable
  • Unrecoverable error