If your environment includes Cognos Series 7 PowerPlay Enterprise Server and you are using the HTTPS interface to access PowerPlay, you must enable Secure Sockets Layer (SSL) support. To enable SSL support for the PowerPlay gateway and the Cognos 8 dispatcher, you must define a password for the Cognos 8 key store and then create and store the Web server Certificate Authority (CA) certificate in the Cognos 8 key store.
Save the Web server CA certificate in the c8_location\bin directory and name it ca.cer.
If you did not define a password for the Cognos 8 key store, do it now in Cognos Configuration:
In the Explorer window, click Cryptography, Cognos.
In the Properties window, under Certificate Authority settings, set the Certificate Authority key store password.
From the File menu, click Save.
From the Actions menu, click Restart.
From the command line, go to the c8_location\bin directory.
Set the JAVA_HOME environment variable to the Java Runtime Environment location used by the application server running Cognos 8.
The following examples assume that the default Tomcat application server is being used:
For Microsoft Windows, type
set JAVA_HOME=c8_location\bin\jre\version
For UNIX Cshell, type
setenv JAVA_HOME c8_location/bin/jre/version
From the same command line, run the certificate tool:
For Microsoft Windows, type
ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ..\configuration\signkeypair\jCAKeystore -p keystore password
For UNIX, type
ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore-p
If required, you can now install the CA certificate on the client.
Retrieve the CA certificate from the issuing authority.
The file has a .cer extension. This is not the same certificate as the one used by the Web server. It is the certificate for the issuing authority itself.
Double-click the .cer file, click Install Certificate, and then click Next.
Click Place all certificates in the following store.
Click Browse, click Trusted Root Certification Authorities, and then click Next.
Click Finish.