Cognos Analytics

Cognos Analytics

Connect, learn, and share with thousands of IBM Cognos Analytics users! 

 View Only
  • 1.  Configuring Cognos Analytics components to use another certificate authority

    Posted Tue September 12, 2023 06:11 AM

    Hi,

    I will have to configure Cognos Analytics components to use another certificate authority based on the following documentation:

    https://www.ibm.com/docs/en/cognos-analytics/11.2.0?topic=cmica-configuring-cognos-analytics-components-use-another-certificate-authority

    This is a multi-server running Cognos Analytics v11.2.x.

    In this documentation, there are 4 steps:

    1. Delete the existing key store
    2. Create the certificate signing request (CSR) files
    3. Import the certificate authority (CA) certificates
    4. Enable the external certificate authority (CA)

    I believe the 4 steps need to be done on all components. Correct me if I'm wrong.

    Step 1: Delete the existing key store

    It seems quite straightforward. Note the Cognos Analytics v12.0 documentation needs to be updated (as there are changes/reorganization in Cognos Configuration settings).

    Step 2: Create the certificate signing request (CSR) files

    In the step, I can read the following: The distinguished name (DN) value in the command ("CN=EncryptCert,O=MyCompany,C=CA") uniquely identifies the Cognos Analytics installation. The attributes that are used in this parameter reflect a hierarchical structure in your organization.

    Question: Where do I find the real command/value for my customer ("CN=EncryptCert,O=MyCompany,C=CA")? I'm thinking about using ("CN=EncryptCertNAME,O=CustomerCompanyName,C=FR").

    Step 3: Import the certificate authority (CA) certificates

    It seems quite straightforward too. I believe the copy of the root CA certificate (ca.cer) needs to be provided by my customer's Security Team.

    Step 4: Enable the external certificate authority (CA)

    It seems quite straightforward too. It needs to be done on every Cognos servers and Framework Manager instance (my customer is not using Planning Analytics).

    Any comment or advice will be appreciated.

    Best regards,



    ------------------------------
    Patrick Neveu
    Positive Thinking Company
    IBM Champion
    ------------------------------


  • 2.  RE: Configuring Cognos Analytics components to use another certificate authority

    Posted Wed September 13, 2023 02:28 AM
    Edited by Tony Wijaya Wed September 13, 2023 02:32 AM

    Hi Patrick,

    I just recently configured SSL for both application tier and web tier (IIS). I mostly used the below link as my reference:

    https://www.ibm.com/support/pages/how-add-3rd-party-ca-allow-ssl-between-components-ibm-cognos-analytics-11

    In my situation, I was already provided with pfx and cer files (I did not start from CSR) and I also used iKeyman instead of ThirdPartyCertificateTool.

    Here is the summary of how I did the configuration:

    Application Server

    1. Prepare all certificate files. (server.pfx, root.cer, and intermediate.cer)
    2. Follow Steps 1 - 5 from the above technote
    3. Use iKeyman to open CAMKeyStore and delete the existing "encryption" certificate from "Personal Certificates"
    4. In iKeyman, switch to "Signer Certificates". Import both intermediate.cer and root.cer
    5. In iKeyman, switch back to "Personal Certificates". Import server.pfx and change the certificate label to "encryption"
    6. Follow Steps 9 (I did not update "Gateway URI" yet) and 10 from the above technote

    Web Server

    1. Import intermediate.cer and root.cer to CAMKeystore using iKeyman 
    2. Go to IBM Cognos Configuration and update "Dispatcher URIs for gateway" to use HTTPS
    3. Go to IIS - Default Website - ibmcognos - BI, click on URL Rewrite. Edit "Reverse Proxy" rule and update "Rewrite URL" with HTTPS
    4. Restart IIS
    5. Configure IIS to use HTTPS 
    6. Go to IBM Cognos Configuration in Application Server and update "Gateway URI" to use HTTPS

    Hope this will give you some insight on the configuration steps.

    Edit: I forgot to include the link for iKeyman. You can refer to below link if you need help with iKeyman

    https://www.ibm.com/support/pages/how-use-ikeyman-secure-ibm-cognos-analytics-third-party-certificates

    ------------------------------
    Tony Wijaya
    ------------------------------



  • 3.  RE: Configuring Cognos Analytics components to use another certificate authority

    Posted Wed September 13, 2023 03:53 AM

    Hi Tony,

    Thank you for this answer.

    Best regards,



    ------------------------------
    Patrick Neveu
    Positive Thinking Company
    IBM Champion
    ------------------------------



  • 4.  RE: Configuring Cognos Analytics components to use another certificate authority

    Posted Thu September 14, 2023 12:20 PM

    Patrick,

    I've often encountered errors using ThirdPartyCertificateTool and recently found this article which seemed to be a much more reliable method. I did help another customer use this method recently. It does provide the additional comment that these steps need to be performed on every server:

    https://www.ibm.com/support/pages/how-use-ikeyman-secure-ibm-cognos-analytics-third-party-certificates

    In the past, IBM also expected us to perform similar steps even on Framework Manager installations but recently I found this article which shows how to avoid that extra step:

    https://www.ibm.com/support/pages/how-configure-framework-manager-use-3-rd-party-certificates



    ------------------------------
    Robert Hofstetter
    ------------------------------