• Supported versions
• Preparing the Cognos server
  • Preparing to set up single sign-on
  • Create the configuration files
  • Copy the authentication files to your Cognos server
  • Configure the authentication plug-in in Cognos
• Accessing Cognos reports from DigDash Enterprise

This document describes how to refresh Cognos data sources from DigDash Enterprise in the context of a given user.

DigDash Enterprise allows the creation of a single DigDash information flow for all users existing in a Cognos namespace. The Flow displays data specific to each user using the security settings defined in Cognos.

Supported versions

• Cognos 8

Preparing the Cognos server

To enable DigDash Enterprise to obtain information from your Cognos 8 server, the first step is to establish a link between the two servers.

To do this, a DigDash authentication plug-in must be deployed on your Cognos server. You must also define a global password to enable the link between the two servers.

Authentication from DigDash Enterprise will be done using the name of one of the Cognos users present in a specific namespace, the password to be used being the shared password (and not the user's password).

Here are the detailed steps.

Preparing to set up single sign-on

The authentication plug-in will be sent to a specific namespace, for example your LDAP namespace. Retrieve the identifier of this namespace from the Cognos configuration console:

1. Start IBM Cognos Configuration
2. Select Security
3. Select Authentication
4. Select the desired namespace
5. Note the value of the namespace identifier field
6. Choose a shared password

Create the configuration files

1. Start a DOS console and go to the <DDE install>/add-ons/cognos folder
2. Type the command line: java -jar tsap_configurator.jar
3. Enter Authorization namespace is displayed. Press Enter.
4. An Enter Authorization namespace line appears. Enter the name you wrote down in step 1
5. Create global password for DigDash is displayed. Enter the password you wish to use
6. Enter the same password again.
7. A Configuration file successfully created message is displayed. A ddauth4Cognos.properties file containing the namespace name and global password has been created.

Copy the authentication files to your Cognos server

1. Copy the digdash_cognos.jar file to the directory:
   <Program Files>/cognos/c8/webapps/p2pd/WEB-INF/lib
2. Copy the file ddauth4cognos.properties into the directory:
   <Program Files>/cognos/c8/webapps/p2pd/WEB-INF/classes
3. Restart Cognos

Configure the authentication plug-in in Cognos

1. Start IBM Cognos Configuration
2. Select Security
3. Select Authentication
4. Add a new namespace (right-click on Authentication, then select New resource and Namespace)
5. Choose a name for this new namespace
6. From the Type drop-down list, select Custom Java Provider.
7. In the Resource Properties panel, change the value of the Java Class Name field to com.digdash.cognos.TSAP.DDTrustedSignon

Accessing Cognos reports from DigDash Enterprise

To access Cognos reports in DigDash Enterprise, please consult the following document: Connecting to a Cognos portal.