Wiki source code of SSO entre DigDash et IBM Cognos 8
Last modified by Aurelie Bertrand on 2026/01/12 15:14
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{ddtoc/}} | ||
| 2 | |||
| 3 | ---- | ||
| 4 | |||
| 5 | This document describes how to refresh Cognos data sources from DigDash Enterprise in the context of a given user. | ||
| 6 | |||
| 7 | DigDash Enterprise allows the creation of a single DigDash information flow for all users existing in a Cognos namespace. The {{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flow{{/glossaryReference}} displays data specific to each user using the security settings defined in Cognos. | ||
| 8 | |||
| 9 | = Supported versions = | ||
| 10 | |||
| 11 | * Cognos 8 | ||
| 12 | |||
| 13 | = Preparing the Cognos server = | ||
| 14 | |||
| 15 | To enable DigDash Enterprise to obtain information from your Cognos 8 server, the first step is to establish a link between the two servers. | ||
| 16 | |||
| 17 | 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. | ||
| 18 | |||
| 19 | 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). | ||
| 20 | |||
| 21 | Here are the detailed steps. | ||
| 22 | |||
| 23 | == Preparing to set up single sign-on == | ||
| 24 | |||
| 25 | 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: | ||
| 26 | |||
| 27 | 1. Start **IBM Cognos Configuration** | ||
| 28 | 1. Select **Security** | ||
| 29 | 1. Select **Authentication** | ||
| 30 | 1. Select the desired namespace | ||
| 31 | 1. Note the value of the **namespace identifier** field | ||
| 32 | 1. Choose a shared password | ||
| 33 | |||
| 34 | == Create the configuration files == | ||
| 35 | |||
| 36 | 1. Start a DOS console and go to the **<DDE install>/add-ons/cognos** folder | ||
| 37 | 1. Type the command line: **java -jar** **tsap_configurator.jar** | ||
| 38 | 1. **Enter Authorization namespace** is displayed. Press **Enter**. | ||
| 39 | 1. An **Enter Authorization namespace** line appears. Enter the name you wrote down in step 1 | ||
| 40 | 1. **Create global password for DigDash** is displayed. Enter the password you wish to use | ||
| 41 | 1. Enter the same password again. | ||
| 42 | 1. A **Configuration file successfully created** message is displayed. A **ddauth4Cognos.properties** file containing the namespace name and global password has been created. | ||
| 43 | |||
| 44 | == Copy the authentication files to your Cognos server == | ||
| 45 | |||
| 46 | 1. Copy the **digdash_cognos.jar** file to the directory: | ||
| 47 | **<Program Files>/cognos/c8/webapps/p2pd/WEB-INF/lib** | ||
| 48 | 1. Copy the file **ddauth4cognos.properties** into the directory: | ||
| 49 | **<Program Files>/cognos/c8/webapps/p2pd/WEB-INF/classes** | ||
| 50 | 1. Restart Cognos | ||
| 51 | |||
| 52 | == Configure the authentication plug-in in Cognos == | ||
| 53 | |||
| 54 | 1. Start IBM Cognos Configuration | ||
| 55 | 1. Select **Security** | ||
| 56 | 1. Select **Authentication** | ||
| 57 | 1. Add a new namespace (right-click on **Authentication**, then select **New resource and Namespace**) | ||
| 58 | 1. Choose a name for this new namespace | ||
| 59 | 1. From the Type drop-down list, select **Custom Java Provider**. | ||
| 60 | 1. In the **Resource Properties** panel, change the value of the **Java Class Name** field to **com.digdash.cognos.TSAP.DDTrustedSignon** | ||
| 61 | |||
| 62 | = Accessing Cognos reports from DigDash Enterprise = | ||
| 63 | |||
| 64 | To access Cognos reports in DigDash Enterprise, please consult the following document: [[Connecting to a Cognos portal>>doc:Digdash.user_guide.studio.Create_datamodel.Data_connection.Connect_datasource_report.connect_report_cognos_portal.WebHome]]. |