Skip to main content
OnCommand Insight

Configuring Cognos for Smart Card and certificate login (OnCommand Insight 7.3.10 and later)

Contributors

You must modify the OnCommand Insight Data Warehouse configuration to support Smart Card (CAC) and certificate logins for the Cognos server.

Steps

  1. Add certificate authorities (CAs) to the Cognos trustore.

    1. In a command window, go to ..\SANscreen\cognos\analytics\configuration\certs\

    2. Use the keytool utility to list the trusted CAs: ..\..\ibm-jre\jre\bin\keytool.exe -list -keystore CAMKeystore.jks -storepass NoPassWordSet

      The first word in each line indicates the CA alias.

    3. If no suitable files exist, supply a CA certificate file, usually a .pem file.

    4. To include customer's CAs with OnCommand Insight trusted CAs, go to ..\SANscreen\cognos\analytics\configuration\certs\.

    5. Use the keytool utility to import the .pem file: ..\..\ibm-jre\jre\bin\keytool.exe -importcert -keystore CAMKeystore.jks -alias my_alias -file 'path/to/my.pem' -v -trustcacerts

      my_alias is usually an alias that would easily identify the CA in thekeytool -list operation.

    6. When prompted for a password, enter NoPassWordSet.

    7. Answer yes when prompted to trust the certificate.

  2. To enable CAC mode, do the following:

    1. Configure CAC logout page, using the following steps:

      • Logon to Cognos portal (user must be part of System Administrators group i.e. cognos_admin)

      • (Only for 7.3.10 and 7.3.11) Click Manage -> Configuration -> System -> Security

      • (Only for 7.3.10 and 7.3.11) Enter cacLogout.html against Logout Redirect URL -> Apply

      • Close browser.

    2. Execute ..\SANscreen\bin\cognos_cac\enableCognosCAC.bat

    3. Start IBM Cognos service. Wait for Cognos service to start.

  3. To disable CAC mode, do the following:

    1. Execute ..\SANscreen\bin\cognos_cac\disableCognosCAC.bat

    2. Start IBM Cognos service. Wait for Cognos service to start.

    3. (Only for 7.3.10 and 7.3.11) Unconfigure CAC logout page, using the following steps:

      • Logon to Cognos portal (user must be part of System Administrators group i.e. cognos_admin)

      • Click Manage -> Configuration -> System -> Security

      • Enter cacLogout.html against Logout Redirect URL -> Apply

      • Close browser.